Apa yang ditambahkan Facebook SDK v19 ke app event Anda, dan cara mematikannya
Terakhir diperbarui 17 November 2026
Apa yang ditambahkan
Mulai Facebook SDK v19, SDK native menambahkan konteks ke setiap app event yang Anda catat. Fitur ini aktif secara default, dan tidak bergantung pada AutoLogAppEventsEnabled.
- Judul layar. Judul layar tempat event dicatat.
- URL masuk. URL yang terakhir membuka aplikasi, lengkap dengan query string-nya. Meta menyebutnya "AppLink URL", tetapi tidak terbatas pada App Links. Ini adalah URL apa pun yang membuka atau melanjutkan aplikasi: deep link dengan skema khusus, dan callback OAuth atau magic link yang membawa kode atau token.
- URL keluar, hanya iOS. URL terakhir yang dibuka oleh aplikasi itu sendiri, dengan skema apa pun, misalnya lewat
url_launcher.
URL masuk adalah yang perlu Anda perhatikan. Kalau alur login Anda kembali lewat deep link, link itu beserta parameternya yang dipegang oleh SDK.
Di mana disimpan, dan kapan keluar dari perangkat
Kedua URL disimpan di perangkat, di UserDefaults pada iOS dan SharedPreferences pada Android. Keduanya bertahan antar pembukaan aplikasi sampai URL yang lebih baru menimpanya.
Keduanya keluar dari perangkat hanya sebagai lampiran event yang dicatat. Tidak ada event, tidak ada pengiriman. Tetapi event berikutnya yang Anda catat membawa URL apa pun yang tersimpan saat itu.
Di Android, menunda inisialisasi tidak menunda ini
Di iOS, pengumpulan ini dipasang sebagai bagian dari inisialisasi SDK. Kalau Anda menunda inisialisasi sampai ada persetujuan, pengumpulan ini ikut tertahan.
Di Android tidak. Perekaman URL masuk disiapkan saat SDK dimuat ketika proses dimulai, dan itu tetap terjadi dengan com.facebook.sdk.AutoInitEnabled bernilai false. URL masuk ditulis ke disk sebelum alur persetujuan Anda berjalan. Perekaman di Android hanya memeriksa key manifest di bawah, bukan pengaturan di Events Manager.
Mematikannya
Atur key konfigurasi milik SDK menjadi false:
<!-- ios/Runner/Info.plist -->
<key>FBSDKAutoLogMetaDataEnabled</key>
<false/><!-- android/app/src/main/AndroidManifest.xml, under <application> -->
<meta-data android:name="com.facebook.sdk.AutoLogMetaDataEnabled" android:value="false"/>Anda juga bisa mematikan "Automatically include more app event details" di Events Manager. Itu menghentikan pemakaian datanya. Itu tidak menghentikan perekaman di perangkat pada Android yang dijelaskan di atas, jadi jangan mengandalkan itu saja.
Mengaktifkannya setelah persetujuan
Key statis tidak bisa berubah setelah pengguna setuju. Untuk itu, panggil setAutoLogMetaDataEnabled dari Dart. Nilainya tersimpan antar pembukaan aplikasi dan lebih diutamakan daripada key di manifest atau Info.plist.
// Key native bernilai false, jadi tidak ada yang direkam sebelum persetujuan.
await facebookAppEvents.initializeSdk();
await facebookAppEvents.setAutoLogMetaDataEnabled(true);Mengaktifkannya berlaku tanpa membuka ulang aplikasi, meski tidak seketika. Android membaca flag ini saat activity berikutnya dimulai atau dilanjutkan. iOS memasang pengumpulnya setelah SDK mengambil pengaturannya dari Meta.
Mematikannya juga menghapus URL yang sudah disimpan SDK di perangkat. Di iOS, panggil setelah initializeSdk(), sama seperti pengaturan lainnya.
Satu key lagi yang datang bersama v19
SDK v19 juga menambahkan AutoLogProductImprovementEnabled, untuk data diagnostik. Meta menyatakan SDK belum mengumpulkan atau mengirim data ini. Key tersebut hanya memungkinkan Anda menolak lebih awal. Plugin tidak menyediakannya di Dart, jadi atur secara native: FBSDKAutoLogProductImprovementEnabled di Info.plist, dan com.facebook.sdk.AutoLogProductImprovementEnabled di manifest Android.
Periksa pengaturan Anda
- Anda tahu URL mana saja yang membuka aplikasi Anda, dan apakah ada yang membawa kode atau token
- FBSDKAutoLogMetaDataEnabled di Info.plist dan com.facebook.sdk.AutoLogMetaDataEnabled di AndroidManifest.xml diatur sesuai kebijakan privasi Anda
- Di Android, key manifest bernilai false kalau tidak boleh ada yang disimpan sebelum persetujuan, meskipun inisialisasi ditunda
- setAutoLogMetaDataEnabled(true) dipanggil hanya setelah persetujuan, dan setelah initializeSdk() di iOS
- Anda tidak hanya mengandalkan pengaturan Events Manager untuk menghentikan pengumpulan di perangkat
Dokumentasi referensi Meta
Referensi API plugin
Masih terhambat?
Ini defek pada plugin
Jika plugin melakukan sesuatu yang tidak dilakukan Facebook SDK native, itu bug kami. Buka issue dan kami perbaiki. Gratis, selalu, tanpa syarat.
Buka issue di GitHubIni pertanyaan soal penggunaan
Pertanyaan soal konfigurasi dan integrasi paling baik diajukan di tempat yang bisa ditemukan developer lain nanti.
Tanya di StackOverflowAngka Anda salah dan ada uang yang bergerak
Jika kampanye instalasi Meta terus mengeluarkan biaya dan atribusinya tidak sesuai, itu masalah yang berbeda dari build yang rusak. Semuanya dimulai dengan panggilan gratis 20 menit. Panggilan diagnostik satu jam, 300 USD dan dikreditkan ke biaya audit, menyusul jika memang layak.
Lihat panggilan diagnostik dan audit