Mengonfigurasi pengumpulan dan penggunaan data Analytics

iOS+ Android

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

Menonaktifkan pengumpulan data Analytics

Terkadang, Anda mungkin ingin menonaktifkan pengumpulan data Analytics untuk sementara atau secara permanen, misalnya untuk mengumpulkan izin 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 Anda ingin menonaktifkan pengumpulan data Analytics untuk sementara, seperti untuk mendapatkan persetujuan pengguna akhir sebelum mengumpulkan data, Anda dapat menetapkan nilai FIREBASE_ANALYTICS_COLLECTION_ENABLED ke 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 data 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 ke YES (Boolean) di Info.plist file pada aplikasi. Penetapan FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED ke YES (Boolean) diprioritaskan dibandingkan nilai apa pun untuk FIREBASE_ANALYTICS_COLLECTION_ENABLED di Info.plist pada aplikasi Anda serta nilai apa pun yang ditetapkan dengan setAnalyticsCollectionEnabled.

Untuk mengaktifkan kembali pengumpulan data, hapus FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED dari Info.plist Anda. Penetapan FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED ke NO (Boolean) tidak akan 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 lebih lanjut di dokumentasi Apple:

• User Privacy and Data Use (Privasi Pengguna dan Penggunaan Data)
• App Tracking Transparency (Transparansi Pelacakan Aplikasi)

Menonaktifkan pengumpulan IDFV

Jika Anda 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 ke NO (Boolean) di file Info.plist pada aplikasi Anda.

Anda juga dapat mengontrol apakah data yang dikumpulkan dari pengguna akhir dapat digunakan untuk personalisasi iklan melalui setelan personalisasi iklan, yang ada di setelan Properti 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

Catatan: Produk Firebase ini tidak tersedia di target macOS.

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

Catatan: Dalam keadaan tertentu, Google dapat menonaktifkan iklan yang dipersonalisasi untuk data Analytics yang dikumpulkan dari pengguna akhir, meskipun Anda belum melakukannya, jika Google memiliki informasi bahwa pengguna akhir tersebut tidak memenuhi syarat untuk iklan yang dipersonalisasi (misalnya, pengguna akhir di perangkat Android masih di bawah umur, sebagaimana diatur dalam kebijakan periklanan kami).

Mengonfirmasi setelan Anda

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.

Catatan: Jika izin untuk Analytics atau Penyimpanan iklan berubah menjadi DENIED, Google Analytics akan menghapus semua properti pengguna, termasuk non_personalized_ads (yang mencatat apakah data analisis pengguna dapat digunakan dalam iklan yang dipersonalisasi). Jika aplikasi Anda menggunakan setConsent (Swift | Obj-C) untuk mengubah setelan izin penyimpanan, aplikasi Anda harus melakukannya setelahnya mereset non_personalized_ads ke setelan sebelumnya.

Melihat perubahan konfigurasi

Setelah Anda membuat perubahan pada setelan Google Analytics, SDK akan mendownload perubahan tersebut. Proses ini cepat dan lancar, sehingga Anda dapat menguji perubahan dengan cepat. Saat Anda membuat perubahan di Analytics, mungkin perlu waktu beberapa menit untuk men-deploy-nya di aplikasi Anda. Jika aplikasi Anda sudah aktif, proses deployment lengkap mungkin akan memakan waktu hingga satu jam.