@capgo/capacitor-appsflyer

Ikhtisar

Tambahkan atribusi, analytics, deferred deep link, dan dukungan OneLink AppsFlyer ke aplikasi Capacitor Anda

Mulai dengan initSDK() dan metode inti lainnya yang tercantum di bawah ini.

Dukungan platform

Platform	Dukungan	Catatan
iOS	Ya	Native
Android	Ya	Native
Web	Tidak	Lindungi dengan Capacitor.getPlatform()

Kemampuan Utama

• initSDK - Gunakan metode ini untuk inisialisasi dan menjalankan SDK AppsFlyer. API ini harus dipanggil segera setelah aplikasi dijalankan.
• startSDK - Gunakan metode ini untuk menjalankan SDK AppsFlyer, hanya pada mode start manual.
• logEvent - Log event di dalam aplikasi.
• setCustomerUserId - Dengan mengatur customer ID sendiri, Anda dapat melakukan cross-reference antara ID unik Anda dengan ID unik AppsFlyer serta ID perangkat lainnya. ID ini tersedia di laporan raw-data dan pada Postback APIs untuk cross-referencing dengan ID internal Anda.

API Publik

Metode	Deskripsi
addListener('conversion_callback', listener)	Dengarkan callback konversi, termasuk onConversionDataSuccess dan onConversionDataFail, dengan OnConversionDataResult payload.
addListener('oaoa_callback', listener)	Dengarkan callback atribusi app-open, termasuk onAppOpenAttribution dan onAttributionFailure, dengan OnAppOpenAttribution payload.
addListener('udl_callback', listener)	Dengarkan callback deep link terpadu dengan OnDeepLink payload.
initSDK	Gunakan metode ini untuk inisialisasi dan menjalankan AppsFlyer SDK. API ini harus segera dipanggil saat aplikasi diluncurkan.
startSDK	Gunakan metode ini untuk menjalankan AppsFlyer SDK, hanya pada mode manual start.
logEvent	Log event in-app.
setCustomerUserId	Mengatur customer ID sendiri memungkinkan Anda melakukan cross-reference antara ID unik Anda dengan ID unik AppsFlyer dan ID perangkat lainnya. ID ini tersedia di laporan raw-data dan di Postback API untuk cross-referencing dengan ID internal Anda.
setCurrencyCode	Mengatur mata uang yang digunakan untuk in-app purchase. Masukkan code ISO 4217 tiga karakter.
updateServerUninstallToken	Teruskan token GCM/FCM di Android atau token APNs di iOS saat plugin lain telah mengumpulkannya. Gunakan ini untuk meneruskan token pengukuran uninstall ke AppsFlyer.
setAppInviteOneLink	Mengatur OneLink ID yang digunakan sebagai base link untuk atribusi undangan.
setOneLinkCustomDomain	Mendaftarkan domain OneLink bermerek agar AppsFlyer dapat me-resolve parameter atribusi yang tersembunyi di short link.
appendParametersToDeepLinkingURL	Mengaktifkan atribusi untuk deep link App Links tanpa OneLink. Panggil metode ini sebelum startSDK(). Sertakan minimal pid dan is_retargeting=true di dalam map parameters.
setResolveDeepLinkURLs	Gunakan ini saat AppsFlyer OneLink dibungkus di dalam Universal Link lain. Ini memungkinkan SDK me-resolve URL yang dibungkus sehingga deep linking tetap berfungsi dengan benar.
addPushNotificationDeepLinkPath	Mengatur cara SDK mengekstrak nilai deep link dari payload push notification.
setSharingFilter	Menghentikan event agar tidak diteruskan ke partner AppsFlyer yang ditentukan.
setSharingFilterForAllPartners	Menghentikan event agar tidak diteruskan ke semua partner AppsFlyer. Menimpa setSharingFilter.
setSharingFilterForPartners	Menghentikan event agar tidak diteruskan ke partner AppsFlyer yang ditentukan.
setAdditionalData	Menetapkan data key-value tambahan untuk dikirim ke AppsFlyer.
getAppsFlyerUID	Dapatkan ID perangkat unik AppsFlyer (dibuat untuk setiap instalasi aplikasi baru).
anonymizeUser	Opt-out pengguna akhir dari analitik AppsFlyer (anonimkan data pengguna).
stop	Setelah API ini dipanggil, SDK kami tidak lagi berkomunikasi dengan server kami dan berhenti berfungsi. Berguna saat menerapkan opt-in/opt-out pengguna.
disableSKAdNetwork	Opt-out dari SKAdNetwork.
disableAdvertisingIdentifier	Menonaktifkan pengumpulan berbagai Advertising ID oleh SDK. Ini mencakup Apple Identity for Advertisers (IDFA), Google Advertising ID (GAID), OAID, dan Amazon Advertising ID (AAID).
disableCollectASA	Opt-out dari atribusi Apple Search Ads.
setHost	Atur host kustom.
generateInviteLink	Memungkinkan pengguna lama mengundang teman dan kontak mereka sebagai pengguna baru di aplikasi Anda.
validateAndLogInAppPurchaseAndroid	API untuk verifikasi server pada pembelian dalam aplikasi. Event af_purchase dengan nilai yang relevan akan otomatis tercatat jika validasi berhasil.
validateAndLogInAppPurchaseIos	Lihat definisi di source untuk perilaku saat ini.
getSdkVersion	Dapatkan versi SDK AppsFlyer yang digunakan di aplikasi.
enableFacebookDeferredApplinks	Aktifkan pengumpulan Facebook Deferred AppLinks. Membutuhkan Facebook SDK dan aplikasi Facebook di perangkat target/client. API ini harus dipanggil sebelum menginisialisasi AppsFlyer SDK agar berfungsi dengan benar.
sendPushNotificationData	Ukur dan ambil data dari kampanye push notification.
setCurrentDeviceLanguage	Atur bahasa perangkat. Data akan ditampilkan di Raw Data Reports.
logCrossPromoteImpression	Mencatat impression sebagai bagian dari kampanye cross-promotion. Pastikan menggunakan ID aplikasi yang dipromosikan sesuai yang muncul di dashboard AppsFlyer.
setUserEmails	Atur email pengguna dan enkripsikan email tersebut.
logLocation	Catat lokasi pengguna secara manual.
setPhoneNumber	Akan dikirim sebagai string terenkripsi SHA-256.
setPartnerData	Memungkinkan pengiriman data kustom untuk tujuan integrasi partner.
logInvite	Gunakan untuk mencatat event in-app user-invite (af_invite).
setDisableNetworkData	Gunakan untuk menonaktifkan pengumpulan nama operator jaringan (carrier) dan nama operator SIM dari perangkat.
enableTCFDataCollection	Gunakan untuk mengaktifkan/menonaktifkan pengumpulan data consent secara otomatis bagi pengguna yang memakai CMP. Nilai flag akan tetap tersimpan antar sesi aplikasi.
setConsentData	Gunakan ini untuk mengatur data consent pengguna secara manual. Jika aplikasi Anda tidak menggunakan CMP yang kompatibel dengan TCF v2.2, gunakan metode berikut untuk memberikan data consent langsung ke SDK.
logAdRevenue	Dengan atribusi pendapatan iklan, pemilik aplikasi mendapat gambaran lengkap atas LTV pengguna dan ROI kampanye. Pendapatan iklan dihasilkan dari penayangan iklan di rewarded video, offer wall, interstitial, dan banner dalam aplikasi. Anda dapat menggunakan metode ini untuk mencatat pendapatan iklan Anda.
setConsentDataV2	Gunakan ini untuk mengatur data consent pengguna secara manual. Jika aplikasi Anda tidak menggunakan CMP yang kompatibel dengan TCF v2.2, gunakan metode berikut untuk memberikan data consent langsung ke SDK.
isSDKStarted	Gunakan metode ini untuk mengecek apakah SDK AppsFlyer sudah dijalankan pada sesi saat ini.
isSDKStopped	Gunakan metode ini untuk mengecek apakah SDK AppsFlyer saat ini sudah dihentikan.
disableAppSetId	Menonaktifkan pengumpulan AppSet ID. Jika dipanggil sebelum inisialisasi SDK, App Set ID tidak akan dikumpulkan. Jika dipanggil setelah inisialisasi, App Set ID akan dikumpulkan tetapi tidak dikirim dalam payload request. Hanya untuk Android.
validateAndLogInAppPurchaseV2	API untuk verifikasi server in-app purchase V2. Event af_purchase dengan nilai yang relevan akan otomatis dicatat jika validasi berhasil.

Sumber Kebenaran

Referensi ini disinkronkan dari src/definitions.ts di capacitor-appsflyer.

Lanjutkan dari @capgo/capacitor-appsflyer

Jika Anda menggunakan @capgo/capacitor-appsflyer untuk merencanakan pekerjaan plugin native, hubungkan dengan Menggunakan @capgo/capacitor-appsflyer untuk kapabilitas native saat menggunakan @capgo/capacitor-appsflyer, Direktori Plugin Capgo untuk alur kerja produk di Direktori Plugin Capgo, Plugin Capacitor oleh Capgo untuk detail implementasi pada Capacitor Plugins oleh Capgo Menambahkan atau Memperbarui Plugin untuk detail implementasi di Menambahkan atau Memperbarui Plugin, dan Alternatif Plugin Ionic Enterprise untuk alur kerja produk dalam Alternatif Plugin Ionic Enterprise.