Integrasi uji

Sarankan Pengeditan

Sebelum Anda memulai:

Agar berhasil menyelesaikan pengujian dalam dokumen ini, Anda harus:

Menguji integrasi SDK Android

Pengujian ini terdiri dari:

  1. Menyimulasikan klik iklan dan konversi.
  2. 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:

  1. app-id: ID aplikasi Anda
  2. device_id: rekat nilai dari uid dari langkah 1.
  3. af_request_epoch_ms - Tanda waktu zaman ini. Anda dapat mendapatkannya di sini
  4. The af_sig dibuat dengan menggabungkan nilai dari bidang berikut ini:
    Gabungkan nilai dari af_request_epoch_ms dengan device_id and app_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

  1. Dev key salah - Jika Anda menetapkan dev key yang salah, install tidak dapat diatribusikan.
  2. Tautan atribusi yang Anda gunakan salah. Lihat panduan kami tentang tautan atribusi .
  3. Pastikan perangkat yang Anda uji itu terdaftar.
  4. 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

  1. Pastikan bahwa start and init metode yang dipanggil di Application class.
  2. 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.debugTeruskan nama ini sebagai ID aplikasi saat menambahkan aplikasi ke AppsFlyer.

Diperbarui 4 bulan yang lalu