Uji integrasi SDK seluler dengan aplikasi – Dukungan AppsFlyer

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 belum menginstal aplikasi. Jika perlu, uninstall aplikasi dari perangkat.
Daftarkan perangkat sebagai perangkat uji.
Di dashboard, pilih aplikasi.
Buka Integration (Integrasi) > SDK Integration Tests (Tes Integrasi SDK).
Halaman pengujian integrasi SDK akan 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 Penginstalan non-organik .
Pilih perangkat yang terdaftar.
Pilih sumber aplikasi:
- Android:
  - Google play
  - Lainnya (Selain Google Play, Android Studio, file .APK, dll.)
- iOS:
  - App Store
  - (XCode, TestFlight, dll.) lainnya
Pindai kode QR dengan perangkat uji terdaftar dan ikuti petunjuk di perangkat.
Tunggu hingga penginstalan non-organik terdaftar di laman SDK Integration Tests (Pengujian Integrasi SDK) mengindikasikan bahwa pengujian berhasil. Ini dapat memerlukan waktu hingga 2 menit.
Jika aplikasi tidak mencatat penginstalan non-organik pada saat itu, lihat bagian pemecahan masalah yang muncul di halaman Tes 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 tes di bawah In- app event .
Pilih perangkat uji terdaftar dari menu tarik-turun, klik Berikutnya .
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 di sini. Penting untuk dicatat bahwa implementasi SDK Deep Linking sangat disarankan, seperti yang dijelaskan dalam panduan integrasi deep linking .
Pastikan bahwa penargetan ulang diaktifkan.
Klik Jalankan tes di bawah Deep linking.
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 ubah namanya.
Buka proyek yang baru saja disalin di Android studio.
Di Android Studio, buka folder sampai Anda melihat paketnya.
Klik kanan pada nama paket, pilih Refaktor dan kemudian Ganti nama.
Ubah nama paket
Di build.grade tingkat aplikasi, ubah applicationId menjadi nama paket baru.

Tambahkan aplikasi pengujian 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

Menambahkan Aplikasi Pengujian iOS ke Dashboard AppsFlyer.
Ikuti petunjuk untuk menambahkan aplikasi baru ke dashboard AppsFlyer Anda . Pastikan untuk mengatur status aplikasi ke Persetujuan tertunda atau Tidak dipublikasikan .

Di AppDelegate , di dalam didFinishLaunchingWithOptions tambahkan kode berikut:

bool isDebugApplication = false;
...
if(isDebugApplication) {
    [AppsFlyerLib shared].isDebug = isDebugApplication;
    [AppsFlyerLib shared].appleAppID = @"11111xxxx"; // Testing app ID
  } else {
    [AppsFlyerLib shared].appleAppID = @"PROD_APP_ID"; // Production app ID
  }

var isDebugApplication = false
...
if(isDebugApplication) {
      AppsFlyerLib.shared().isDebug = isDebugApplication
      AppsFlyerLib.shared().appleAppID = "1111xxxx" // Testing app ID
    } else {
      AppsFlyerLib.shared().appleAppID = "PROD APP ID" // Production app ID
    }}

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-nya 9 digit . Mulai id dengan empat 1s. Digit yang tersisa harus acak. Lihat contoh ID di atas.

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.
Jika Anda menguji atribusi aplikasi yang tersedia melalui app store Android pihak ketiga, Anda harus mengatur parameter af_r di tautan atribusi untuk merujuk pada app store tertentu.

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
Menguji penargetan ulang (atribusi ulang dan interaksi ulang)

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 menentukan nama kampanye.
Parameter pid akan menentukan nama media source yang teratribusi dengan install.
Jika Anda menguji aplikasi yang tersedia melalui app store Android pihak ketiga: tambahkan af_r parameter ke tautan atribusi.

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 penginstalan:

Di AppFlyer, buka Laporan > Ekspor Data.
Di bagian Laporan Data Lengkap unduh Instalasi laporan data lengkap.

Lihat artikel kami tentang laporan data lengkap penginstalan untuk informasi lebih lanjut.

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 laporan data lengkap in-app event untuk informasi lebih lanjut.

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 penargetan ulang di pengaturan aplikasi.
Di dashboard aplikasi, klik App Settings (Pengaturan Aplikasi) dan aktifkan Enable Re-Targeting Campaign Measurement (Aktifkan Pengukuran Kampanye Penargetan Ulang.

Android iOS
Perangkat yang tidak terdaftar

Menguji penargetan ulang sangatlah mudah. Buat tautan atribusi personalisasi dari template OneLink. Pastikan untuk mengaktifkan Re-Targeting Campaign (Kampanye Penargetan Ulang).

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 (Tindakan)
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-instal, tunggu beberapa menit.
Uninstall aplikasi dari perangkat.
Ulangi langkah yang sama untuk pengujian atribusi penginstalan menggunakan format OneLink di atas.
Tunggu hingga dua menit agar penginstalan yang ditargetkan muncul di dashboard.
Buka dashboard aplikasi, lalu klik Re-Targeting (Penargetan ulang) di menu sebelah kiri.
Anda akan melihat penginstalan yang diatribusikan ulang diatribusikan ke Pengujian sumber media di bawah nama kampanye Test (Pengujian).

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

Penargetan ulang melalui buka aplikasi berarti bahwa pengguna diarahkan ke app store di mana ditampilkan tombol buka aplikasi. Jika pengguna mengklik tombol buka dan meluncurkan aplikasi, penargetan ulang akan dicatat.

Untuk menguji re-engagement, ikuti langkah-langkah di bawah ini:

Pastikan aplikasi sudah di-instal di perangkat pengujian dan telah diluncurkan beberapa kali.
Jika app baru saja di-instal, tunggu beberapa menit.
Gunakan OneLink yang sama seperti yang digunakan untuk menguji re-attribution (atribusi ulang).
Tambahkan ID perangkat ke tautan dan kirim ke ponsel Anda.
Arahkan ke tautan menggunakan browser.
Buka aplikasi secara manual dengan tombol Open (Buka) pada app store atau atau dari launchpad perangkat.

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 aplikasi untuk deep linking.
Pastikan aplikasi sudah di-instal di perangkat pengujian dan telah diluncurkan beberapa kali.
Jika app baru saja di-instal, tunggu beberapa menit.
Membuat tautan penargetan ulang dengan ID perangkat.
Tambahkan parameter af_dp and tambahkan skema yang Anda konfigurasikan pada langkah 1.
Arahkan ke tautan menggunakan browser.
Jika aplikasi terinstall, tautan akan meluncurkan aplikasi di aktivitas yang ditentukan di tautan.

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 integrasi SDK. Pelajari bagian ini untuk melakukan pengujian lanjutan dan untuk mengatasi masalah dalam mengintegrasikan 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.
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 metode startTracking dan init dipanggil di class AFApplication.
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 terjadi karena Anda memiliki paket Zero, yang tidak mencakup data atribusi; hanya data tentang klik dan tayangan. Untuk mulai menerima data atribusi, pelajari lebih lanjut tentang paket AppsFlyer lainnya, dan perbarui sesuai kebutuhan. Anda juga dapat menghubungi tim layanan 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, penginstalan dan event tidak dicatat. Saat mengatur ID Aplikasi 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 di applicationDidBecomeActive:

- (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

Kemungkinan Penyebab

Tautan atribusi yang Anda gunakan salah. Lihat panduan kami tentang tautan 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 tidak boleh mengandung pemisah 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 ID aplikasi salah. Lihat Penginstalan dan Event tidak dicatat.

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 ada masalah dengan kode pengembang. Pastikan kode pengembang yang dipakai sudah benar. Pastikan juga kode pengembang hanya berisi karakter alfanumerik. Lihat Penginstalan dan Event tidak dicatat.

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

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:

Masalah Umum SDK Android
Masalah Umum SDK iOS

Catatan

Setelah Anda selesai menguji dan men-debug integrasi SDK, matikan log SDK.