Catch up on everthing we announced at this year's Firebase Summit. Learn more

Mengonfigurasi Pengumpulan dan Penggunaan Data Analytics

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

Menonaktifkan pengumpulan data Analytics

Pada beberapa kasus, Anda mungkin ingin menonaktifkan pengumpulan data Analytics untuk sementara atau secara permanen, misalnya untuk mengumpulkan persetujuan pengguna akhir atau memenuhi kewajiban hukum. Google Analytics menyediakan beberapa opsi untuk menghentikan dan menonaktifkan pengumpulan data Analytics. Jika digunakan bersamaan, opsi tersebut mendukung banyak kasus penggunaan standar.

Menonaktifkan pengumpulan data untuk sementara

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

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

Untuk mengaktifkan kembali pengumpulan data, misalnya setelah pengguna akhir memberikan izin, panggil metode instance setAnalyticsCollectionEnabled pada Analytics. Contoh:

Swift

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 perlu menangguhkan lagi pengumpulan data karena suatu alasan, Anda dapat memanggil

Swift

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

Objective-C

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

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

Menonaktifkan pengumpulan data secara permanen

Jika perlu menonaktifkan pengumpulan data Analytics secara permanen di suatu versi aplikasi Anda, tetapkan FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED menjadi YES (Boolean) di file Info.plist pada aplikasi. Penetapan FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED menjadi YES (Boolean) diprioritaskan dibandingkan nilai lain untuk FIREBASE_ANALYTICS_COLLECTION_ENABLED di Info.plist aplikasi Anda serta nilai lain yang ditetapkan dengan setAnalyticsCollectionEnabled.

Untuk mengaktifkan kembali pengumpulan data, hapus FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED dari Info.plist. Penetapan FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED menjadi NO (Boolean) tidak menimbulkan dampak apa pun dan menghasilkan perilaku yang sama seperti jika FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED belum ditetapkan dalam file Info.plist Anda.

Menonaktifkan pengumpulan IDFA

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

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

pod 'Firebase/AnalyticsWithoutAdIdSupport'

Pelajari IDFA dalam dokumentasi Apple lebih lanjut:

Menonaktifkan pengumpulan IDFV

Jika ingin menonaktifkan pengumpulan IDFV (Identifier for Vendor) di aplikasi Apple, tetapkan nilai GOOGLE_ANALYTICS_IDFV_COLLECTION_ENABLED ke NO (Boolean) dalam file Info.plist pada aplikasi.

Mengonfigurasi penggunaan data Analytics

Menonaktifkan fitur iklan yang dipersonalisasi

Jika Anda telah menautkan project Google Analytics ke akun iklan atau mengaktifkan integrasi iklan, atau memilih ikut berbagi data, data Analytics Anda mungkin memenuhi syarat untuk digunakan dalam iklan yang dipersonalisasi. Ini berarti, misalnya, Anda dapat menggunakan peristiwa yang dikumpulkan seperti first_open untuk membuat dan men-deploy daftar audiens untuk pemasaran ulang, kecuali jika Anda mengisyaratkan 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 pada aplikasi, lalu gunakan metode yang dijelaskan di bawah untuk mengganti perilaku default tersebut.

Untuk menetapkan perilaku iklan yang dipersonalisasi secara default, tetapkan nilai GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS menjadi NO (Boolean) di file Info.plist pada aplikasi.

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

Mengaktifkan kembali fitur iklan yang dipersonalisasi

Guna mengaktifkan kembali fitur iklan yang dipersonalisasi untuk pengguna saat runtime, misalnya setelah pengguna akhir memberikan izin, gunakan metode setUserProperty seperti yang ditunjukkan di bawah:

Swift

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 memilih menonaktifkan pengumpulan data Analytics untuk sementara (misalnya, hingga pengguna akhir memberikan persetujuan) dan ingin mengontrol fitur iklan yang dipersonalisasi saat mengaktifkan kembali pengumpulan data Analytics untuk pengguna, pastikan bahwa panggilan untuk menentukan setelan ini mendahului panggilan untuk mengaktifkan kembali pengumpulan data Analytics. Contoh:

Swift

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

Objective-C

[FIRAnalytics setUserPropertyString:... forName:kFIRUserPropertyAllowAdPersonalizationSignals];
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Mengonfirmasi setelan

Ketika sinyal personalisasi iklan telah dinonaktifkan untuk pengguna melalui salah satu mekanisme yang dijelaskan di atas, paket peristiwa berikutnya yang dimasukkan ke log dari perangkat pengguna tersebut akan berisi properti pengguna bernama "non_personalized_ads" bernilai 1 yang mengisyaratkan bahwa peristiwa dalam paket tersebut tidak tersedia untuk iklan yang dipersonalisasi. Menonaktifkan iklan yang dipersonalisasi tidak memengaruhi penggunaan data untuk tujuan pengukuran, termasuk pelaporan dan atribusi.