Integrasi uji
Sebelum Anda memulai:
Agar berhasil menyelesaikan pengujian dalam dokumen ini, Anda harus:
Menguji integrasi SDK Android
Pengujian ini terdiri dari:
- Menyimulasikan klik iklan dan konversi.
- Memeriksa data konversi dari penginstalan.
Simulate a conversion
Menyimulasikan pengguna yang mengklik iklan dan menginstal aplikasi.
Langkah 1: Simulasikan klik iklan
Menyimulasikan klik iklan melalui tautan atribusi. Menyusun tautan atribusi sebagai berikut:
https://app.appsflyer.com/<app_id>?pid=<media_source>
&advertising_id=<registered_device_gaid>
Dimana:
app_id
adalah ID aplikasi AppsFlyer Anda.pid
adalah sumber media yang harus dikaitkan dengan penginstalan.advertising_id
adalah GAID perangkat yang terdaftar.
The advertising_id
diperlukan parameter untuk atribusi melalui pencocokan ID. Jika diabaikan, atribusi akan memunculkan kemungkinan.
Misalnya, jika ID aplikasi Anda adalah com.my.app
, tautan atribusi mungkin terlihat seperti ini:
https://app.appsflyer.com/com.my.app?pid=devtest&c=test1
atau, dengan GAID:
https://app.appsflyer.com/com.my.app?pid=devtest&c=test1&advertising_id=********-****-****-****-************
Tips
Seringkali, pengujian yang menggunakan tautan atribusi dilakukan lebih dari sekali. Itulah sebabnya disarankan untuk menggunakan salah satu parameter atribusi untuk "memberi versi" pengujian Anda–menjadikannya lebih mudah dipahami tautan mana yang memicu konversi.
Pada contoh di atas, nilai
c
istest1
. Di pengujian berturut-turut, meningkatkan nilai daric
totest2
,test3
, dan seterusnya.
Langkah 2: Instal aplikasi
Aktifkan mode debug dan instal aplikasi pada perangkat uji yang terdaftar .
Langkah 3: Jalankan tes
Lanjutkan untuk memeriksa data konversi .
Inspect conversion data
Setelah menyimulasikan konversi, ikuti langkah berikut untuk memeriksa data konversi penginstalan.
Langkah 1: Ambil UID instal
Setelah aplikasi diinstal, cari log debug untuk conversions.appsflyer
Langkah 2: Memeriksa data konversi
Buka API uji data konversidan isi bidang yang diwajibkan:
app-id
: ID aplikasi Andadevice_id
: rekat nilai dariuid
dari langkah 1.af_request_epoch_ms
- Tanda waktu zaman ini. Anda dapat mendapatkannya di sini- The
af_sig
dibuat dengan menggabungkan nilai dari bidang berikut ini:
Gabungkan nilai dariaf_request_epoch_ms
dengandevice_id
andapp_id
, memisahkan karakter yang tidak terlihat\u2063
.
(Yaitu 1661969117203 1591184059153-1591377216180180185 com.zzkko)
HMAC dibuat menggunakan SHA256 dan menggunakan Kode Pengembang sebagai kode rahasia tanda tangan.
Untuk mendapatkan kembali Kode Pengembang, di dashboard AppsFlyer, buka Konfigurasi >Pengaturan Aplikasi.
Anda dapat menemukan di sini kalkulator HMAC untuk membantu menghitung token ini.
Lalu, klik Try it (Cobalah)! Untuk menjalankan pengujian.
Hasil yang diharapkan
Respons 200 yang berisi data konversi penginstalan (disingkat agar mudah dibaca):
{
...
"campaign": "test1",
...
"media_source": "devtest",
...
"af_status": "Non-organic"
...
}
Catatan
Mungkin perlu waktu hingga 30 menit hingga penginstalan muncul di dashboard.
Memecahkan masalah integrasi SDK Android
Install Selalu Teratribusi ke Organic
Skenario
Anda sedang menguji atribusi menggunakan link atribusi. Anda telah mengimplementasi SDK conversion listener tapi log selalu menampilkan install sebagai organic. Selain itu, tidak ada non-organic installs yang tercatat di dashboard.
Kemungkinan Penyebab
- Dev key salah - Jika Anda menetapkan dev key yang salah, install tidak dapat diatribusikan.
- Tautan atribusi yang Anda gunakan salah. Lihat panduan kami tentang tautan atribusi .
- Pastikan perangkat yang Anda uji itu terdaftar.
- Channel yang tidak tepat didefinisikan di dalam manifest
Install tidak Terdeteksi atau Teratribusi
Skenario
Anda sedang menguji atribusi install tapi log tidak menampilkan data apa pun tentang install seperti jenis, peluncuran pertama, dll.
Kemungkinan Penyebab
- Pastikan bahwa
start
andinit
metode yang dipanggil diApplication
class. - Pastikan perangkat yang Anda uji itu terdaftar.
Saya Mendapat Respons 404 pada Rekaman Install atau Event
Skenario
Anda sedang menguji in-app event untuk melihat bahwa in-app event diatribusikan ke media source yang tepat. Namun, log menampilkan respons 404 untuk install dan saat Anda mengirim in-app event, install atau in-app event tidak muncul di dashboard.
Kemungkinan Penyebab
Respons 404 menunjukkan bahwa ID aplikasi salah. Pastikan bahwa ID aplikasi di applicationId
parameter di build.gradle
sama dengan app ID yang ada di dasbor Anda.
Pendapatan tidak direkam dengan Benar
Skenario
Anda sedang menguji in-app event dengan pendapatan. Event muncul di dashboard tapi pendapatan tidak dicatat
Kemungkinan Penyebab
Parameter pendapatan tidak dalam format yang benar. JANGAN memformat nilai pendapatan dengan cara apa pun. Nilai tidak boleh mengandung pemisah koma, simbol mata uang, atau teks. Misalnya, event pendapatan harus serupa dengan 1234.56.
Log Menampilkan "AppsFlyer's SDK cannot send any event without providing DevKey" Saat Menguji In-app Event
Skenario
Anda mencoba melihat in-app event di log. Saat Anda memicu event, log hanya menampilkan "AppsFlyer's SDK cannot send any event without providing DevKey".
Kemungkinan Penyebab
Anda memanggil start
metode tanpa memberikan kode pengembang sebagai parameter. Berikan kode pengembang ke metode tersebut.
Log Menampilkan "Not sending data yet, waiting for dev key" Saat Menguji In-app Event
Skenario
Anda sedang mencoba pengujian in-app event di log. Saat Anda memicu event, log hanya menampilkan "Not sending data yet, waiting for dev key".
Kemungkinan Penyebab
Anda memanggil init
dan Anda memberikan kode pengembang string kosong. Berikan kode pengembang ke metode tersebut.
Saya mendapat respons 400 saat Menguji In-App Event
Skenario
Anda mencoba pengujian in-app event. Saat Anda memicu event, Anda melihat error 400 di log.
Kemungkinan Penyebab
Hal ini menandakan masalah dengan dev key. Pastikan dev key yang dipakai sudah benar. Pastikan juga dev key hanya berisi karakter alfanumerik.
Log Menampilkan "WARNING: Google Play Services is missing"
Skenario
Logcat menampilkan pesan peringatan "WARNING: Google Play Services is missing".
Kemungkinan Penyebab
App tidak memiliki dependensi Google Play Services. Hal ini mungkin mencegah SDK mengumpulkan GAID sehingga dapat menimbulkan masalah dengan atribusi.
Tambahkan dependensi berikut ke level aplikasi build.gradle
file:
implementation 'com.google.android.gms:play-services-base:15.0.1'
implementation 'com.google.android.gms:play-services-ads:15.0.1'
Saya mendapat respons 400 pada Rekaman Install atau Event
Skenario
Anda mencoba untuk menguji instalasi dan event konversi lainnya di log. Saat Anda memicu event-event ini, Anda melihat response 403 (dilarang) di log.
Kemungkinan Penyebab
This might be because you have the Zero package, which does not include attribution data; only data on clicks and impressions. To start receiving attribution data, learn more about the different AppsFlyer packages, and update as needed. You can also contact our customer engagement team at [email protected] if you have questions about our packages.
Membuat aplikasi debug Android
OPSIONAL
Anda dapat menggunakan varian build Android untuk mengonfigurasi aplikasi debug yang mudah digunakan untuk tujuan pengujian.
Semua pengujian dapat dilakukan untuk aplikasi produksi dan debug.
Langkah 1: Konfigurasikan debug
tipe build Gradle
Di file level aplikasi Anda build.gradle
konfigurasikan debug
tipe build dan setel applicationIdSuffix
ke nama aplikasi pengujian (dalam hal ini, .debug
).
android {
// ...
buildTypes {
// Prevents a signing error when building the production app
release {
signingConfig signingConfigs.debug
}
debug {
applicationIdSuffix ".debug"
}
}
}
Langkah 2: Tambahkan aplikasi baru ke AppsFlyer
Gunakan nama paket yang dihasilkan sebagai ID aplikasi saat menambahkan aplikasi ke dashboard AppsFlyer, atau minta anggota tim yang memiliki akses ke dashboard untuk menambahkannya.
Misalnya, jika Anda memiliki aplikasi dengan nama paket com.your.app
dan Anda menggunakan konfigurasi Gradle di atas, nama aplikasi pengujiannya adalah com.your.app.debug
Teruskan nama ini sebagai ID aplikasi saat menambahkan aplikasi ke AppsFlyer.
Diperbarui 4 bulan yang lalu