Pengukuran Uninstall

Pengukuran Uninstall Android

Copot pemasangan pengukuran menggunakan Firebase Messaging didukung pada Android SDK versi 4.7.0.

1. Mendapatkan Kode Server Firebase

1. Buat proyek Aplikasi Android Firebase (jika Anda belum membuatnya), atau migrasikan proyek Anda dari Konsol Google Developer (ikuti petunjuk di sana). Untuk informasi lebih lanjut, buka Firebase. 
2. Buka Firebase Console.
3. Di halaman Console Firebase, arahkan ke Project Settings (klik pada ikon roda gigi di dekat Project Overview di panel kiri halaman tersebut).
4. Pada tab Cloud Messaging, Anda dapat melihat kedua Kode Server Anda (lihat tangkapan layar berikut:
   
   
5. Copy kode server.

2. Memasukkan Server Key di Dashboard AppsFlyer

1. Masuk ke dashboard aplikasi Anda di platform AppsFlyer.
2. Pilih App Settings dari menu sebelah kiri.

   

3. Tetapkan Firebase Server Key dengan Kode Server yang baru saja Anda copy.

3. Mengonfigurasi Firebase-Messaging di App

1. Download google-services.json dari konsol firebase.
2. Tambahkan google-services.json ke direktori modul aplikasi Anda,
3. Tambahkan aturan ke file build.gradle untuk menyertakan plugin google-services:

   buildscript { 
       // ... 
       dependencies { 
         // ... 
         classpath 'com.google.gms:google-services:4.2.0' // google-services plugin 
       } 
     }
   

4. Tambahkan dependensi FCM ke file build.gradle:

   dependencies {
      implementation 'com.google.firebase:firebase-messaging:17.3.4'
   }
   
   // ADD THIS AT THE BOTTOM 
   apply plugin: 'com.google.gms.google-services
   

Versi Firebase terbaru dapat diperoleh di sini: dokumen resmi Firebase.

Jika Anda melihat error "Could not find..", pastikan Anda memiliki Google Repository terbaru di Android SDK Manager.

4. Menerapkan Layanan Pengukuran Uninstall AppsFlyer

<application
   <!-- ... -->
      <service
        android:name="com.appsflyer.FirebaseMessagingServiceListener">
        <intent-filter>
          <action android:name="com.google.firebase.MESSAGING_EVENT"/>
        </intent-filter>
      </service>
   <!-- ... -->
</application>

import com.appsflyer.AppsFlyerLib;
import com.google.firebase.messaging.FirebaseMessagingService;

public class MyNewFirebaseManager extends FirebaseMessagingService {

    @Override
    public void onNewToken(String s) {
        super.onNewToken(s);

        // Sending new token to AppsFlyer
       	       AppsFlyerLib.getInstance().updateServerUninstallToken(getApplicationContext(), s);

        // the rest of the code that makes use of the token goes in this method as well
    }
}

AppsFlyerLib.getInstance().updateServerUninstallToken(getApplicationContext(), refreshedToken); 

<service
    android:name=".MyNewFirebaseManager">
    <intent-filter>
        <action android:name="com.google.firebase.MESSAGING_EVENT" />
    </intent-filter>
</service>

@Override
    public void onMessageReceived(RemoteMessage remoteMessage) {
        
        if(remoteMessage.getData().containsKey("af-uinstall-tracking")){
            return;
        } else {
           // handleNotification(remoteMessage);
        }
    }

5. Menggunakan ProGuard dengan Pengukuran Uninstall

Jika Anda menggunakan ProGuard, tambahkan aturan berikut:

-dontwarn com.appsflyer.**
-keep public class com.google.firebase.messaging.FirebaseMessagingService {
  public *;
}

6. Menguji Pengukuran Uninstall Android

MetrikHapus Instalasi tersedia di dashboard Ikhtisar. 

Daftar pengguna yang menghapus instalasi aplikasi tersedia dalam hapus instalasi   laporan data lengkap.

Untuk menguji pengukuran hapus instalasi Android:

1. Instal aplikasi 
2. Uninstall aplikasi.  Catatan ! Anda dapat menghapus aplikasi segera setelah menginstalnya.
   Event uninstall terdaftar dalam 24 jam karena pengukuran uninstall diproses setiap hari .
   Jika aplikasi dipasang ulang selama waktu ini - tidak ada event uninstall yang dicatat.

Event uninstall aplikasi membutuhkan waktu hingga 48 jam untuk muncul dilaporan data lengkap dan diLaporan Kinerja Agregatpada dashboard AppsFlyer Anda.

Apakah aplikasi Android aktif di Google Play, menunggu pengiriman, atau bahkan selain play store - tesnya sama.

7. Nonaktifkan pengukuran uninstall

Jika Kunci Server Firebase/GCM disediakan, pengukuran uninstall aplikasi diaktifkan secara default. Pemilik aplikasi dapat menonaktifkan fitur ini melalui dashboard.

Perhatikan! Agar uninstall (penghapusan penginstalan) dapat dilaporkan: Enable uninstalls measurement (Aktifkan pengukuran uninstall) harus aktif pada saat aplikasi diinstal. Penginstalan yang terjadi ketika Enable uninstalls measurement (Aktifkan pengukuran uninstall) tidak aktif, tidak dilaporkan. 

Untuk menonaktifkan pengukuran uninstall :

1. Di AppsFlyer, buka Pengaturan Aplikasi.
2. Gulir ke Attribusi > Uninstall dan matikan Aktifkan pengukuran uninstall.
   

   

Pengukuran Uninstall iOS

Pengukuran uninstal iOS diimplementasikan menggunakan layanan HTTP/2 Apple Push Notification (APN).

1. Menemukan App

2. Jika Anda belum mendaftarkan App ID, klik simbol +, lalu lengkapi formulir.

3. Centang kotak Push Notifications.

4. Saat Anda memilih aplikasi, akan ada dua pengaturan untuk push notifications dengan ikon status kuning atau hijau:

5. Klik Settings untuk melanjutkan.

2. Membuat Sertifikat

3. Memperbarui Sertifikat

Jika Anda memperbarui Sertifikat SSL Push Development atau Production, ikuti langkah-langkah yang diuraikan di atas sama seperti saat Anda pertama kali mengupload sertifikat. Untuk membuat perubahan ini, Anda tidak perlu mencabut sertifikat sebelumnya. Mungkin akan ada dua sertifikat production secara bersamaan, tujuannya agar Anda dapat terus menggunakan sertifikat lama saat mengupload sertifikat baru.

4. Ekspor File P12

Langkah terakhir sebelum kembali ke dashboard AppsFlyer adalah menyimpan sertifikat signing sebagai file .p12

1. Pilih sertifikat yang baru saja ditambahkan ke Keychain Access

2. Buka File > Item Ekspor.

3. Pilih My Certificates di bagian menu Category di sisi kiri bawah.

Jika My Certificates tidak ditandai, artinya Anda tidak dapat mengekspor sertifikat sebagai file .p12

3. Gunakan format Personal Information Exchange (.p12) saat menyimpan file.

4. Pastikan sertifikat menampilkan Apple Push Services dan terlihat seperti berikut:

5. Buka dashboard app Anda di platform AppsFlyer.

6. Pilih App Settings di menu sebelah kiri.

7. Klik pada ikon unggah, pilih file P12 untuk diunggah. 

8. (opsional) Jika sertifikat P12  dilindungi kata sandi, masukkan kata sandi dalam P12 Kata Sandi sertifikat . 

9. Klik Validate untuk mengirim sertifikat ke AppsFlyer agar dapat divalidasi.

10. Klik Save Settings.

5. Mengintegrasikan dengan SDK

Push notification harus didaftarkan di kode app agar dapat mengaktifkan pengumpulan data uninstall.

	//add UserNotifications.framework
	import UserNotifications
	func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    //...
    // iOS 10 support
    if #available(iOS 10, *) {
      UNUserNotificationCenter.current().requestAuthorization(options:[.badge, .alert, .sound]){ (granted, error) in }
      application.registerForRemoteNotifications()
    }
    // iOS 9 and iOS 8 support
    else if #available(iOS 8, *), #available(iOS 9, *) {
      UIApplication.shared.registerUserNotificationSettings(UIUserNotificationSettings(types: [.badge, .sound, .alert], categories: nil))
      UIApplication.shared.registerForRemoteNotifications()
    }

    // iOS 7 support
    else {
      application.registerForRemoteNotifications(matching: [.badge, .sound, .alert])
    }
    
    return true
  }

 // Called when the application sucessfuly registers for push notifications
  func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
    AppsFlyerTracker.shared().registerUninstall(deviceToken)
  }

- #import <UserNotifications/UserNotifications.h>
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // The userNotificationTypes below is just an example and may be changed depending on the app
 UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
          center.delegate = self;
          [center requestAuthorizationWithOptions:(UNAuthorizationOptionSound | UNAuthorizationOptionAlert | UNAuthorizationOptionBadge) completionHandler:^(BOOL granted, NSError * _Nullable error) {
          }];
   [[UIApplication sharedApplication] registerForRemoteNotifications];
    // if you do not use push notificaiton in your app, uncomment the following line
    //application.applicationIconBadgeNumber = 0;
  }
  - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
    [[AppsFlyerTracker sharedTracker] registerUninstall:deviceToken];
  }
  }

#import <AppsFlyerLib/AppsFlyerTracker.h>
@interface AppDelegate : UIResponder <UIApplicationDelegate, AppsFlyerTrackerDelegate>

Cuplikan kode di atas meminta izin akses dari pengguna untuk mengirimkan push notification. Namun, jika Anda hanya menggunakan push notification dalam mode latar belakang untuk melakukan uninstall, tidak perlu meminta persetujuan pengguna. Hal ini disebabkan karena push notification ini merupakan push notification senyap yang tidak mewajibkan Anda untuk meminta izin akses dari pengguna.

Izin pengguna untuk push notification dalam mode latar belakang 

Jika Anda hanya menggunakan push notifikasi senyap, pastikan untuk mengaktifkan Remote Notifications di Background Modespada bagian Capabilities app Anda:

1. Pada XCode, pilih proyek Anda
2. Pilih target Anda
3. Pindah ke tab Capabilities
4. Aktifkan Background Modes
5. Centang Remote notifications
   
   

6. Push Notification

Pastikan Anda menambahkan Push Notification di tab capabilities XCode. Tanpa Push Notification, deviceToken tidak akan dikumpulkan.

7. Menguji Uninstall

Untuk menguji pengukuran iOS:

1. Instal aplikasi 
2. Hapus instalasi aplikasi.  Catatan! Anda dapat menghapus instalasi aplikasi segera setelah menginstalnya. 

Saat menguji hapus instalasi dari Xcode atau TestFlight, adalah penting untuk memberi tahu SDK kami bahwa token dihasilkan dari lingkungan Sandbox. Gunakan API berikut:

AppsFlyerTracker.shared().useUninstallSandbox = true

[AppsFlyerTracker sharedTracker].useUninstallSandbox = true;

Catatan! Penghapusan instalasi tidak langsung muncul di dashboard AppsFlyer:

• Dibutuhkan rata-rata 9 hariuntuk menghapus instalasi sepenuhnya muncul dalam laporan
• Diperlukan waktu lebih dari sebulan  agar menghapus instalasi yang berasal dari lingkungan sandbox muncul di laporan

Selain itu, tanggal uninstall adalah tanggal uninstall dilaporkan . Lihat bagian selanjutnya untuk mempelajari lebih lanjut.

8. Melihat Data Uninstall di Dashboard AppsFlyer

Pengukuran uninstall ditampilkan di dashboard utama pada Aggregated Performance table.

Karena perubahan terbaru di layanan Pemberitahuan Pesan Apple, waktu yang diperlukan agar uninstall muncul di dashboard adalah minimal 9 hari. AppsFlyer memperbarui dan mengagregasi metrik untuk uninstall setiap 24 jam

Untuk detail selengkapnya, lihat Panduan Integrasi SDK bagian iOS Measure App Uninstalls.

9. Nonaktifkan pengukuran uninstall

Jika sertifikat P12 disediakan dan divalidasi, pengukuran uninstall aplikasi diaktifkan secara default. Pemilik aplikasi dapat menonaktifkan fitur ini melalui dashboard.

Perhatikan! Agar uninstall (penghapusan penginstalan) dapat dilaporkan: Enable uninstalls measurement (Aktifkan pengukuran uninstall) harus aktif pada saat aplikasi diinstal. Penginstalan yang terjadi ketika Enable uninstalls measurement (Aktifkan pengukuran uninstall) tidak aktif, tidak dilaporkan. 

Untuk menonaktifkan pengukuran uninstall :

1. Di AppsFlyer, buka Pengaturan Aplikasi.
2. Gulir ke Attribusi > Uninstall dan matikan Aktifkan pengukuran uninstall.
   

   

Postback Event Uninstall

AppsFlyer memungkinkan Anda untuk mengirim postback event uninstall untuk setiap pengguna yang melakukan uninstall, ke mitra yang bekerja sama dengan Anda. Event uninstall itu disebut sebagai af_uninstall di dashboard AppsFlyer.

Memetakan Event Uninstall

Anda dapat memetakan event af_uninstall seperti halnya memetakan in-app event lainnya pada app Anda.

Seperti pada in-app event lain, AppsFlyer dapat mengirim postback hanya jika event benar-benar terjadi dan dicatat oleh AppsFlyer. Oleh karena itu, pemetaan af_uninstall hanya bekerja pada implementasi uninstall yang telah selesai. Jika Anda tidak melihat uninstall pada laman garis besar, atau pada laporan data lengkap uninstall, maka tidak akan ada postback uninstall yang dikirimkan ke partner, sekalipun Anda telah memetakan event af_uninstall.

Waktu af_uninstall

Tidak seperti postback untuk in-app event biasa, event af_uninstall tidak dikirim secara waktu aktual.

Pada data lengkap AppsFlyer dan partner postback, waktu event yang dicatat af_uninstall  adalah saat AppsFlyer mengetahui tentang uninstall.

• Untuk perangkat Android: 24-48 jam setelah uninstall aplikasi yang sebenarnya
• Untuk perangkat iOS: 9-11 hari setelah uninstall aplikasi yang sebenarnya

Batasan

Event af_uninstall tidak termasuk dalam laporan postback In-app event.

Event af_uninstall saat ini baru tersedia untuk beberapa partner.

Jika Anda ingin memetakan dengan partner, namun Anda melihat bahwa event tidak tersedia untuk partner, hubungi CSM khusus Anda atau kirim email ke hello@appsflyer.com.

Jika Anda adalah seorang partner dan ingin menerima event af_uninstall, hubungi PDM khusus Anda atau hubungi partners@appsflyer.com.