获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

Konfigurasikan pengumpulan dan penggunaan data Analytics

Google Analytics menawarkan fitur yang memungkinkan Anda mengontrol pengumpulan dan penggunaan data Analytics.

Nonaktifkan pengumpulan data Analytics

Dalam beberapa kasus, Anda mungkin ingin menonaktifkan pengumpulan data Analytics untuk sementara atau permanen, seperti untuk mengumpulkan persetujuan pengguna akhir atau untuk memenuhi kewajiban hukum. Google Analytics menawarkan beberapa opsi untuk menonaktifkan dan menonaktifkan koleksi Analytics. Digunakan bersama, mereka mendukung banyak kasus penggunaan tipikal.

Nonaktifkan sementara koleksi

Jika Anda ingin menonaktifkan pengumpulan Analytics untuk sementara, seperti untuk mendapatkan persetujuan pengguna akhir sebelum mengumpulkan data, Anda dapat menyetel nilai FIREBASE_ANALYTICS_COLLECTION_ENABLED ke NO (Boolean) di file Info.plist aplikasi Anda. Misalnya, dilihat dalam XML sumber:

<key>FIREBASE_ANALYTICS_COLLECTION_ENABLED</key>
<false/>

Untuk mengaktifkan kembali pengumpulan, seperti setelah pengguna akhir memberikan izin, panggil metode instance setAnalyticsCollectionEnabled dari Analytics . Sebagai contoh:

Cepat

Catatan: Produk Firebase ini tidak tersedia di target macOS.
Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

Catatan: Produk Firebase ini tidak tersedia di target macOS.
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Jika Anda perlu menangguhkan pengumpulan lagi karena alasan apa pun, Anda dapat menelepon

Cepat

Catatan: Produk Firebase ini tidak tersedia di target macOS.
Analytics.setAnalyticsCollectionEnabled(false)

Objective-C

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

dan pengumpulan ditangguhkan hingga Anda mengaktifkannya kembali. Nilai yang disetel oleh metode setAnalyticsCollectionEnabled tetap ada di seluruh eksekusi aplikasi dan menggantikan nilai untuk FIREBASE_ANALYTICS_COLLECTION_ENABLED di file Info.plist aplikasi Anda. Setelah Anda menetapkan nilai untuk setAnalyticsCollectionEnabled , kumpulan Analytics tetap dalam status tersebut hingga setAnalyticsCollectionEnabled dipanggil lagi, meskipun pengguna menutup dan membuka kembali aplikasi Anda.

Nonaktifkan koleksi secara permanen

Jika Anda perlu menonaktifkan koleksi Analytics secara permanen di versi aplikasi Anda, setel FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED ke YES (Boolean) di Info.plist file aplikasi Anda. Menyetel FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED ke YES (Boolean) lebih diprioritaskan daripada nilai apa pun untuk FIREBASE_ANALYTICS_COLLECTION_ENABLED di Info.plist aplikasi Anda serta semua nilai yang disetel dengan setAnalyticsCollectionEnabled .

Untuk mengaktifkan kembali koleksi, hapus FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED dari Info.plist Anda. Menyetel FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED ke NO (Boolean) tidak berpengaruh dan menghasilkan perilaku yang sama seperti tidak memiliki FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED yang disetel di file Info.plist Anda.

Nonaktifkan koleksi IDFA

Jika Anda menginstal Firebase melalui CocoaPods dengan menambahkan pod 'Firebase/Analytics' ke Podfile aplikasi Anda dan ingin menonaktifkan pengumpulan IDFA (pengidentifikasi iklan perangkat) di aplikasi Apple Anda, pastikan kerangka kerja AdSupport tidak disertakan dalam aplikasi Anda.

Untuk menginstal Firebase tanpa kemampuan pengumpulan IDFA, gunakan subspesifikasi berikut sebagai pengganti pod 'Firebase/Analytics' :

pod 'Firebase/AnalyticsWithoutAdIdSupport'

Pelajari lebih lanjut tentang IDFA dalam dokumentasi Apple:

Nonaktifkan koleksi IDFV

Jika Anda ingin menonaktifkan pengumpulan IDFV (Identifier untuk Vendor) di aplikasi Apple Anda, setel nilai GOOGLE_ANALYTICS_IDFV_COLLECTION_ENABLED ke NO (Boolean) di file Info.plist aplikasi Anda.

Konfigurasikan penggunaan data Analytics

Nonaktifkan fitur iklan yang dipersonalisasi

Jika Anda telah menautkan proyek Google Analytics ke akun iklan atau mengaktifkan integrasi iklan, atau ikut serta dalam berbagi data , data Analytics Anda mungkin memenuhi syarat untuk digunakan dalam iklan yang dipersonalisasi. Artinya, misalnya, Anda dapat menggunakan peristiwa yang dikumpulkan seperti first_open untuk membuat dan menerapkan daftar audiens untuk pemasaran ulang, kecuali jika Anda menunjukkan bahwa data tersebut tidak tersedia untuk iklan yang dipersonalisasi.

Untuk mengontrol secara terprogram apakah data Analytics pengguna harus digunakan untuk iklan yang dipersonalisasi, tetapkan perilaku default yang sesuai di file AndroidManifest.xml aplikasi, lalu gunakan metode yang dijelaskan di bawah untuk mengganti perilaku default tersebut.

Untuk menyetel perilaku iklan yang dipersonalisasi default, setel nilai GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS ke NO (Boolean) di file Info.plist aplikasi Anda.

Anda juga dapat mengontrol apakah data yang dikumpulkan dari pengguna akhir dapat digunakan untuk personalisasi iklan melalui setelan personalisasi iklan , yang terdapat di setelan Properti Google Analytics.

Aktifkan kembali fitur iklan yang dipersonalisasi

Untuk mengaktifkan kembali fitur iklan yang dipersonalisasi untuk pengguna saat run-time, seperti setelah pengguna akhir memberikan persetujuan, gunakan metode setUserProperty seperti yang ditunjukkan di bawah ini:

Cepat

Catatan: Produk Firebase ini tidak tersedia di target macOS.
Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)

Objective-C

Catatan: Produk Firebase ini tidak tersedia di target macOS.
[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];

Jika Anda telah memilih untuk menonaktifkan sementara pengumpulan analitik (misalnya, hingga pengguna akhir memberikan persetujuan), dan Anda ingin mengontrol fitur iklan yang dipersonalisasi setelah mengaktifkan kembali pengumpulan analitik untuk pengguna, pastikan panggilan Anda untuk menentukan setelan ini mendahului Anda panggilan untuk mengaktifkan kembali pengumpulan analitik. Sebagai contoh:

Cepat

Catatan: Produk Firebase ini tidak tersedia di target macOS.
Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

Catatan: Produk Firebase ini tidak tersedia di target macOS.
[FIRAnalytics setUserPropertyString:... forName:kFIRUserPropertyAllowAdPersonalizationSignals];
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Konfirmasikan pengaturan Anda

Saat sinyal personalisasi iklan telah dinonaktifkan untuk pengguna melalui salah satu mekanisme yang ditentukan di atas, bundel peristiwa berikutnya yang dicatat dari perangkat pengguna tersebut akan berisi properti pengguna bernama "non_personalized_ads" dengan nilai 1 untuk menunjukkan bahwa peristiwa dalam bundel tersebut tidak tersedia untuk iklan yang dipersonalisasi. Menonaktifkan iklan yang dipersonalisasi tidak memengaruhi penggunaan data untuk tujuan pengukuran, termasuk pelaporan dan atribusi.

Lihat perubahan konfigurasi Anda

Setelah Anda membuat perubahan pada setelan Google Analytics, SDK mengunduh perubahan tersebut. Prosesnya cepat dan mulus, sehingga Anda dapat dengan cepat menguji perubahan Anda. Saat Anda membuat perubahan di Analytics, mungkin perlu beberapa menit untuk diterapkan di aplikasi Anda. Jika aplikasi Anda aktif, proses penerapan penuh mungkin memerlukan waktu hingga satu jam untuk diselesaikan.