Pengukuran Uninstall

Pengukuran Uninstall Android

Pengukuran uninstall menggunakan Firebase Messaging didukung dari SDK Android 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

Menguji implementasi pengukuran uninstall android sangatlah mudah.

App android ada di Google Play, menunggu review, atau bahkan tidak ada di store, pengujian yang dilakukan tetap sama - cukup uninstall app dari device.

Tunggu hingga 24 jam agar event uninstall app ditampilkan di tabel aggregate performance report dashboard dan uninstall raw data report.

Pengukuran Uninstall iOS

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)
  }

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // The userNotificationTypes below is just an example and may be changed depending on the app
    UIUserNotificationType userNotificationTypes = (UIUserNotificationTypeAlert |
                          UIUserNotificationTypeBadge |
                          UIUserNotificationTypeSound);
    UIUserNotificationSettings *settings = [UIUserNotificationSettings settingsForTypes:userNotificationTypes
                                       categories:nil];
    [application registerUserNotificationSettings:settings];
    [application 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];
  }

Izin Akses User untuk Push notifikasi 

Cuplikan kode di atas membutuhkan izin akses dari user untuk mengirimkan push notifikasi. Namun, jika Anda menggunakan push notifikasi untuk mengukur uninstall, persetujuan user tidak diperlukan. Ini disebabkan karena push notifikasi ini merupakan push notifikasi senyap yang tidak mengharuskan Anda untuk meminta izin akses dari pengguna.

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

When testing uninstalls from Xcode or TestFlight it's important to let our SDK know that the token is generated from a Sandbox environment. Use the following APIs:

AppsFlyerTracker.shared().useUninstallSandbox = true

[AppsFlyerTracker sharedTracker].useUninstallSandbox = true;

Anda tidak perlu menunggu antara install dan uninstall Anda dapat meng-install app dan langsung meng-uninstallnya.

Namun, uninstall aktual akan muncul di dashboard Anda kira-kira setelah 9 hari dari waktu install. Selain itu, tanggal uninstall adalah 9 hari setelah tanggal uninstall aktual. Lihat bagian di bawah 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.

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

Postback Event Uninstall

AppsFlyer memungkinkan Anda untuk mengirim postback event uninstall untuk setiap user yang melakukan uninstall, ke partner yang bekerja sama dengan Anda. Event uninstall disebut sebagai af_uninstall pada 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

Postback untuk in-app event reguler dikirim dalam waktu sebenarnya, sementara event af_uninstall tidak.

Waktu event af_uninstall yang tercatat pada data lengkap AppsFlyer dan postback partner adalah waktu ketika AppsFlyer mengetahui terjadinya uninstall. Hal ini terjadi dalam 24 jam dari uninstall app 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.