Sekilas: Uji integrasi aplikasi Android/iOS Anda dengan AppsFlyer.
Pengujian dan Debugging Integrasi SDK
Menguji integrasi SDK sebelum mengirimkan aplikasi ke App Store. Dalam artikel ini, SDK merujuk pada AppsFlyer iOS dan Android SDK.
Kasus khusus pengujian dan debugging
- Smart TV: SDK ini kompatibel dengan Smart TV berbasis Android dan Apple TV (tvOS). Uji aplikasi smart TV menggunakan instruksi dalam panduan ini.
- Aplikasi tvOS yang tidak dipublikasikan: lihat Menguji integrasi tvOS sebelum menerbitkan.
- Amazon Fire TV: lihat Menguji Android store alternatif .
Kenapa saya harus melakukan Debug dan Pengujian?
Integrasi yang teruji dengan cermat memastikan pengumpulan data yang akurat dan komprehensif. Dengan menguji integrasi SDK, Anda memastikan bahwa penginstalan dan in-app event dicatat dan dikaitkan dengan benar.
Pengujian dan Debugging Integrasi SDK
Gunakan salah satu metode berikut untuk menguji dan melakukan debug integrasi SDK
-
Pengujian dasar:
- Menguji integrasi menggunakan tautan atribusi
- Model atribusi AppsFlyer menggunakan tautan atribusi. Direkomendasikan untuk melakukan pengujian menggunakan tautan atribusi.
- Saat Anda menguji integrasi SDK menggunakan tautan atribusi, Anda mendapatkan wawasan mendalam tentang model atribusi AppsFlyer. Ini memberi Anda kesempatan untuk mengoptimalkan operasi dan analisis pemasaran Anda.
-
Pengujian lanjutan:
- Debugging langsung dari lingkungan pengembangan.
- Bagian pengujian integrasi S DK hanya menguji serangkaian fitur terbatas. Uji berikut ini di lingkungan pengembangan menggunakan log debug:
- Validasi pembelian
- Data konversi
- Kesalahan dalam pengaturan SDK. Anda dapat menguji fitur-fitur yang tidak tercakup dalam lingkungan pengembangan dengan bantuan log debug.
Bacaan terkait untuk jaringan iklan: Pengujian integrasi jaringan iklan.
Menggunakan halaman Pengujian Integrasi SDK, untuk menemukan masalah integrasi dalam proyek Anda. Gunakan untuk menguji penginstalan, in-app event, dan deep linking.
Menguji integrasi SDK
Untuk menguji integrasi SDK:
- Siapkan perangkat (iOS atau Android) yang tidak memiliki aplikasi terinstal. Jika perlu uninstall (hapus) aplikasi dari perangkat.
- Daftarkan perangkat sebagai perangkat uji. Harap Perhatikan! iOS: Jika Anda menggunakan TestFlight untuk menginstal aplikasi, tidak perlu mendaftarkan perangkat.
- Pada AppsFlyer, pilih app.
-
Buka Integrasi > Uji Integrasi SDK.
Halaman pengujian integrasi SDK terbuka. - Pilih opsi pengujian:
- Install Non-Organik
- In-App Event
- Penautan Langsung
- Gunakan prosedur pengujian berikut sesuai jenis pengujian yang dipilih.
Menguji instalasi organik
- Instal aplikasi di perangkat uji yang terdaftar.
- Luncurkan aplikasi.
- Dashboard aplikasi menampilkan instalasi organik yang baru.
Menguji pemasangan non-organik
- Pilih Instalasi Non-Organik.
- Pilih perangkat yang terdaftar.
- Pilih sumber aplikasi:
- Android:
- Google play
- Lainnya (di-luar-Google play store)
- iOS:
- App Store
- XCode
- TestFlight
- Android:
- Pindai kode QR dengan perangkat uji terdaftar dan ikuti petunjuk di perangkat.
- Tunggu hingga pemasangan non-organik terdaftar di laman Uji Integrasi SDK mengindikasikan pengujian berhasil. Ini bisa memerlukan waktu hingga 2 menit.
Jika aplikasi tidak merekam penginstalan non-organik pada saat itu, lihat bagian pemecahan masalah yang muncul di halaman Pengujian Integrasi SDK .
Untuk menguji penginstalan LAT:
- Aktifkan mode LAT di perangkat Anda.
- Lakukan uji instalasi non-organik.
Untuk menguji penginstalan tanpa persetujuan ATT (tanpa IDFA):
- Dalam dialog persetujuan ATT, klik Minta Aplikasi untuk Tidak Melacak.
- Lakukan uji instalasi non-organik.
Pengujian In-App Event
- Klik Jalankan tesdi bawahIn-app events .
- Pilih perangkat uji terdaftar dari menu drop-down, klik Next .
- Luncurkan aplikasi Anda dan mulai hasilkan in-app events.
- Anda akan melihat log event ini saat terdaftar secara real time.
Menguji deep links
- OneLink harus ditentukan untuk aplikasi Anda untuk menguji Deep Linking. Lihat panduan OneLink kami di sini. Penting untuk dicatat bahwa implementasi SDK Deep Linking sangat dianjurkan, seperti yang dijabarkan dalam panduan integrasi deep linking .
- Verifikasi toggle penargetan ulang diaktifkan.
- Klik pada Jalankan pengujiandi bawah Deeplinking
- Pilih perangkat uji terdaftar dari menu drop-down dan klik Next.
- Pilih Jenis Pengujian:
- OneLink - Pilih OneLink yang ingin Anda uji dari dropdown Pilih sebuah OneLink.
- Skema URI - tentukan skema URI yang ingin Anda uji. Misalnya greatapps: //cars.
- Pindai kode QR dengan perangkat uji terdaftar Anda dan ikuti petunjuk di perangkat Anda.
- Setelah dua uji ini selesai, Uji Deep Linking terdaftar sebagai berhasil.
Pengujian Integrasi SDK Menggunakan App Debug
Saat melakukan pengujian menggunakan tautan atribusi, data ditambahkan pada dashboard aplikasi. Ketika data tersimpan, data ini tidak bisa dihapus. Jika Anda tidak ingin menguji data yang disimpan sebagai bagian dari aplikasi asli, Anda dapat menguji integrasi SDK menggunakan aplikasi debug.
Jika Anda tidak membutuhkan aplikasi pengujian, atau jika Anda tidak khawatir tentang tercampurnya data pengujian dan data asli, lewati bagian ini.
Aplikasi debug adalah salinan tepat aplikasi yang diterbitkan di app stores. Dengan melakukan pengujian integrasi SDK pada aplikasi debug, Anda memastikan bahwa data asli tidak tercampur dengan data pengujian.
Aplikasi debug berbeda dari aplikasi produksi karena mereka:
- Memiliki ID aplikasi yang berbeda
- Memilki dashboard mereka sendiri
- Tidak diterbitkan pada app stores
Membuat Test App Android
Menduplikasi App Android Anda
- Buat salinan folder proyek Android dan ganti namanya
- Buka proyek yang baru saja di-copy di Android studio
- Di Android Studio, buka folder sampai Anda melihat package
- Klik kanan di nama paket, pilih Refactor lalu Rename
- Ganti nama package
- Pada build.grade level app, ganti
applicationId
sesuai dengan nama paket yang baru
Tambahkan aplikasi uji Android pada Appsflyer
Ikuti instruksi untuk menambahkan app baru di dashboard AppsFlyer. Pastikan nama paket sama dengan nama paket app uji yang baru saja dibuat, bukan nama paket app asli. Pastikan juga untuk mengatur status app ke Pending approval atau unpublished.
Sekarang Anda dapat menjalankan pengujian pada app uji yang baru.
Membuat App Uji iOS
Menduplikasi App iOS Anda
- Buka folder proyek di finder
- Duplikasi folder proyek tersebut
- Buka proyek hasil duplikasi di XCode
- Pada class
AppDelegate
, di dalam metodedidFinishLaunchingWithOptions
, tentukan ID app baru:Objective C
Swift
Catatan
ID aplikasi adalah ID yang diberikan kepada aplikasi setelah dipublikasikan ke app store. Namun, karena ini adalah aplikasi pengujian, Anda dapat memberikan ID apa pun selama ID tersebut belum dipakai oleh aplikasi lain. Formatnya harus berupa 11111**** . Misalnya, 111117538.
Pastikan ID adalah 9 digit . Mulai id dengan 1 lima kali. Digit yang tersisa harus acak. Lihat contoh ID di atas.
Menambahkan App Uji iOS Ke Dashboard AppsFlyer
Ikuti instruksi untuk menambahkan app baru di dashboard AppsFlyer. Pastikan ID app sama dengan ID app milik app uji yang baru saja dibuat. Pastikan juga untuk mengatur status app ke Pending approval atau unpublished.
Sekarang Anda dapat menjalankan pengujian pada app uji yang baru.
Pengujian Menggunakan Link Atribusi
bagian ini menunjukkan cara menguji integrasi dengan bantuan link atribusi.
Sebelum Anda mulai:
- Perangkat terdaftar yang Anda gunakan untuk pengujian
- Saat menguji atribusi ulang, pastikan untuk menghapus perangkat terdaftar dari daftar perangkat yang diizinkan.
Anda dapat menguji integrasi SDK meskipun jika aplikasi masih tertunda (artinya, tidak terdaftar di Google Play atau Apple Store)
Topik yang dibahas di bagian ini:
- Pengujian Atribusi Install
- Pengujian In-App Event
- Pengujian Retargeting (re-attribution dan re-engagement)
Pengujian Atribusi Install
Pengujian install memungkinkan Anda untuk menentukan bahwa SDK AppsFlyer dapat mengatribusi install dengan benar ke berbagai media source.
Langkah 1:
Copy link di bawah:
https://app.appsflyer.com/<app_id>?pid=Test&c=Test&advertising_id=<GAID>
https://app.appsflyer.com/<app_id>?pid=Test&c=Test&idfa=<IDFA>
Ubah parameter app_id menjadi id aplikasi Anda (termasuk awalan id
. Misalnya: id0123456789
).
- Parameter c akan menentukan nama kampanye.
- Parameter pid akan menentukan nama media source yang teratribusi dengan install.
Jika menguji klik dari komputer, tambahkan GAID untuk Android (Google Advertising ID) atau IDFA untuk iOS.
Langkah 2:
Copy link, kirim ke device uji, dan buka link menggunakan browser.
Catatan
Di iOS, gunakan iMessage atau email untuk mengirim tautan ke perangkat. Jangan rekatkan tautan di aplikasi Notes iOS dan mengklik tautan itu karena dapat memutus tautan.
- Jika app sudah live, lanjutkan ke proses install.
- Jika app masih pending, install app dari development environment:
-- Untuk Android - install dari Android Studio atau ADB shell
-- Untuk iOS - install dari XCode
Langkah 3:
Tunggu hingga dua menit agar install muncul di dashboard app. Anda akan melihat install yang diatribusikan ke media source Test di bagian kampanye Test.
Untuk verifikasi yang lebih terperinci, unduh laporan data lengkap instalasi:
- Di AppFlyer, masuk ke Laporan > Ekspor Data.
- Di bagian Laporan Data Lengkap unduh Instalasi laporan data lengkap.
Lihat artikel kami tentang installation raw data report untuk informasi selengkapnya.
Pengujian In-App Event
Anda dapat menguji in-app event untuk melihat bahwa event menunjukkan pendapatan yang terkait dengan event tersebut, dan bahwa event teratribusi ke media source yang menghasilkan install.
Setelah menginstal app menggunakan link atribusi, picu beberapa in-app event. Tunggu hingga dua menit agar event-event tersebut muncul di dashboard. Buka dashboard app dan klik Events di menu sebelah kiri.
Anda akan melihat event, pendapatan event (jika pendapatan dikaitkan dengan event). dan media source yang terkait dengan event tersebut.
Untuk verifikasi yang lebih terperinci, Anda dapat mendownload raw data laporan in-app event.
Di dashboard app, klik Export Data di bagian Reports. Di bagian Raw Data Reports download raw data laporan In-App Event.
Lihat artikel kami tentang raw data laporan in-app event untuk informasi selengkapnya.
Pengujian OneLink
OneLink™ memungkinkan Anda untuk mengatur satu link atribusi untuk iOS dan Android. OneLink mengenali perangkat user dan mengalihkan user 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.
Pengujian Retargeting
Prasyarat untuk Pengujian Retargeting
- Template OneLink - lihat konfigurasi template OneLink
- Mengaktifkan retargeting di pengaturan app
Di dashboard app, klik App Settings dan geser tombol Enable Re-Targeting Campaign Measurement ke on.
- Perangkat yang tidak terdaftar
Menguji retargeting sangatlah mudah. Buat custom attribution link dari template OneLink. Pastikan untuk menggeser tombol Re-Targeting Campaign ke on.
Setelah link atribusi kustom siap, layar berikut akan muncul dan Anda akan memperoleh URL versi lengkap:
Cara lain untuk memperoleh versi URL lengkap adalah melalui halaman Link Management.
- Di halaman Manajemen Tautan, cari tautan atribusi.
- Di sisi sebelah kanan, klik tiga titik di bawah Actions
- Klik Lihat Rincian Tautan
- Salin Tautan Panjang.
Penting!
- Saat menguji penargetan ulang (atribusi ulang dan interaksi ulang), ID iklan harus ditentukan dalam URL tautan atribusi.
- Penargetan ulang instalasi ulang (atau disebut dengan atribusi ulang) tidak dapat diuji menggunakan perangkat uji terdaftar. Artinya, perangkat pengguna yang tercantum dalam daftar perangkat uji. Anda dapat menggunakan perangkat lain untuk tujuan ini.
- Untuk melihat GAID atau IDFA, ikuti petunjuk di artikel mendaftarkan perangkat uji . Harap Perhatikan!
Berikut ini adalah url final OneLink:
https://go.onelink.me/2rAD?pid=Test&c=Test&is_retargeting=true&advertising_id=<GAID>
https://go.onelink.me/2rAD?pid=Test&c=Test&is_retargeting=true&idfa=<IDFA>
Pengujian Re-Attribution
Anda dapat menguji atribusi ulang untuk verifikasi bahwa Anda dapat merekam install app Anda berdasarkan user yang meng-install ulang app setelah di-uninstall sebelumnya.
- Pastikan perangkat uji Anda TIDAK terdaftar
- Jika app baru saja di-install, tunggu beberapa menit
- Uninstall app dari device
- Ulangi langkah yang sama untuk pengujian atribusi install menggunakan format OneLink di atas
- Tunggu hingga dua menit agar install dari retargeting muncul di dashboard
- Buka dashboard app, lalu klik Re-Targeting di menu sebelah kiri
- Anda akan melihat re-attributed install yang diatribusikan ke media source Test di nama kampanye Test
Untuk verifikasi yang lebih terperinci, Anda dapat mendownload raw data laporan konversi.
Di dashboard app, klik Export Data di bagian Reports. Di bagian Re-Targeting Reports , download raw data laporan Conversions.
Pengujian Re-Engagement
Re-engagement terjadi saat user yang meng-install app, berinteraksi dengan kampanye retargeting dan meluncurkan app.
Pengujian Re-Engagement dengan Membuka App
Re-engagement dengan membuka app artinya user dialihkan ke app store, di mana tombol buka app akan ditampilkan kepada user tersebut. Jika mereka mengklik tombol buka dan meluncurkan app, re-engagement akan dicatat.
Untuk menguji re-engagement, ikuti langkah-langkah di bawah ini:
- Pastikan app sudah di-install di device uji dan telah diluncurkan beberapa kali
- Jika app baru saja di-install, tunggu beberapa menit
- Gunakan OneLink yang sama seperti yang digunakan untuk menguji re-attribution
- Tambahkan device ID ke link dan kirim ke ponsel anda
- Buka link menggunakan browser
- Buka app secara manual dengan tombol Open di app store atau atau dari launch pad device
Anda akan melihat re-engagement yang diatribusikan ke media source Test di nama kampanye Test.
Pengujian Re-Engagement via Deep Linking
Re-engagement melalui deep linking memungkinkan app langsung terbuka setelah user mengklik link atribusi. Manfaat penggunaan re-engagement dengan deep linking:
- Pengalaman user yang lebih baik - user tidak dialihkan ke app store dan app diluncurkan secara otomatis
- Kampanye yang lebih baik - Anda dapat membuat user membuka event yang spesifik terkait kampanye anda dan memaksimalkan hasil kampanye retargeting.
Anda dapat menguji atribusi re-engagement dengan deep linking. Ini adalah prosedur yang sama seperti pengujian re-engagement dengan link atribusi. Satu-satunya perbedaan adalah link atribusi berisi parameter af_dp
yang mengalihkan user ke aktivitas tertentu pada app.
Untuk menguji re-engagement menggunakan deep linking, ikuti langkah-langkah di bawah ini:
- Pastikan untuk mengonfigurasi app Anda untuk deep linking
- Pastikan app sudah di-install di device uji dan telah diluncurkan beberapa kali
- Jika app baru saja di-install, tunggu beberapa menit
- Membuat link retargeting dengan device ID
- Tambahkan parameter af_dp and tambahkan skema yang Anda konfigurasikan pada langkah 1
- Buka link menggunakan browser
- Jika app terinstall, link akan meluncurkan app di event yang ditentukan di link
Anda akan melihat re-engagement yang diatribusikan ke media source Test di nama kampanye Test.
Untuk informasi lebih lanjut, lihat panduan tentang Pengujian Deeplinking.
Cara tambahan untuk Menguji Integrasi SDK
Ada dua cara tambahan untuk menguji integrasi SDK:
Bagian ini menunjukkan cara men-debug SDK. Pelajari bagian ini untuk melakukan pengujian lanjutan dan untuk mengatasi masalah tentang integrasi SDK.
Debugging aplikasi Android
Debugging SDK memberi Anda perspektif mendalam tentang cara mengintegrasikan SDK dengan app Anda. Debugging membantu Anda memecahkan masalah rekaman in-app event, data konversi, serta validasi pembelian.
Mengaktifkan mode Debug SDK Android
Untuk memulai debugging SDK Android, tambahkan baris berikut ini ke class AFApplication:
AppsFlyerLib.getInstance().setDebugLog(true);
Peringatan!
Debugging harus dibatasi hanya untuk fase pengembangan. Jangan kirim app dengan debugging aktif ke app store. Hal tersebut dapat menimbulkan risiko keamanan dan risiko privasi yang serius.
Melihat Output Debug
Untuk melihat output debug, buka terminal Logcat di Android studio. Pilih nama paket app sebagai proses yang bisa di debug, atur level log ke Debug dan filter berdasarkan "AppsFlyer_".
Memecahkan masalah umum dengan Android SDK
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.
- link atribusi yang Anda gunakan salah. Lihat panduan link 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 metode
startTracking
daninit
dipanggil di classAFApplication
. - 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 menandakan bahwa app ID salah. Pastikanapp ID pada parameter applicationId
di file 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 pendapatan tidak boleh berisi 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 metode startTracking
tanpa meneruskan dev key sebagai parameter. Teruskan dev key 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 metode init
dan meneruskan dev key sebagai string kosong. Teruskan dev key ke metode tersebut.
Saya mendapat respons 400 saat Menguji In-App Event
Skenario
Anda sedang mencoba pengujian in-app event di log. Saat memicu event, Anda melihat respons 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 baris berikut
implementation 'com.google.android.gms:play-services-base:15.0.1'
implementation 'com.google.android.gms:play-services-ads:15.0.1'
Di file build.gradle level (app) modul.
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
Ini mungkin karena Anda memiliki paket Zero, yang tidak mencakup data atribusi; hanya data tentang klik dan tayangan. Untuk mulai menerima data atribusi, pelajari selengkapnya tentang paket AppsFlyer lainnya, dan perbarui sesuai kebutuhan. Anda juga dapat menghubungi tim interaksi pelanggan kami di hello@appsflyer.com jika Anda memiliki pertanyaan tentang paket kami.
Debugging untuk iOS
Mengaktifkan mode Debug SDK iOS
Untuk memulai debugging SDK iOS, tambahkan baris berikut ini ke metode didFinishLaunchingWithOptions
:
Tambahkan baris berikut di AppDelegate.m:
[AppsFlyerLib shared].isDebug = true;
Tambahkan baris berikut di AppDelegate.swift:
AppsFlyerLib.shared().isDebug = true
Peringatan!
Debugging harus dibatasi hanya untuk fase pengembangan. Jangan kirim app dengan debugging aktif ke App Store. Hal tersebut dapat menimbulkan risiko keamanan dan risiko privasi yang serius.
Melihat Output Debug
Untuk melihat output debug, buka terminal debug terminal di XCode dan filter menurut "AppsFlyer".
Memecahkan masalah umum dengan iOS SDK
Install dan Event tidak direkam
Ada beberapa alasan mengapa install dan event tidak direkam:
Jika Anda menentukan app ID dengan format yang salah, install dan event tidak akan direkam. Saat mengatur app ID di file delegate, pastikan ID hanya berisi angka.
Anda dapat menemukan dev key di Dashboard AppsFlyer di dalam App Settings:
Benar:
[AppsFlyerTracker sharedTracker].appleAppID = @"340954503";
Salah:
[AppsFlyerTracker sharedTracker].appleAppID = @"id340954503";
Salah:
[AppsFlyerTracker sharedTracker].appleAppID = @"com.appslyer.sampleapp";
Jika format App ID salah, log akan menampilkan error berikut:
[ERROR] AppsFlyer: -[AppsFlyerTracker validateAppID] AppsFlyer Error: appleAppID should be a number!
Jika Anda menentukan App ID yang tidak ada di akun Anda, install dan event tidak akan direkam. Log akan menampilkan error berikut:
AppsFlyer: -[AppsFlyerHTTPClient sendRequestEventToServer:isRequestFromCache:appID:isDebug:
completionHandler:]_block_invoke sent information to server, status = 404
Error 404 menandakan bahwa SDK tidak dapat menemukan aplikasi di akun Anda.
Jika Anda menentukan ID kode pengembang yang salah, install dan event tidak akan direkam. Log akan menampilkan error berikut:
AppsFlyer: -[AppsFlyerHTTPClient sendRequestEventToServer:isRequestFromCache:appID:isDebug:completionHandler:]
_block_invoke sent information to server, status = 400
Error 400 mengindikasikan bahwa SDK tidak dapat mengautentikasikan permintaan untuk merekam install dan event. Pastikan dev key yang dipakai sudah benar. Pastikan juga dev key hanya berisi karakter alfanumerik.
ID App dan Kode Programmer Benar tapi Install tidak direkam
Skenario
App berisi App ID dan kode dev key yang benar tapi install tidak direkam.
Kemungkinan Penyebab
- SDK tidak terinisiasi dengan benar. Pastikan untuk memanggil metode
trackAppLaunch
diapplicationDidBecomeActive
:
- (void)applicationDidBecomeActive:(UIApplication *)application { [[AppsFlyerTracker sharedTracker] trackAppLaunch]; }
func applicationDidBecomeActive(application: UIApplication) { AppsFlyerTracker.shared().trackAppLaunch() }
Log Menampilkan "AppsFlyer dev key missing or empty. Aborting"
Skenario
Anda mencoba melihat install dan in-app event di log. Log menampilkan "AppsFlyer dev key missing or empty. Aborting".
Kemungkinan Penyebab
Dev key belum diatur. Pastikan untuk mengaturnya dalam appDelegate di metode didFinishLaunchingWithOptions
:
[AppsFlyerTracker sharedTracker].appsFlyerDevKey = @"YOUR_DEV_KEY";
AppsFlyerTracker.shared().appsFlyerDevKey = "YOUR_DEV_KEY"
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
- link atribusi yang Anda gunakan salah. Lihat panduan link atribusi.
- Pastikan perangkat yang Anda uji itu terdaftar.
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 pendapatan tidak boleh berisi koma, simbol mata uang, atau teks. Misalnya, event pendapatan harus serupa dengan 1234.56.
Saya Mendapat Respons 404 pada Rekaman Install atau Event
Skenario
Anda sedang menguji install dan in-app event untuk melihat bahwa mereka diatribusikan ke media source yang tepat. Namun, muncul respons 404 untuk install dan in-app event. install atau in-app event tidak muncul di dashboard.
Kemungkinan Penyebab
Respons 404 menandakan bahwa App ID salah. Lihat Install dan Event tidak direkam.
Saya mendapat respons 400 pada Rekaman Install atau Event
Skenario
Anda sedang mencoba pengujian in-app event di log. Saat memicu event, Anda melihat respons 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. Lihat Install dan Event tidak direkam.
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
Ini mungkin karena Anda memiliki paket Zero, yang tidak mencakup data atribusi; hanya data tentang klik dan tayangan. Untuk mulai menerima data atribusi, pelajari selengkapnya tentang paket AppsFlyer lainnya, dan perbarui sesuai kebutuhan. Anda juga dapat menghubungi tim interaksi pelanggan kami di hello@appsflyer.com jika Anda memiliki pertanyaan tentang paket kami.
Debugging untuk Unity
Mengaktifkan Mode Debug di Unity
Untuk memulai debugging SDK Unity, tambahkan baris berikut ini ke metode start
di AF GameObject
AppsFlyer.setIsDebug (true);
Peringatan!
Debugging harus dibatasi hanya untuk fase pengembangan. Jangan kirim app dengan debugging aktif ke app store. Hal tersebut dapat menimbulkan risiko keamanan dan risiko privasi yang serius.
Melihat Output Debug
Output debug dilihat melalui Android Studio atau XCode.
Memecahkan masalah umum dengan Unity SDK
Unity hanya membuat app Android dan iOS. Lihat masalah umum setiap platform untuk informasi selengkapnya:
Catatan
Setelah Anda selesai menguji dan men-debug integrasi SDK, matikan log SDK.