Panduan integrasi plugin V6 Unity—Integrasi SDK tambahan

At a glance: Additional SDK functionalities that are available to implement APIs such as uninstall measurement, user invite attribution, push notifications, and privacy settings. 

 Bacaan terkait

For a complete picture of integrating the Unity plugin with your apps, be sure to read these articles: 

Atribusi

Mengukur Uninstall

Ukur tingkat penghapusan pengguna yang berasal dari berbagai sumber.

Untuk mengatur pengukuran uninstall, lihat instruksi sistem operasi yang relevan.

Android - FirebaseiOS
  1. Unduh SDK Unity Firebase dari:  https://firebase.google.com/docs/unity/setup.
  2. Impor FirebaseMessaging.unitypackage ke dalam proyek.
  3. Impor google-services.jsonke dalam proyek (diperoleh dari konsol Firebase)

     Catatan

    SDK Firebase Unity secara otomatis menambahkan penerima nyata.

  4. Tambahkan kode ini pada kelas Unity menangani kode AppsFlyer:
    menggunakan Firebase.Messaging;
    menggunakan Firebase.Unity;
  5. Tambahkan metode Start():
    Firebase.Messaging.FirebaseMessaging.TokenReceived += OnTokenReceived;
  6. Tambahkan metode ini:
    public void OnTokenReceived(object sender, Firebase.Messaging.TokenReceivedEventArgs token)
    {
    #if UNITY_ANDROID
    AppsFlyerAndroid.updateServerUninstallToken(token.Token);
    #endif
    }

 Panduan uninstall (hapus penginstalan) Android

 Peringatan

Skenario: Menerapkan SDK Firebase Unity. 

Persyaratan: Jangan tambahkan panggilan metode berikut enableUninstallTracking(“SenderID”) jika Anda menambahkan SDK Unity Firebase ke proyek Anda.

Konsekuensi jika ditambahkan:

  • SDK Unity Firebase akan mendapatkan ID pengirim dari file google-services.json (yang ditambahkan sebelumnya).
  • Sebagai hasilnya, hal ini bisa menyebabkan peringatan debug dari Android.

Atur data kustom tambahan

Untuk mengintegrasikan pada tingkat SDK dengan beberapa platform mitra eksternal (termasuk Segment, Adobe, dan Urban Airship), penting untuk menggunakan setAdditionalData API.

Hanya gunakan API ini jika artikel integrasi mitra menyatakan secara eksplisit bahwa API setAdditionalData diperlukan.

Contoh: kodesetAdditionalData 

Dictionary<string, string> CustomDataMap = new Dictionary<string, string>();
CustomDataMap.Add("custom_param_1", "value_of_param_1");
AppsFlyer.setAdditionalData(CustomDataMap);

Sesi

Waktu Antar Sesi Kustom

Secara default, setidaknya ada jeda selama 5 detik antara dua peluncuran aplikasi agar terhitung sebagai dua sesi terpisah.  Mengatur waktu minimum antara sesi:

AppsFlyer.setMinTimeBetweenSessions(custom_time_ins_seconds);

Catat! Jika Anda mengatur nilai tinggi pada   waktu kustom antara peluncuran, hal ini dapat berdampak buruk pada API yang bergantung pada data sesi (seperti deep linking).

Lihat lebih lanjut tentang menghitung sesi aplikasi.

Sesi Latar Belakang untuk Aplikasi Utilitas

Tidak tersedia dalam Unity.

Media yang Dimiliki Sendiri

Menyelesaikan URL deep-link tergabung

Beberapa layanan pihak ke-3 (seperti penyedia layanan email):

  • Hubungkan tautan dalam email menggunakan domain catatan klik mereka sendiri.
  • Memungkinkan Anda untuk mengatur domain pencatatan klik Anda sendiri.

Jika OneLink tergabung dalam domain seperti itu, fungsinya dapat dibatasi. Untuk mengatasi hal ini:

  • Panggil setResolveDeepLinkURLs API sebelum inisialisasi SDK.
  • API mendapatkan OneLink dari domain klik yang meluncurkan aplikasi. 

Skenario: Domain klik diarahkan ke OneLink Anda di https://mysubdomain.onelink.me/abCD.

Solusi:

  • Gunakan setResolveDeepLinkURLsAPI untuk mendapatkan OneLink yang diraih setelah domain klik mengarahkan ulang seorang pengguna aplikasi.
  • Metode API ini menerima daftar domain yang diselesaikan oleh plugin.
  • Kode berikut ini memungkinkan Anda menggunakan domain klik Anda, tapi juga, mempertahankan fungsionalitas OneLink:

     Contoh

    AppsFlyer.setResolveDeepLinkURLs("example.com", "click.example.com");

Sekarang,  gunakan data dari OneLink untuk deep link dan menyesuaikan konten pengguna.

Catat pemberitahuan push

Rekam notifikasi push sebagai bagian dari kampanye penargetan ulang.

Untuk mencatat pemberitahuan push:

  • Panggil metode sendPushNotificationData.
  • Metode ini di dalam metode onCreate dari setiap aktivitas yang diluncurkan setelah mengklik pemberitahuan ini:
#if UNITY_ANDROID && !UNITY_EDITOR
AppsFlyerAndroid.handlePushNotifications();
#endif

Untuk informasi lebih lanjut, baca tentang pengukuran pemberitahuan push.

Atribusi Undangan Pengguna

Jika pengguna aplikasi yang ada mengundang teman dan kontak mereka untuk menjadi pengguna baru, ini bisa menjadi sumber pertumbuhan.

Atribusikan dan catat penginstalan yang berasal dari undangan pengguna dalam aplikasi. Atribusi undangan pengguna.

Atribusi Promosi Silang

Aplikasi promosi silang dapat mendorong penginstalan aplikasi tambahan. 

Atribusikan dan catat penginstalan yang berasal dari kampanye promosi silang: promosikan salah satu aplikasi Anda dari dalam aplikasi Anda lainnya yang telah diluncurkan oleh salah satu pengguna Anda. Atribusi promosi silang.

User identifiers

Dapatkan ID AppsFlyer

ID AppsFlyer dibuat untuk setiap penginstalan aplikasi baru. Gunakan ID AppsFlyer untuk:

  • Mengirim in-app event server ke server .
  • Sesuaikanlah dengan catatan pengguna di sistem back end Anda.
  • Memetakan entri saat menggabungkan data dari pull dan push API.

 Untuk mendapatkan ID AppsFlyer yang unik:

string AppsFlyerUID = AppsFlyer.getAppsFlyerId();

Mengatur ID Pengguna Pelanggan

Tetapkan ID pengguna pelanggan unik Anda sendiri (CUID) dan rujukan silang dengan ID AppsFlyer unik.

CUID unik: 

  • Muncul di AppsFlyer data mentah laporan CSV.
  • Dapat digunakan dalam API postback ke rujukan silang dengan ID internal.

Untuk mengatur CUID, gunakan:

AppsFlyer.setCustomerUserId("someId");

Praktek terbaik! Atur CUID di awal alur aplikasi—ini hanya dihubungkan dengan event yang dilaporkan setelah pengaturannya.

Panggil metode setCustomerUserId sebelum memanggil metodestartSDK

  • Event yang dicatat akan dihubungan dengan CUID.
  • Data terhubung akan muncul di laporan data mentah untuk instalasi dan event.
AppsFlyer.setCustomerUserId("someId");

Dapatkan ID Pengguna Pelanggan

Periksa CUID untuk informasi lebih lanjut.

Tunda plugin init untuk customerUserID

Atur ID pengguna pelanggan (Customer User ID/CUID) dan kemudian inisialisasi plugin. Hal ini berguna jika Anda ingin menginstal dan data event agar berisi CUID Anda.

Lihat petunjuk sistem operasi terkait:

  1. Android
  2. iOS

 Peringatan

Hanya tunda pengaturan CUID jika sesuai dengan logika bisnis Anda. Jika Anda menunda pengaturan CUID, ini dapat meningkatkan  kesempatan untuk perbedaan dan dapat menyebabkan aplikasi Anda melakukan upaya penipuan.

Kumpulkan OAID

OAID adalah salah satu identifier perangkat unik yang memungkinkan atribusi.

Untuk mengumpulkan OAID:

Plugin Unity V5.4 dan yang selebihnya Plugin Unity V5.3 dan sebelumnya

OAID dikumpulkan secara otomatis secara default. Untuk menonaktifkan, panggil metode AppsFlyerAndroid.setCollectOaid(false); .

Privasi pengguna

Opt-Out

Skenario berbeda, seperti masalah kepatuhan hukum dan privasi, dapat menyebabkan keputusan untuk memilih menonaktifkan dan menghentikan semua pelacakan SDK.

Praktik terbaik! Ikuti petunjuk tepat untuk skenario terkait aplikasi Anda.

Untuk menghentikan pelacakan:

  • Panggil metode stopSDKdan atur ketrue.
    AppsFlyer.stopSDK(true);
  • Plugin berhenti berfungsi dan tidak lagi berkomunikasi dengan server AppsFlyer.

Untuk mengaktifkan kembali pelacakan: Panggil stopSDK dan atur ke false.

 Perhatian

Gunakan API stopSDK jika Anda ingin benar-benar berhenti melacak pengguna aplikasi tertentu. Penggunaan API sangat memengaruhi atribusi, pengumpulan data, dan mekanisme  deep linking .

Menganonimkan Data Pengguna

Anonimkan pengidentifikasi pengguna tertentu dalam analitik AppsFlyer untuk mematuhi peraturan privasi dan data Facebook dan kebijakan privasi.

Untuk menganonimkan pengguna aplikasi:

  1. Atur API selama inisialisasi SDK
  2. Panggil metode anonymizeUser dan atur ke true .
    AppsFlyer.anonymizeUser(true);
  3. Penginstalan, event, dan sesi pengguna aplikasi dianonimkan.

Untuk merestart pelacakan:Panggil anonymizeUser  dan setel ke false .

 Peringatan

Penganoniman user berdampak berat pada informasi atribusi Anda. Gunakan pilihan ini hanya untuk wilayah yang secara hukum mencegah Anda dari mengumpulkan informasi pengguna.

Kecualikan mitra dari mendapatkan data

Pada beberapa kasus, pengiklan mungkin ingin berhenti berbagi data tingkat pengguna dengan jaringan iklan/mitra untuk pengguna tertentu. Alasannya mencakup: 

  • Kebijakan privasi seperti CCPA atau GDPR
  • Mekanisme data pengguna tidak terlacak
  • Kompetisi dengan beberapa mitra (jaringan iklan, pihak ketiga)

AppsFlyer menyediakan dua metode API untuk berhenti berbagi data dengan beberapa atau semua mitra:

  • setSharingFilterUsed by advertisers to set some (one or more) networks/integrated partners to exclude from getting data.
  • setSharingFilterForAllPartners: Used by advertisers to exclude all networks/integrated partners from getting data.

Metode pemfilteran ini didukung sejak SDK V5.4.1.

Metode pemfilteran harus diaktifkan setiap kali SDK diinisialisasi dan memengaruhi semua sesi. Jika butuh waktu untuk menentukan apakah Anda perlu mengatur filter berbagi, maka tunda inisialisasi SDK. 

Ketika metode ini diaktifkan sebelum yang pertama  startSDK   panggil:

  • Pengguna dari SRN dikaitkan sebagai Organik, dan datanya tidak dibagikan dengan mitra terintegrasi.
  • Pengguna dari klik jaringan iklan (non-SRNs) diatribusikan dengan tepat di AppsFlyer, tetapi tidak berbagi dengan ad network via postback, APIs, laporan data lengkap, atau dengan metode lainnya.

Saat ini, uninstall data tidak dapat difilter menggunakan metode ini. Namun, Anda dapat berhenti mengirim event Uninstall ke mitra menggunakan  laman pengaturan di AppsFlyer.