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.devkey
- Application's devkey. Learn here how to get it.
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 always attributed to 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 not detected or attributed
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.
I'm getting a 404 on install or event recording
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.
Revenue is not recorded properly
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.
The log shows "AppsFlyer's SDK cannot send any event without providing devkey" when I test in-app events
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.
The log shows "not sending data yet, waiting for dev key" in the log when I test in-app events
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.
I get response 400 when I test in-app events
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.
The log shows "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'
I get response 403 on install or event recording
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 sekitar 1 bulan yang lalu