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 is test1. Di pengujian berturut-turut, meningkatkan nilai dari c to test2, 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 Anda
device_id: rekat nilai dari uid 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 and init metode yang dipanggil di Application 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.debugTeruskan nama ini sebagai ID aplikasi saat menambahkan aplikasi ke AppsFlyer.