Ekstensi Adobe Launch SDK

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

dev_key.png

  1. Di dashboard aplikasi Anda, klik Pengaturan Aplikasi di bawah Konfigurasi di menu sebelah kiri.
  2. 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. Masuk ke Adobe Experience Cloud.
  2. Pilih Launch.
  3. Klik Buka Launch.
  4. Klik Properti Baru.
  5. Beri nama properti dan pilih Seluler.
  6. Klik Simpan (Save).

1.2 Menginstal ekstensi Adobe Launch yang diperlukan

Instal ekstensi berikut di Adobe Launch:

adboe_extensions.png

  • 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

  1. Masuk ke Adobe Analytics.
  2. Membuat rangkaian laporan.
  3. Masuk kembali ke Adobe Launch.
  4. Dari daftar properti, klik pada properti yang telah Anda buat sebelumnya.
  5. Klik Ekstensi.
  6. Mencari dan menginstal Adobe Analytics.
  7. Di bawah Rangkaian Laporan, tentukan rangkaian laporan yang telah Anda buat di langkah 2.
  8. Klik Simpan (Save).

Menginstal Ekstensi AppsFlyer SDK

  1. Pilih Ekstensi lagi.
  2. Mencari dan menginstal Ekstensi AppsFlyer SDK.
  3. Di bawah ID Aplikasi iOS Appsflyer, tentukan ID aplikasi iOS yang Anda dapatkan di langkah prasyarat.
  4. Di bawah Kunci Pengembang AppsFlyer tentukan kunci pengembang yang Anda dapatkan di langkah prasyarat.
  5. Aktifkan Mengirim data atribusi ke Adobe Analytics. Perhatikan bahwa ada beberapa pembatasan dalam membagikan data tingkat pengguna dengan platform analitik pihak ketiga.
  6. Klik Simpan (Save).

Instal Profil dan ekstensi Mobile Core

  1. Pilih Ekstensi lagi.
  2. Mencari dan menginstal Profil.
  3. 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

adobe_sdk.png

  1. Di dalam properti Adobe Anda, pilih Lingkungan (Environments).
  2. Pilih lingkungan tempat Anda ingin menerapkan SDK.
  3. Di sisi kanan, klik ikon kotak.
  4. 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.

adobe_publishing.png

  1. Di dalam properti Adobe Anda, pilih Penerbitan (Publishing).
  2. Klik Tambah Library Baru.
  3. Beri nama dan di bawah Lingkungan, pilih Pengembangan (Development).
  4. Klik Simpan & Bangun untuk Pengembangan
  5. Setelah pembangunan selesai, di bawah Pengembangan, klik tiga titik di samping library dan pilih Kirim untuk Persetujuan.
  6. Di bawah Dikirimkan, klik tiga titik di samping library dan pilih Bangun untuk Staging.
  7. Setelah pembangunan selesai, klik tiga titik di samping library dan pilih Setujui untuk Penerbitan.
  8. 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
Menambahkan pengarah instal menggunakan Gradle Menambahkan pengarah instal secara manual

 Tambahkan Pengarah Instal Android sebagai dependensi. Anda dapat menemukan versi terbaru di sini.

  1. 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'
    }
  2. Sinkronkan proyek untuk memunculkan dependensi kembali - lihat tangkapan layar berikut:

    android_af_sdk_sync_gradle.png

Jika Anda menggunakan ProGuard dan ingin menggunakan pengarah API baru dari Google, tetapkan aturan ProGuard berikut ini: -dontwarn com.android.installreferrer

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

  1. 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.

Android iOS
final Map<String,String> eventMap = new HashMap<>();  
eventMap.put("currency", "USD");  
eventMap.put("revenue", "200");  
eventMap.put("freehand", "param");

MobileCore.trackAction("af_purchase", eventMap);

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.

Android iOS

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);
		}
	});

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.

adobe_analytics.png

  1. Masuk ke Adobe Mobile Services Anda.
  2. Pilih aplikasi yang relevan dan masuk ke bagian halaman Kelola Variabel & Metrik.
  3. Pilih opsi Variabel Khusus dan konfigurasikan variabel untuk memetakan data AppsFlyer SDK ke sistem Adobe.
  4. Untuk setiap variabel khusus, masukkan nama yang bermakna.
  5. 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.