Pengujian integrasi SDK untuk pemasar

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.

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.

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.

Khusus iOS: Halaman pengujian integrasi SDK hanya berlaku untuk aplikasi iOS yang menerapkan ATT. Anda dapat menguji aplikasi non-ATT menggunakan prosedur yang ditentukan di sini.

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.

   

   Jika aplikasi tidak mencatat penginstalan non-organik, kemungkinan alasannya adalah:
   • IDFA tersedia tetapi perangkat uji tidak terdaftar dengan pengenal ini di halaman Perangkat uji.
   • Anda memiliki lebih dari 1 aplikasi, selain aplikasi uji, yang diinstal pada perangkat uji tetapi perangkat uji tidakterdaftar dengan IDFV pada halaman Perangkat uji. 
   • Penginstalan organik yang tercatat.
   • Pengujian dilakukan pada versi aplikasi yang tidak menyertakan SDK.

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.

   

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.

   

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>

   idfa

   https://app.appsflyer.com/<app_id>?pid=Test&c=Test&idfa=<IDFA>

   IDFV

   https://app.appsflyer.com/<app_id>?pid=Test&c=Test&idfv=<IDFV>

   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*

   
   https://app.appsflyer.com/id123456789?pid=Test&c=Test&idfa=1A2B****-9128-4***-123*-04E***654321

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.

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.

   

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.

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.

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.

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

   

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:

     

Anda sekarang dapat melanjutkan untuk menguji atribusi ulang dan interaksi 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.

   

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.

  

• 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.

   

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