Pengukuran Uninstall

Pengukuran Uninstall Android

Agar dapat mulai mengukur uninstall untuk Android mobile app, Anda HARUS memiliki GCM atau Firebase Project's Server Key (seperti yang dijelaskan di bawah).

1. Memperoleh Firebase/GCM Server Key

1. Buat proyek Aplikasi Android Firebase (jika Anda belum membuatnya), atau migrasikan proyek Anda dari Google Developer Console (ikuti instruksi yang dijelaskan di sana). Untuk informasi lebih lanjut, kunjungi link ini:

2. Buka Firebase Console:

3. Pada halaman Firebase Console, buka Project Settings (klik icon roda gigi di sebelah Overview pada panel di sebelah kiri halaman).

4. Pada tab Cloud Messaging, Anda dapat melihat Sender ID (ATAU Project NUmber, yang merupakan hal penting jika Anda menggunakan GCM) dan dua Server Key (lihat screenshot di bawah):

• Server Key - digunakan dengan Firebase-Messaging
• Kunci Server Legacy - digunakan dengan GCM
  

5. Copy Server Key.

• Anda juga dapat menggunakan Google Developer Console versi lama yang tidak lagi digunakan untuk memperoleh nilai-nilai ini
  
  https://console.developers.google.com/apis/credentials

2. Memasukkan Server Key di Dashboard AppsFlyer

1. Buka dashboard app Anda di platform AppsFlyer.

2. Pilih App Settings dari menu di sebelah kiri.

3. Atur Firebase Server Key dengan Server Key yang baru saja Anda copy (ini adalah kolom gabungan Server Key untuk GCM & Firebase-Messaging).

3. Mengonfigurasi Firebase-Messaging di App

Setelah membuat proyek di Firebase Console, Anda juga harus mendownload file JSON proyek Anda: google-services.json, dan menyimpannya di direktori modul aplikasi Anda.

• Jika tidak memiliki file ini, Anda dapat mendownloadnya dari Project Settings di Firebase Console.

Kemudian, Anda harus menambahkan dependensi Firebase-Messaging ke proyek anda:

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

dependencies {
   implementation 'com.google.firebase:firebase-messaging:17.3.4'
}

// ADD THIS AT THE BOTTOM 
apply plugin: 'com.google.gms.google-services

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

dependencies {
   implementation "com.google.android.gms:play-services-gcm:16.0.0"
}

// ADD THIS AT THE BOTTOM 
apply plugin: 'com.google.gms.google-services'

<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="your.app.name.permission.C2D_MESSAGE" />
<uses-permission android:name="com.google.android.c2dm.permission.RECEIVE" />

4. Mengatur Sender ID

Di Application Class / metode onCreate milik MainActivity, sertakan SenderID proyek Anda ke SDK AppsFlyer (ATAU - Project number), seperti contoh berikut:

@Override
protected void onCreate(Bundle savedInstanceState) {

/* ... */

  String senderId = "Your-Sender-ID"; /* A.K.A Project Number */
  AppsFlyerLib.getInstance().enableUninstallTracking(senderId); /* ADD THIS LINE HERE */

/* ... */

  AppsFlyerLib.getInstance().startTracking(getApplication(), "YOUR_DEV_KEY");

/* ... */
}

5. Mengimplementasikan Layanan Pengukuran Uninstall AppsFlyer

<application
   <!-- ... -->
      <service
        android:name="com.appsflyer.FirebaseInstanceIdListener">
        <intent-filter>
          <action
   android:name="com.google.firebase.INSTANCE_ID_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>

<application>
   <!-- ... -->
      <service
      android:name="com.appsflyer.GcmInstanceIdListener"
      android:exported="false">
      <intent-filter>
       <action android:name="com.google.android.gms.iid.InstanceID" />
      </intent-filter>
     </service>
   <!-- ... -->
</application>

public class RegistrationIntentService extends IntentService {
  /* ... */

  @Override
  public void onHandleIntent(Intent intent) {
    /* ... */
    InstanceID instanceID = InstanceID.getInstance(this);
    String token = instanceID.getToken(getString(R.string.gcm_defaultSenderId),
                      GoogleCloudMessaging.INSTANCE_ID_SCOPE, null);
    /* ... */
sendTokenToMyBackend(token); // example for general use case / 3rd party SDK
   AppsFlyerLib.getInstance().updateServerUninstallToken(getApplicationContext(), token); // pass the token to the AppsFlyer SDK
  }

  /* ... */
}

<service android:name="[.MyInstanceIDService]" android:exported="false">
   <intent-filter>
       <action android:name="com.google.android.gms.iid.InstanceID"/>
   </intent-filter>
</service>

6. Menggunakan ProGuard dalam Pengukuran Uninstall

Saat menggunakan ProGuard, Anda perlu menambahkan aturan berikut sesuai dengan pilihan Messaging Service yang digunakan (Firebase or GCM).

-dontwarn com.appsflyer.**
-keep public class com.google.firebase.iid.FirebaseInstanceId {
  public *;
}

-dontwarn com.appsflyer.**
-keep public class com.google.android.gms.iid.InstanceID {
  public *;
}

7. Menguji Pengukuran Uninstall Pada 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. Mengekspor 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 >> Export Items.

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 Select File untuk memilih file .p12

8. Masukkan kata sandi file .p12 (bukan 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];
  }

6. Push Notification

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

7. Menguji Uninstall

Pastikan Anda ingat bahwa untuk menguji local build, Anda harus menggunakan TestFlight dan mensimulasikan pengujian di device uji Anda. Pengujian tidak dapat langsung dilakukan dari xcode.

8. Melihat Data Uninstall di Dashboard AppsFlyer

Pengukuran uninstall ditampilkan di dashboard utama pada Aggregated Performance table.

Metrik untuk uninstall diperbarui dan digabungkan setiap 24 jam.

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

The af_uninstall event is not currently available for all partners.

If you wish to map it with a partner, but see the event is not available for the partner, contact your dedicated CSM or write to hello@appsflyer.com.

If you are a partner and wish to receive af_uninstall events, contact your dedicated PDM or reach out to partners@appsflyer.com.