Pengujian integrasi SDK untuk pemasar

Sekilas: Uji integrasi aplikasi Android atau iOS Anda dengan AppsFlyer. 

Bacaan terkait untuk jaringan iklan: Pengujian integrasi jaringan iklan

Overview

Integrasi yang teruji dengan cermat memastikan pengumpulan data yang akurat dan komprehensif. Dengan menguji integrasi SDK, Anda dapat memastikan bahwa SDK berhasil berkomunikasi dengan server AppsFlyer, dan penginstalan, in-app event, serta penargetan ulang dicatat dan diatribusikan dengan benar. 

Setelah integrasi SDK selesai, setiap pengguna akun dengan akses ke dasbor AppsFlyer dapat melakukan pengujian dasar . Pengembang dapat menggunakan log debug di lingkungan pengembangan.

Artikel ini menjelaskan prosedur pengujian dari dashboard dan menyediakan tautan ke dokumentasi yang harus disediakan pemasar kepada pengembang. 

Metode pengujian

Bagian berikut menjelaskan berbagai pengujian yang harus dilakukan dan metode yang tersedia.

Pengujian dari dashboard

Untuk menguji integrasi SDK dari dashboard, Anda harus terlebih dahulu mendaftarkan perangkat uji (Android atau iOS). Ini memungkinkan Anda untuk menggunakan perangkat yang sama berulang kali dan mencegah penginstalan dicatat sebagai penginstalan ulang.  

Anda harus melakukan hal berikut:

  • Menguji penginstalan organik.
  • Menguji fungsionalitas integrasi dasar (penginstalan non-organik, in-app event, dan penargetan ulang).
    Metode yang tersedia meliputi:
    • Halaman pengujian integrasi SDK: Wizard di dashboard AppsFlyer yang memandu Anda melalui proses untuk menjalankan setiap pengujian.
    • Pengujian menggunakan tautan atribusi: Semua jaringan iklan non-SRN dan sumber media yang dimiliki bergantung pada tautan atribusi AppsFlyer; oleh karena itu, sangat disarankan untuk melakukan pengujian menggunakan tautan atribusi. Anda membuat tautan atribusi, lalu kemudian menjalankan pengujian untuk memverifikasi bahwa SDK mengatribusikan penginstalan non-organik dan in-app event ke sumber media yang tepat. Selain itu, Anda harus menjalankan pengujian untuk memastikan bahwa penargetan ulang (atribusi ulang dan interaksi ulang) dicatat dan diatribusikan ke sumber media yang tepat.

Pertimbangan pengujian iOS 14+

Mulai iOS 14.5, IDFA hanya tersedia jika persetujuan pengguna melalui prompt AppTransparency Tracking (ATT). Jika prompt ATT diterapkan di aplikasi, Anda dapat menjalankan pengujian sebagai pengguna yang memberikan izin atau tidak.  Untuk informasi lebih lanjut, lihat panduan untuk mendaftarkan perangkat uji Anda dengan IDFA atau IDFV.

Pengujian di lingkungan pengembangan

Pengembang dapat melakukan hal berikut:

  • Mengaktifkan dan memeriksa log debug, serta menguji skenario seperti validasi pembelian, data konversi, dan deep linking.

     Catatan

    Jika pengembang Anda mendapatkan pesan 403 di log, ini mungkin karena Anda memiliki paket Zero. Paket ini tidak termasuk data atribusi, hanya data tentang klik dan tayangan. Untuk informasi lebih lanjut tentang paket kami, hubungi tim CEM di hello@appsflyer.com atau kunjungi harga AppsFlyer.

  • Membuat aplikasi debug untuk menguji integrasi SDK. Saat melakukan pengujian, data dicatat dan ditampilkan di dashboard. Setelah data tersimpan, data ini tidak dapat dihapus. Jika Anda tidak ingin data pengujian dicatat sebagai bagian dari aplikasi produksi, Anda dapat meminta pengembang untuk menguji integrasi SDK menggunakan aplikasi debug. Aplikasi debug berbeda dari aplikasi produksi karena memiliki ID Aplikasi AppsFlyer berbeda, dashboard sendiri, dan tidak dipublikasikan di app store.

Tambahkan aplikasi debug ke dashboard

Jika pengembang Anda membuat aplikasi debug, Anda harus menambahkan aplikasi tersebut ke dashboard. Setelah pengembang mulai menjalankan pengujian menggunakan aplikasi, data akan ditampilkan di dashboard aplikasi.

Lakukan salah satu prosedur berikut untuk menambahkan aplikasi debug:

Tambahkan aplikasi debug (Android) Tambahkan aplikasi debug (iOS)

Untuk menambahkan aplikasi debug ke dashboard:

  1. Dapatkan nama paket aplikasi debug dari pengembang Anda, lalu tambahkan aplikasi ke dashboard AppsFlyer Anda.
  2. Atur status aplikasi ke salah satu dari yang berikut:
    • Menunggu persetujuan
    • Tidak dipublikasikan

Kasus uji khusus

Kasus uji khusus meliputi:

  • Android TV: SDK kompatibel dengan smart TV berbasis Android. Pemasar atau pengguna akun mana pun dapat menguji aplikasi TV ini dengan mengikuti prosedur dalam artikel ini.
  • Apple TV (tvOS): SDK kompatibel dengan Apple TV (tvOS). Pemasar atau pengguna akun mana pun dapat menguji aplikasi TV ini dengan mengikuti prosedur dalam artikel ini.
  • Aplikasi tvOS yang tidak dipublikasikan: Mewajibkan pemasar dan pengembang untuk bekerja sama (lihat Menguji integrasi tvOS sebelum mempublikasikan).
  • Amazon Fire TV: Pemasar dapat melakukan pengujian dari dashboard (lihat Menguji toko Android alternatif).
  • PBA web event: Mewajibkan pemasar dan pengembang untuk bekerja sama (lihat Menguji integrasi SDK web PBA).

Menguji fungsionalitas SDK dasar

Bagian berikut menjelaskan prosedur yang harus Anda ikuti untuk menguji integrasi SDK dasar.

Menguji penginstalan organik

Kami menyarankan Anda memulai dengan menguji penginstalan organik.

Untuk menguji penginstalan organik:

  1. Instal aplikasi di perangkat uji terdaftar.
  2. Luncurkan aplikasi.

Dashboard aplikasi menampilkan penginstalan organik yang baru. Tunggu hingga 30 menit hingga penginstalan muncul.

Test_SDK_Organic_install

Uji menggunakan halaman Uji Integrasi SDK

Gunakan halaman Uji Integrasi SDK untuk menguji penginstalan non-organik, in-app event, dan deep linking (penargetan ulang), dan menemukan masalah integrasi apa pun di proyek Anda.

Sebelum Anda mulai:

  1. Siapkan perangkat (Android atau iOS) yang tidak menginstal aplikasi. Jika perlu, uninstal aplikasi dari perangkat.
  2. Daftarkan perangkat sebagai perangkat uji.

Langkah 1: Uji penginstalan non-organik

  1. Di dashboard, pilih aplikasi.
  2. Buka halaman Uji Integrasi SDK Integrasi. 
    Halaman pengujian integrasi SDK akan terbuka. 
  3. Jalankan pengujian Penginstalan Non-Organik.
  4. Pilih perangkat uji yang terdaftar. 
  5. Pilih toko tempat menginstal aplikasi:
    • Untuk Android: 
      • Google play
      • Lainnya (misalnya, Toko aplikasi selain Play Store, Android Studio, APK file) 
    • Untuk iOS:
      • App Store
      • Lainnya (misalnya, XCode, TestFlight)
  6. Pindai kode QR dengan perangkat uji terdaftar dan ikuti petunjuk di perangkat.

    Perhatikan bahwa untuk perangkat Android, pengujian ini menggunakan install referrer method (metode pengarah penginstalan), dan oleh karena itu, tautan atribusi tidak menyertakan GAID.

  7. Jika Anda memilih Lainnya, instal aplikasi dari lingkungan pengembangan Anda.
  8. Tunggu hingga penginstalan non-organik terdaftar di laman SDK Integration Tests (Pengujian Integrasi SDK) mengindikasikan bahwa pengujian berhasil. Ini dapat memerlukan waktu hingga 2 menit.

    NonOrganic_install

    Jika aplikasi tidak mencatat penginstalan non-organik, kemungkinan alasannya adalah:

Untuk kesalahan integrasi, hubungi pengembang Anda.

Langkah 2: Uji in-app event

Sebelum Anda mulai:

  • Pastikan Anda menggunakan perangkat uji yang sama dengan yang digunakan untuk mencatat penginstalan non-organik.
  1. Jalankan pengujian In-app Events .
  2. Pilih perangkat uji yang terdaftar, lalu kemudian klik Berikutnya
  3. Luncurkan aplikasi Anda dan mulai hasilkan in-app events.
  4. Anda akan melihat log event ini saat terdaftar secara real time.

    Test_SDK_Integration_Inapp_events

Langkah 3: Uji deep link (penargetan ulang)

Sebelum Anda mulai:

  • Pastikan Anda menggunakan perangkat uji yang sama dengan yang digunakan untuk mencatat penginstalan non-organik.
  • Luncurkan aplikasi pengujian setidaknya 3 kali.
  • Untuk menguji deep linking (penargetan ulang), OneLink harus ditentukan untuk aplikasi Anda. Untuk informasi lebih lanjut, lihat Panduan Pengaturan OneLink
  • Pastikan bahwa penargetan ulang diaktifkan.
  1. Jalankan pengujian Deep linking.
  2. Pilih perangkat uji yang terdaftar.
  3. Pilih jenis pengujian:
    • OneLink: Pilih OneLink. 
    • Skema URI: Masukkan skema URI (misalnya, greatapps://cars).
  4. Klik Berikutnya.
  5. Pindai kode QR dengan perangkat uji terdaftar Anda dan ikuti petunjuk di perangkat Anda. Setelah pengujian selesai, Pengujian Deep Linking terdaftar sebagai berhasil.

    TestSDK_DeepLinks_en-us.png

Menguji menggunakan tautan atribusi

Bagian berikut menjelaskan prosedur yang harus Anda ikuti untuk menguji penginstalan dengan tautan atribusi. Anda dapat melakukan pengujian ini meskipun aplikasi masih tertunda (artinya, tidak terdaftar di Google Play Store atau Apple App Store).

Menguji atribusi penginstalan

Menguji penginstalan memungkinkan Anda unuk memastikan bahwa SDK AppsFlyer mengatribusikan penginstalan dengan benar ke berbagai sumber media.

Untuk menguji atribusi penginstalan:

  1. Salin tautan berikut (Android atau iOS), dan lakukan perubahan ini:
    1. app_id value: Tambahkan ID aplikasi Anda di AppsFlyer. 
    2. pid parameter: Tentukan nama sumber media tempat penginstalan diatribusikan.
    3. c parameter: Tentukan nama kampanye.
    4. Jika Anda menguji aplikasi yang tersedia melalui app store Android pihak ketiga: tambahkan af_r parameter ke tautan atribusi. 
    5. Ganti GAID, IDFA, atau IDFV dengan pengenal perangkat khusus Anda.
    Android iOS
    https://app.appsflyer.com/<app_id>?pid=Test&c=Test&advertising_id=<GAID>

    Berikut ini adalah contoh tautan atribusi dengan nilai khusus:

    Android iOS

    https://app.appsflyer.com/com.my.app?pid=Test&c=Test&advertising_id=12345f9*-eba*-421*-876*-7654ac67876*
  2. Salin tautan yang diperbarui, kirim tautan ini ke perangkat uji, lalu kemudian klik tautan tersebut.

     Catatan

    Di iOS, gunakan iMessage atau email untuk mengirim tautan ke perangkat. Jangan merekatkan tautan di aplikasi iOS Notes dan mengklik tautan tersebut. Tindakan ini dapat merusak tautan tersebut.

  3. Lakukan salah satu dari berikut ini:
    • Jika aplikasi aktif, lanjutkan untuk menginstalnya.
    • Jika aplikasi tertunda, muncul pesan berikut: "Aplikasi yang Anda cari belum tersedia di market." Ini merupakan hasil yang diperkirakan. Karena aplikasi tidak aktif, tautan atribusi tidak mengarah ke app store mana pun. Namun, tautan atribusi masih valid untuk tujuan atribusi dan Anda harus menginstal aplikasi sebagai berikut:
      • Untuk Android: Dari file APK (atau Android Studio untuk pengembang)
      • Untuk iOS: Dari TestFlight (atau Xcode untuk pengembang)

    Anda akan melihat penginstalan yang diatribusikan ke kampanye pengujian dengan sumber media yang disebut Pengujian. Tunggu hingga 30 menit hingga penginstalan muncul di dashboard aplikasi. Test_Install_Attribution_Link

 Tips

Berikut ini menjelaskan cara alternatif untuk memverifikasi hasil pengujian Anda:

  • Jika Anda memiliki akses ke laporan data lengkap, unduh Installs raw data report (laporan data lengkap penginstalan). Pengunduhan laporan ini membutuhkan waktu beberapa menit.

    Untuk mengunduh laporan ini:

    1. Di dashboard, buka Reports (Laporan)Export Data (Ekspor Data). 
    2. Dari daftar User acquisition (non-organic) (Akuisisi pengguna non-organik), klik Installs (Penginstalan), lalu unduh laporannya. 
  • Jika Anda memiliki akses ke log debug, Anda dapat menggunakan API pengujian integrasi SDK untuk mengambil hasil atribusi untuk penginstalan tertentu.

Uji atribusi in-app event

Menguji in-app event memungkinkan Anda untuk memastikan bahwa pendapatan terkait event ditampilkan dan in-app event diatribusikan ke sumber media yang menghasilkan penginstalan.

Untuk menguji atribusi in-app event:

  1. Luncurkan aplikasi; lalu kemudian buat beberapa in-app event.
  2. Buka dashboard aplikasi, lalu klik Events (Event).

    Anda akan melihat event, pendapatan event (jika pendapatan terkait dengan event tersebut), dan sumber media yang terkait dengan event tersebut. Tunggu hingga 60-70 menit sampai event muncul di dashboard.

    Testing_InAppEvents_Attribution

Tips! Pertimbangkan untuk mengunduh laporan data lengkap in-app event untuk memastikan bahwa event tersebut diatribusikan dengan benar. Pengunduhan laporan ini membutuhkan waktu beberapa menit.

Untuk mengunduh laporan ini:

  1. Di dashboard, buka Reports (Laporan) > Export Data (Ekspor Data).
  2. Di bagian Raw Data Reports (Laporan Data Lengkap), unduh laporan data lengkap in-app event.

Uji OneLink

OneLink memungkinkan Anda untuk mengatur satu tautan atribusi untuk Android dan iOS. OneLink mengenali perangkat user dan mengarahkan pengguna ke app store yang sesuai.

Selain itu, OneLink mengaktifkan deep linking. Deep linking memungkinkan Anda untuk membuka app dalam aktivitas app spesifik sambil menyajikan konten yang disesuaikan.

Untuk informasi lebih lanjut, lihat panduan tentang pengujian URL OneLink.

Menguji penargetan ulang mengggunakan tautan atribusi

Bagian berikut menjelaskan prosedur yang harus Anda ikuti untuk menguji atribusi penargetan ulang.

Tentang pengujian penargetan ulang

Atribusi penargetan ulang muncul ketika pengguna berinteraksi dengan kampanye penargetan ulang dengan mengklik tautan atribusi penargetan ulang. Ini menghasilkan atribusi ulang atau event interaksi ulang. Untuk informasi lebih lanjut, lihat Panduan atribusi penargetan ulang.

Pengujian penargetan ulang meliputi :

  • Untuk atribusi ulang: Uninstal dan instal ulang aplikasi. Kemudian, pastikan di dashboard bahwa penginstalan telah tercatat.
  • Untuk interaksi ulang: Klik tautan atribusi penargetan ulang atau deep link, lalu kemudian memastikan bahwa interaksi ulang diatribusikan ke sumber media yang tepat.

Prasyarat untuk menjalankan pengujian penargetan ulang

Sebelum menjalankan pengujian penargetan ulang, diperlukan pengaturan berikut:

  • Penargetan ulang harus diaktifkan untuk perangkat yang diuji.
  • Buat tautan khusus aplikasi atau dapatkan tautan khusus OneLink. Tautan ini harus menyertakan parameter penargetan ulang.

Untuk mengatur pengujian penargetan ulang:

  1. Mengaktifkan penargetan ulang di pengaturan aplikasi.

    Di dashboard aplikasi, klik App Settings (Pengaturan Aplikasi) dan aktifkan Enable retargeting attribution (Aktifkan atribusi penargetan ulang).

    Set_Reattribution_window

  2. Lakukan salah satu dari hal berikut: 
    • Buat tautan atribusi khusus aplikasi. Pastikan untuk menyertakan parameter penargetan ulang is_retargeting=true, dan ID iklan. Untuk melihat GAID, IDFA, atau IDFV, ikuti petunjuk  Mendaftarkan perangkat uji.  
      Berikut adalah contoh tautan atribusi yang menyertakan parameter khusus Android sebagai pengenal perangkat (GAID). Untuk informasi selengkapnya tentang menambahkan parameter pengenal perangkat lainnya, seperti IDFA atau IDFV, lihat Struktur tautan atribusi dan parameter

      https://app.appsflyer.com/<app_id>?pid=Test&c=Test&is_retargeting=true&advertising_id=<GAID>
    • Dapatkan URL panjang tautan khusus dari templat OneLink. Pastikan untuk mengaktifkan Kampanye penargetan ulang. Gambar berikut menunjukkan contoh URL panjang khusus:

      Testing_LongLink_en-us.png

Anda sekarang dapat melanjutkan untuk menguji atribusi ulang dan interaksi ulang.

Uji atribusi ulang

Sebelum Anda mulai:

  • Ikuti petunjuk untuk mengatur pengujian penargetan ulang.
  • Pastikan perangkat uji Anda tidak terdaftar.

Untuk menguji atribusi ulang:

  1. Uninstal aplikasi dari perangkat. Jika Anda baru saja menginstal aplikasi, tunggu beberapa menit.
  2. Salin tautan atribusi yang Anda buat sebelumnya, baik tautan atribusi khusus aplikasi atau tautan panjang khusus dari templat OneLink, kirim tautan tersebut ke perangkat uji, lalu kemudian klik tautan tersebut.

     Catatan

    Di iOS, gunakan iMessage atau email untuk mengirim tautan ke perangkat. Jangan merekatkan tautan di aplikasi iOS Notes dan mengklik tautan tersebut. Tindakan ini dapat merusak tautan tersebut.

  3. Lakukan salah satu dari berikut ini:
    • Jika aplikasi aktif, lanjutkan untuk menginstalnya.
    • Jika aplikasi tertunda, instal aplikasi sebagai berikut:
      • Untuk Android: Instal dari Android Studio atau file APK.
      • Untuk iOS: Instal dari TestFlight.
  4. Buka dasbor aplikasi, dan di kotak View type (Jenis tampilan), pilih Retargeting (Penargetan ulang) .
  5. Di kotak Attribution type (Jenis atribusi), pilih Re-attributions (Atribusi ulang) .

    Anda akan melihat penginstalan yang diatribusikan ke sumber media dan kampanye. Tunggu hingga 30 menit hingga penginstalan yang ditargetkan muncul di dasbor.

    Testing_SDK_Reattribution

 Tips

Berikut ini menjelaskan cara alternatif untuk memverifikasi hasil pengujian Anda:

  • Jika Anda memiliki akses ke laporan data lengkap, unduh Conversions raw-data report (laporan data lengkap konversi). Pengunduhan laporan ini membutuhkan waktu beberapa menit.

    Untuk mengunduh laporan ini:

    1. Di dashboard, buka Reports (Laporan)Export Data (Ekspor Data). 
    2. Dari daftar Retargeting (Penargetan Ulang), klik Konversi (interaksi ulang & atribusi ulang) (Konversi {interaksi ulang & atribusi ulang}, lalu unduh laporannya. 
  • Jika Anda memiliki akses ke log debug, Anda dapat menggunakan API pengujian integrasi SDK untuk mengambil hasil atribusi untuk penginstalan tertentu.

Uji interaksi ulang

Sebelum Anda mulai:

  • Ikuti petunjuk untuk mengatur pengujian penargetan ulang. 
  • Untuk tujuan pengujian, atur waktu minimum antar konversi menjadi None (Tidak Ada). Ini memungkinkan semua konversi interaksi ulang dicatat dan diatribusikan selama pengujian.

    Testing_Reattribution_window

  • Pastikan aplikasi sudah di-instal di perangkat pengujian dan telah diluncurkan beberapa kali. Jika Anda baru saja menginstal aplikasi, tunggu beberapa menit.

Untuk menguji interaksi ulang (deep linking langsung):

Pastikan aplikasi Anda dikonfigurasi untuk deep linking, lalu kemudian ikuti prosedur ini untuk pengujian.

Untuk menguji interaksi ulang (deep linking tidak langsung):

  1. Salin tautan atribusi yang Anda buat sebelumnya, baik tautan atribusi khusus aplikasi atau tautan panjang khusus dari templat OneLink.
  2. Kirim tautan tersebut ke perangkat uji Anda, lalu kemudian klik tautan tersebut.
  3. Untuk membuka aplikasi, lakukan salah satu hal berikut:
    • Di app store, klik Buka.
    • Luncurkan aplikasi dari perangkat Anda.

    Di dasbor, Anda akan melihat interaksi ulang yang diatribusikan ke sumber media dan kampanye. Tunggu hingga 30 menit hingga interaksi ulang muncul.

    Testing_SDK_Re-engagement

Tips! Pertimbangkan untuk mengunduh laporan data lengkap konversi untuk memastikan bahwa interaksi ulang diatribusikan ke sumber media yang tepat. Pengunduhan laporan ini membutuhkan waktu beberapa menit.

Untuk mengunduh laporan ini:

  1. Di dashboard, buka Reports (Laporan) > Export Data (Ekspor Data).
  2. Di bagian Retargeting (Penargetan Ulang) , unduh laporan Konversi (interaksi ulang & atribusi ulang).
Apakah artikel ini membantu?