Integrasikan pengukuran uninstall Android ke dalam aplikasi

Sekilas: Siapkan pengukuran uninstal di aplikasi Android dengan mengintegrasikan Firebase Cloud Messaging ke dalam aplikasi.

Bacaan terkait: Prinsip pengukuran uninstall

Pengukuran Uninstall Android

Pengukuran uninstal Android tersedia dengan mengonfigurasi pengukuran uninstal di AppsFlyer dan mengadopsi Firebase Cloud Messaging (FCM) ke dalam aplikasi Anda. Mulai April 2021, AppsFlyer mendukung API lama FCM dan API HTTP V1. FCM mendorong adopsi versi V1

Uninstall daftar periksa implementasi pengukuran 
Langkah Tindakan Tanggung jawab
1 Hubungkan FCM ke AppsFlyer

Pilih API integrasi:

Pemasar/pengembang
2

Integrasikan FCM ke dalam aplikasi

Integrasi berbeda jika Anda menggunakan FCM hanya dengan AppsFlyer atau Anda menggunakannya dengan banyak platform.

  1. Adopsi FCM ke dalam aplikasi.
  2. Lakukan salah satu dari berikut ini:
  3. [Opsional] Jika Anda menggunakan Proguard, selesaikan Mengaktifkan Proguard.
Pengembang
3 Uji pengukuran uninstall Pengembang

Hubungkan FCM API ke AppsFlyer

Pilih versi API FCM [Praktik terbaik] HTTP V1 atau HTTP lama. 

HTTP V1

Untuk mengonfigurasi FCM API V1 untuk uninstall: 

  1. Untuk mendapatkan ID Proyek :
    1. Buka konsol FCM.
    2. Pilih sebuah proyek. 
    3. Buka Ikhtisar Proyek > Pengaturan Aplikasi.

      UninstallFirebase.png

    4. Salin ID Proyek. Anda akan membutuhkannya di tahap proses selanjutnya. 
  2. Untuk menetapkan fungsi uninstall ke AppsFlyer:
    1. Buka tab Service accounts (Akun layanan)
    2. Klik Kelola izin akun layanan
      Tab browser baru terbuka di Google Cloud Platform.
    3. Di menu samping, pilih Roles (Fungsi)
    4. Klik + Buat fungsi.
    5. Selesaikan sebagai berikut:
      • Judul: Masuk ke uninstallAppsFlyer.
      • ID: Masukkan af_uninstalls
      • Tahap peluncuran fungsi: Pilih Ketersediaan umum
    6. Cari, lalu pilih cloudmessaging.messages.create.

      AddPermissions.png

    7. Klik Add (Tambahkan).
    8. Klik Buat
  3. Untuk menetapkan fungsi uninstall FCM ke AppsFlyer:
    1. Di menu samping, pilih IAM .
    2. Klik + Tambahkan.
    3. Di kolom New members (Anggota baru)  masukkan af-uninstalls-tracking@af-uninstalls-tracking.iam.gserviceaccount.com
    4. Pilih salah satu fungsi, pilih uninstall AppsFlyer .
    5. Klik Simpan
      Akun layanan AppsFlyer telah diberi peran uninstal AppsFlyer. 
  4. Untuk mengaktifkan pengukuran uninstall di AppsFlyer :
    1. Di AppsFlyer, buka Configuration (Konfigurasi) > App Settings (Pengaturan Aplikasi).
    2. Jika perlu, aktifkan pengukuran Uninstall
    3. Pilih HTTP V1.

      UninstallHTTPV1.png

    4. Masukkan ID Proyek yang Anda siapkan sebelumnya di bagian ini.
    5. Klik Uji koneksi.
      Berhasil! pesan ditampilkan. 
    6. Klik Simpan pengaturan

HTTP legasi

Pengukuran uninstall menggunakan Firebase Messaging didukung oleh Android SDK V4.7.0 +

  1. Untuk mendapatkan kode server Firebase:
    1. Buat proyek Aplikasi Android Firebase (jika Anda belum melakukannya), atau migrasikan proyek Anda dari Konsol Pengembang Google (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).

      firebase_cloud_messaging_server_key.png

    4. Di tab Cloud Messaging, Anda melihat dua Kode Server.
    5. Copy kode server.
  2. Untuk mengaktifkan pengukuran uninstall di AppsFlyer :
    1. Di AppsFlyer, buka Configuration (Konfigurasi) > App Settings (Pengaturan Aplikasi).
    2. Jika perlu, aktifkan pengukuran Uninstall
    3. Pilih HTTP Lama (Legacy HTTP) .
      UninstallLegacy.png
    4. Masukkan Kode Server Firebase/GCM Anda siapkan di langkah sebelumnya.
    5. Klik Simpan pengaturan

Integrasikan FCM ke dalam aplikasi

Gunakan prosedur berikut (sesuai kebutuhan) untuk mengintegrasikan FCM ke dalam aplikasi dan menguji integrasinya.

Adopsi FCM ke dalam aplikasi.

  • 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.
Untuk mengadopsi FCM di aplikasi Anda :
  1. Download google-services.json dari konsol firebase.
  2. Tambahkan google-services.json ke direktori modul aplikasi,
  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
    

Gunakan FCM hanya dengan AppsFlyer SDK .

Jika satu-satunya tujuan pengintegrasian FCM adalah untuk mengukur uninstall di AppsFlyer, gunakan layanan appsFlyer.FirebaseMessagingServiceListener , yang disematkan dalam SDK. Ini memperluas kelas FirebaseFirebaseMessagingService, yang digunakan untuk menerima Token Perangkat FCM.

Untuk menambahkan layanan appsFlyer.FirebaseMessagingServiceListener ke aplikasi :

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

Gunakan FCM dengan banyak platform.

Jika Anda ingin menggunakan FCM dengan lebih dari satu platform, SDK, atau keduanya, Anda harus menerapkan logika yang mengumpulkan Token Perangkat dan meneruskannya ke semua platform yang relevan. Hal ini dilakukan dengan memperluas instance baru dari FirebaseMessagingService (mirip dengan layanan yang diperluas oleh SDK AppsFlyer SDK) :
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
    }
}
Layanan ini harus ditambahkan ke AndroidManifest.xml agar dapat berfungsi: Jika aplikasi menggunakan FCM sebelum mengintegrasikan AppsFlyer SDK, kemungkinan layanan diperluas dan pengembang perlu menambahkan yang berikut ini ke metode onNewToken() :
AppsFlyerLib.getInstance().updateServerUninstallToken(getApplicationContext(), refreshedToken); 

Verifikasi bahwa telah menambahkan layanan yang relevan ke AndroidManifest.xml.

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

Menggunakan ProGuard dengan pengukuran uninstall

Jika Anda menggunakan Proguard, tambahkan aturan berikut:

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

Uji pengukuran uninstall Android

  • Prosedur pengujian yang dijelaskan berlaku untuk aplikasi yang tersedia melalui Google Play Store, tertunda, unduhan langsung, dan melalui toko aplikasi alternatif. 
  • MetrikUninstall tersedia di dashboard Ikhtisar. 
  • Daftar pengguna yang meng-uninstal aplikasi tersedia di laporan data lengkap uninstall.

Untuk menguji pengukuran hapus instalasi Android:

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

Event uninstall aplikasi membutuhkan waktu hingga 48 jam agar dapat ditampilkan dalam laporan data lengkapdan di Laporan Kinerja Gabungan di dashboard AppsFlyer Anda.

aggregated_performance_report_uninstalls_en-us.png.

Informasi lainnya

Menyelesaikan masalah notifikasi langsung pencopotan pemasangan tidak dinonaktifkan

Metode onMessageReceived Overriding FCM dan mengimplementasikan logika Anda sendiri di dalamnya dapat menyebabkan notifikasi push uninstall menjadi tidak senyap. Hal ini dapat mempengaruhi pengalaman pengguna. Untuk mencegahnya, pastikan pesan tersebut berisi af-uinstall-tracking. Lihat contoh berikut:

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