Sekilas: Kirim data ke Adobe Launch SDK dan AppsFlyer SDK dengan implementasi tunggal Ekstensi AppsFlyer Adobe Launch SDK.
Ringkasan
Adobe Launch SDK merupakan bagian integral dari Adobe Experience Platform. Adobe Experience Platform membantu bisnis mengumpulkan, mengonsolidasikan, dan menganalisis data dari berbagai aplikasi dan platform. Hal ini memungkinkan pemilik bisnis dan pengembang untuk lebih memahami perilaku pelanggan untuk mengoptimalkan pengalaman dan pengiriman konten. Jika aplikasi Anda mengimplementasikan Adobe Launch SDK dan AppsFlyer SDK, Anda dapat mengirim data ke keduanya dengan satu implementasi dari Ekstensi AppsFlyer Adobe Launch SDK. Hal ini mengurangi kompleksitas keseluruhan proses pengembangan Anda dan membuat basis kode lebih bersih dan mudah dipelihara.
Catatan
Jika Anda menggunakan ekstensi Adobe Launch, Anda tidak memerlukan integrasi Adobe Analytics standar.
Prasyarat
Beberapa hal diperlukan sebelum mengintegrasikan Ekstensi AppsFlyer Adobe SDK.
Dapatkan kunci pengembang AppsFlyer Anda
- Di dashboard aplikasi Anda, klik Pengaturan Aplikasi di bawah Konfigurasi di menu sebelah kiri.
- Di bawah Instalasi SDK, salin bagian Kunci Pengembang (Dev Key).
Dapatkan ID aplikasi Anda
- Untuk Android - ID aplikasi adalah nama paket, misalnya example.com.app.
- Untuk iOS - ID aplikasi adalah ID iTunes aplikasi tanpa awalan id, misalnya 123456748.
Langkah 1: Melakukan konfigurasi Adobe Launch
Ikuti petunjuk di sini untuk mengonfigurasi Adobe Launch.
1.1 Membuat properti baru di Adobe Launch
1.2 Menginstal ekstensi Adobe Launch yang diperlukan
Instal ekstensi berikut di Adobe Launch:
- Adobe Analytics - menghubungkan data yang dicatat dari SDK ke modul Adobe Analytics.
- Ekstensi AppsFlyer SDK - mengirimkan data dan event ke Adobe dan AppsFlyer menggunakan Adobe Launch SDK.
- Profil Adobe - memungkinkan SDK untuk menyimpan data ke dalam profil sisi klien.
- Adobe Mobile Core - memungkinkan konfigurasi SDK seluler dan menyediakan akses ke event dan kondisi siklus hidup default.
Menginstal ekstensi Adobe Analytics
- Masuk ke Adobe Analytics.
- Membuat rangkaian laporan.
- Masuk kembali ke Adobe Launch.
- Dari daftar properti, klik pada properti yang telah Anda buat sebelumnya.
- Klik Ekstensi.
- Mencari dan menginstal Adobe Analytics.
- Di bawah Rangkaian Laporan, tentukan rangkaian laporan yang telah Anda buat di langkah 2.
- Klik Simpan (Save).
Menginstal Ekstensi AppsFlyer SDK
- Pilih Ekstensi lagi.
- Mencari dan menginstal Ekstensi AppsFlyer SDK.
- Di bawah ID Aplikasi iOS Appsflyer, tentukan ID aplikasi iOS yang Anda dapatkan di langkah prasyarat.
- Di bawah Kunci Pengembang AppsFlyer tentukan kunci pengembang yang Anda dapatkan di langkah prasyarat.
- Aktifkan Mengirim data atribusi ke Adobe Analytics. Perhatikan bahwa ada beberapa pembatasan dalam membagikan data tingkat pengguna dengan platform analitik pihak ketiga.
- Klik Simpan (Save).
Instal Profil dan ekstensi Mobile Core
- Pilih Ekstensi lagi.
- Mencari dan menginstal Profil.
- Mencari dan menginstal Mobile Core.
- Saat menginstal Mobile Core, cukup simpan ekstensi apa adanya. Tidak perlu menentukan Experience Server Cloud.
Langkah 2: Menerapkan Ekstensi AppsFlyer Adobe SDK
Ikuti petunjuk di bagian ini untuk mengimplementasikan Ekstensi Adobe SDK ke dalam aplikasi Anda.
2.1 Menambahkan SDK ke aplikasi
- Di dalam properti Adobe Anda, pilih Lingkungan (Environments).
- Pilih lingkungan tempat Anda ingin menerapkan SDK.
- Di sisi kanan, klik ikon kotak.
- Salin potongan kode dari jendela yang terbuka dan ikuti petunjuknya. Jika Anda adalah pemasar yang melakukan konfigurasi Adobe, kirim cuplikan kode ini ke pengembang aplikasi Anda.
2.2 Memublikasikan lingkungan (environment)
Untuk menyelesaikan implementasi SDK, Anda perlu memublikasikan lingkungan pada library.
- Di dalam properti Adobe Anda, pilih Penerbitan (Publishing).
- Klik Tambah Library Baru.
- Beri nama dan di bawah Lingkungan, pilih Pengembangan (Development).
- Klik Simpan & Bangun untuk Pengembangan.
- Setelah pembangunan selesai, di bawah Pengembangan, klik tiga titik di samping library dan pilih Kirim untuk Persetujuan.
- Di bawah Dikirimkan, klik tiga titik di samping library dan pilih Bangun untuk Staging.
- Setelah pembangunan selesai, klik tiga titik di samping library dan pilih Setujui untuk Penerbitan.
- Di bawah Menyetujui, klik tiga titik di samping library dan pilih Bangun & Terbitkan ke Produksi.
2.3 Menambahkan pengarah instal (install referrer) Android ke aplikasi Anda
Pengarah Instal Android meningkatkan keakuratan atribusi, melindungi dari kecurangan penginstalan, dan banyak lagi. Ini didukung dari AppsFlyer Android SDK versi 4.8.6.
Catatan
Google menghentikanBroadcastReceiver pada Maret 2020.
- Perubahan ini tidak berdampak pada aplikasi.
- Anda mungkin masih memerlukan BroadcastReceiver untuk atribusi di luar play store. Periksa dengan play store di mana aplikasi terdaftar untuk memastikan.
- Mengimplementasikan install referrer (pengarah instal) sekarang diwajibkan.
Ada dua cara untuk menambahkan pengarah instal ke aplikasi Anda:
- Menggunakan Gradle (disarankan)
- Menambahkan pengarah instal secara manual
Tambahkan Pengarah Instal Android sebagai dependensi. Anda dapat menemukan versi terbaru di sini.
-
dependencies { //make sure to use the latest SDK version: https://mvnrepository.com/artifact/com.appsflyer/af-android-sdk implementation 'com.appsflyer:af-android-sdk:5.+' implementation 'com.android.installreferrer:installreferrer:1.1' }
- Sinkronkan proyek untuk memunculkan dependensi kembali - lihat tangkapan layar berikut:
Jika Anda menggunakan ProGuard dan ingin menggunakan pengarah API baru dari Google, tetapkan aturan ProGuard berikut ini: -dontwarn com.android.installreferrer
- Unduh Install Referrer aar
- Tambahkan ke proyek
- Tambahkan hak akses berikut ke manifes:
com.google.android.finsky.permission.BIND_GET_INSTALL_REFERRER_SERVICE
2.4 Mengatur hak akses yang diperlukan
Menambahkan hak akses membantu meningkatkan tingkat Atribusi pemodelan probabilistik. Hal ini juga memungkinkan SDK untuk mengirimkan lebih banyak data seperti Wifi dan data jaringan operator. Anda dapat menemukan data ini di laporan data lengkap dan menggunakannya untuk analisis dan pengoptimalan kampanye.
Tambahkan Hak Akses yang Diperlukan
- Tambahkan hak akses berikut ke AndroidManifest.xml:
<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> <!-- Optional : --> <uses-permission android:name="android.permission.READ_PHONE_STATE" />
Menggunakan ekstensi Adobe SDK
Sekarang Anda dapat mulai menggunakan ekstensi Adobe SDK untuk mengirim data ke Adobe dan AppsFlyer.
Catatan
Saat ini, ekstensi Adobe Launch SDK hanya mendukung untuk mendapatkan data konversi dan mengirim event. Namun, ketika Anda menambahkan ekstensi Adobe Launch SDK ke aplikasi Anda, AppsFlyer SDK juga ditambahkan. Oleh karena itu, fungsionalitas apa pun yang saat ini tidak ada dalam ekstensi Adobe SDK dapat diimplementasikan menggunakan AppsFlyer SDK.
Mengirim event
In-App event memberikan wawasan tentang hal yang terjadi di aplikasi Anda. Sebaiknya luangkan waktu dan tentukan event yang ingin Anda catat. Mencatat in-app event membantu Anda mengukur KPI seperti ROI (Laba atas Investasi) dan LTV (Nilai Seumur Hidup).
Ekstensi Adobe Launch SDK memungkinkan Anda untuk mengirim data in-app event ke Adobe dan AppsFlyer. Anda kemudian dapat menggunakan Adobe Analytics untuk menganalisis perilaku pengguna dan AppsFlyer untuk menganalisis ROI dan LTV.
final Map<String,String> eventMap = new HashMap<>();
eventMap.put("currency", "USD");
eventMap.put("revenue", "200");
eventMap.put("freehand", "param");
MobileCore.trackAction("af_purchase", eventMap);
[ACPCore trackAction:@"af_purchase data:@{@"revenue":@"200",@"currency":@"USD"];
Mengirimkan event seperti yang ditentukan dalam kode di atas akan membuat event di dashboard AppsFlyer bernama af_purchase dengan pendapatan 200 Dolar Amerika Serikat. Event ini juga dikirim ke dan muncul di Adobe Analytics.
Semua data konversi yang dikirim dengan event diawali dengan appsflyer. Lihat tabel berikut ini untuk contoh:
Variabel data konversi yang diawali |
---|
appsflyer.af_click_lookback |
appsflyer.install_time |
appsflyer.cost_cents_USD |
appsflyer.media_source |
appsflyer.af_adset |
appsflyer.click_time |
appsflyer.orig_cost |
appsflyer.campaign |
Data konversi digunakan dalam aplikasi yang Anda buat di Adobe Mobile Services. Ada parameter lain yang dapat muncul dalam data konversi. Untuk mempelajari lebih lanjut, klik di sini.
Mendapatkan data untuk deep linking dan deferred deep linking
Deep linking dan deferred deep linking memungkinkan Anda untuk meningkatkan pengalaman pengguna. Fitur ini memungkinkan Anda untuk membuka aplikasi dalam aktivitas tertentu dan menyesuaikan konten sesuai dengan data kampanye.
Untuk mendapatkan data dari deep linking, terapkan pemanggilan balik ekstensi.
Di kelas aplikasi global, terapkan kode berikut:
AppsFlyerAdobeExtension.registerAppsFlyerExtensionCallbacks(new AppsFlyerExtensionCallbacksListener() {
@Override
public void onCallbackReceived(Map<String, String> callback) {
Log.d(AppsFlyerLibCore.LOG_TAG, callback.toString());
if(callback.get("callback_type").equals("onConversionDataReceived")){
// conversion data returned
if(callback.get("is_first_launch").equals("true")){
String af_status = callback.get("af_status");
if(af_status.equals("Non-organic")){
Log.d(AppsFlyerLibCore.LOG_TAG, "this is first launch and a non organic install!");
}
}
} else if(callback.get("callback_type").equals("onAppOpenAttribution")){
// direct deeplink - redirect user
Log.d(AppsFlyerLibCore.LOG_TAG, callback.toString());
}
}
@Override
public void onCallbackError(String errorMessage) {
Log.d("TAG", errorMessage);
}
});
Di AppDelegate.m, terapkan kode berikut:
[AppsFlyerAdobeExtension registerCallbacks:^(NSDictionary *dictionary) {
NSLog(@"[AppsFlyerAdobeExtension] Received callback: %@", dictionary);
if([[dictionary objectForKey:@"callback_type"] isEqualToString:@"onConversionDataReceived"]){
if([[dictionary objectForKey:@"is_first_launch"] boolValue] == YES){
NSString* af_status = [dictionary objectForKey:@"af_status"];
if([af_status isEqualToString:@"Non-organic"]){
NSLog(@"this is first launch and a non organic install!");
}
}
} else if([[dictionary objectForKey:@"callback_type"] isEqualToString:@"onAppOpenAttribution"]) {
NSLog(@"onAppOpenAttribution Received");
}
}];
[AppsFlyerAdobeExtension callbacksErrorHandler:^(NSError *error) {
NSLog(@"[AppsFlyerAdobeExtension] Error recieving callback: %@" , error);
}];
Menghubungkan data konversi AppsFlyer
Data konversi dikirim bersama event ke platform Adobe. Variabel-variabel ini memungkinkan Anda menerapkan logika dan aturan pada dimensi, metrik, atau filter laporan.
- Masuk ke Adobe Mobile Services Anda.
- Pilih aplikasi yang relevan dan masuk ke bagian halaman Kelola Variabel & Metrik.
- Pilih opsi Variabel Khusus dan konfigurasikan variabel untuk memetakan data AppsFlyer SDK ke sistem Adobe.
- Untuk setiap variabel khusus, masukkan nama yang bermakna.
- Pilih atau ketik data konversi AppsFlyer yang dipetakan dan pilih lingkup Persistence yang Anda sukai.
Lihat tabel berikut untuk memetakan variabel Konteks AppsFlyer:
Nama yang disarankan untuk pemetaan |
Data konversi |
---|---|
Jendela Lookback AppsFlyer |
appsflyer.af_click_lookback |
Waktu Instal AppsFlyer |
appsflyer.install_time |
Biaya AppsFlyer Sen AS |
appsflyer.cost_cents_USD |
AppsFlyer MediaSource |
appsflyer.media_source |
AppsFlyer Adset |
appsflyer.af_adset |
Waktu Klik AppsFlyer |
appsflyer.click_time |
Biaya Asli AppsFlyer |
appsflyer.orig_cost |
Kampanye AppsFlyer |
appsflyer.campaign |
Menggunakan data konversi yang dipetakan AppsFlyer untuk Analitik dan Analisis
Semua data yang berasal dari SDK tersedia dalam rangkaian laporan Adobe Analytics yang terhubung ke aplikasi.
Anda dapat menggunakan data dan dimensi serta metrik terkait di seluruh laporan dan dashboard Adobe Analytics yang dihasilkan. Data ini juga tersedia di dashboard AppsFlyer untuk atribusi dan analisis in-app event.