Integrasikan pengukuran uninstall iOS ke aplikasi

Sekilas: Atur pengukuran uninstall di aplikasi iOS dengan mengintegrasikan Layanan Notifikasi Push Apple/Apple Push Notification Service (APN) ke aplikasi.

Pengukuran Uninstall iOS

Pengukuran uninstall iOS tersedia dengan mengadopsi APN di aplikasi.

Pertimbangan:

  • Laporan APN secara waktu aktual ketika pengguna menghapus aplikasi hanya tersedia jika setidaknya delapan hari telah berlalu sejak penginstalan. Hal ini berarti data uninstall iOS hanya tersedia setelah hari ke 8.
  • Pengukuran tidak dapat dilakukan bagi pengguna yang menolak izin Notifikasi Push.

Persyaratan aplikasi iOS:

  • iOS 13+
  • SDK AppsFlyer 4.10.4+
  • Sertifikat p12. dan tidak dapat menggunakan sertifikat p8. 

Prosedur integrasi

Selesaikan bagian berikut untuk pengaturan, integrasikan, dan uji pengukuran uninstall iOS.

Dapatkan ID di Apple dan atur pengukuran uninstall di AppsFlyer

  1. Untuk mendapatkan id aplikasi Anda:
    1. Di Apple Developer Members Center (Pusat Anggota Pengembang Apple), klik Identifiers (Pengenal) di bawah Aplikasi iOS dan temukan aplikasi Anda. 

      iOS_Apps_1.png

    2.  Jika Anda belum mendaftarkan ID Aplikasi, klik + dan lengkapi formulir.
    3. Pilih Notifikasi Push.

      iOS_U_T_2.png

    4.  4. Saat Anda memperluas aplikasi, ada dua pengaturan untuk notifikasi push dengan ikon status berwarna kuning atau hijau:
    5. Klik Settings (Pengaturan).
       Catatan Tombol Settings (Pengaturan) mungkin bernama Edit jika notifikasi push telah dikonfigurasi sebelumnya. Jika tidak menemukan tombol Settings/Edit, Anda mungkin bukan team agent atau admin. Orang yang awalnya membuat akun developer adalah team agent Anda dan mereka yang melakukan langkah-langkah yang tersisa di bagian ini.
  2. Untuk membuat sertifikat Anda:

    1. 1. Pilih Apple Push Notification service SSL (Sandbox & Production) di pilihan Production certificate (Sertifikat Produksi). Jika Anda menggunakan VoIP untuk notifikasi push, pilih VoIP Services Certificate.

    2. 2. Klik Create Certificate (Buat Sertifikat) dari pilihan Produksi SS SSL Certificate (Sertifikat SSL). 

    3. 3. Setelah mengklik Create Certificate (Buat Sertifikat), perhatikan Add iOS Certificate Assistant (Tambah Asisten Sertifikat iOS). Ikuti instruksi pada assistant kemudian klik Continue (Lanjutkan).

    4. 4. Dengan Permintaan Certificate Signing yang baru saja dibuat, buatlah sertifikat APNS Push SSL.

    5. 5. Jika tombol Download (Unduh) muncul, artinya Anda siap untuk mengunduh. Anda mungkin perlu memuat ulang halaman untuk memperbaruinya. Unduh sertifikat yang baru dibuat:

    6. Buka sertifikat. Membuka sertifikat juga akan membuka Keychain Access. Sertifikat Anda di Keychain Access ditampilkan di bagian My Certificates. Jika sertifikat tidak muncul, periksa bagian Certificatesuntuk melihat apakah sertifikatnya ada di sana.

      Catatan

      Hanya akun admin yang dapat mengupload atau mengganti sertifikat p12.

      iOS_U_T_7.png

  3. Untuk memperbarui sertifikat
    Jika Anda memperbarui Development atau Production Push SSL Certificate, ikuti langkah-langkah yang disebutkan sebelumnya. Tidak perlu membatalkan sertifikat sebelumnya untuk melakukan perubahan ini. Dua sertifikat produksi dapat digunakan pada saat bersamaan, memungkinkan Anda untuk tetap menggunakan sertifikat lama sambil mengunggah sertifikat yang baru. Catatan! jangan gunakan sertifikat pengembangan di lingkungan produksi. 
  4. Untuk mengekspor File P12:
    Langkah terakhir sebelum kembali ke dashboard AppsFlyer adalah menyimpan sertifikat pendaftaran (signing certificate) sebagai file .p12.
    1. Pilih sertifikat yang baru saja ditambahkan ke Keychain Access

    2. Buka File > Export Items (Ekspor Item).

    3. 3. Pilih My Certificates (Sertifikat Saya) di bagian menu Category (Kategori) di sisi kiri bawah.

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

      iOS_U_T_7.png

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

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

      Apple_Push_Services__1_.png

  5. Untuk mengonfigurasi pengukuran uninstall di AppsFlyer

    1. Di AppsFlyer, buka Configuration (Konfigurasi) > App Settings (Pengaturan Aplikasi) (Pengaturan Aplikasi).

    2. Gulir ke bawah ke bagian Uninstall.

    3. Aktifkan pengukuran uninstall.

      Uninstall_iOS_p2.png

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

    5. (opsional) Jika sertifikat P12 dilindungi kata sandi, isi akta sandi di P12 certificate Password (Kata Sandi sertifikat P12)

    6. Klik Validate (Validasi) untuk mengirim sertifikat ke AppsFlyer agar dapat divalidasi.

    7. Klik Save Settings (Simpan Pengaturan).

Integrasikan dengan SDK

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

Tambahkan kode berikut ke AppDelegate.m:
SwiftObjective-C

	//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()
    }
    // dukungan iOS 9 and iOS 8
    else if #available(iOS 8, *), #available(iOS 9, *) {
      UIApplication.shared.registerUserNotificationSettings(UIUserNotificationSettings(types: [.badge, .sound, .alert], categories: nil))
      UIApplication.shared.registerForRemoteNotifications()
    }

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

 // Dipanggil saat aplikasi berhasil mendaftarkan push notification
  func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
    AppsFlyerLib.shared().registerUninstall(deviceToken)
  }

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 (Kapabilitas)
  4. Aktifkan Background Modes (Mode Latar Belakang)
  5. Centang Remote notifications (Notifikasi jarak jauh)

    remote_notifications_xcode.png

Pemberitahuan push

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

capabilities_ios_uninstall.png

Menguji uninstall iOS

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:

SwiftObjective-C
AppsFlyerLib.shared().setUseUninstallSandbox = true

Catatan! Penghapusan instalasi tidak langsung muncul di dashboard AppsFlyer:

  • Dibutuhkan rata-rata 9 hari agar uninstall dapat muncul di laporan
  • Diperlukan waktu lebih dari sebulan  agar uninstall yang berasal dari lingkungan sandbox muncul di laporan

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

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

 Contoh

  • Hari ke-1: pengguna menginstal aplikasi Anda
  • Hari ke-4: pengguna meng-uninstall aplikasi Anda
  • Hari ke-12: Layanan Notifikasi Push Apple melaporkan penghapusan aplikasi 8 hari setelah uninstall
  • Hari ke-13 - Data uninstall muncul di dashboard AppsFlyer dan data lengkap

Uninstall_measurement_a.png

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

Apakah artikel ini membantu?