Mengonfigurasi pengumpulan dan penggunaan data Analytics

iOS+ Android

Catatan: Jika Anda menggunakan Unity SDK, pilih opsi platform di atas (iOS+ atau Android) untuk target build Anda.

Halaman ini menjelaskan fitur yang ditawarkan Google Analytics yang memungkinkan Anda mengontrol pengumpulan dan penggunaan data Analytics.

Analytics menonaktifkan pengumpulan data

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 menawarkan beberapa opsi untuk menghentikan dan menonaktifkan pengumpulan 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];

Unity

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

Jika perlu menangguhkan lagi pengumpulan data karena suatu alasan, Anda dapat memanggil metode berikut dan pengumpulan data akan ditangguhkan hingga Anda mengaktifkannya kembali.

Swift

Catatan: Produk Firebase ini tidak tersedia di target macOS.

Analytics.setAnalyticsCollectionEnabled(false)

Objective-C

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

Unity

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(false);

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 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 dalam dokumentasi Apple lebih lanjut:

• 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 menjadi NO (Boolean) dalam file Info.plist pada aplikasi.

Mengontrol pengumpulan data untuk 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.

Anda dapat mengontrol secara terprogram apakah data Analytics pengguna harus digunakan untuk iklan yang dipersonalisasi menggunakan salah satu opsi berikut:

• Direkomendasikan: Mengaktifkan atau menonaktifkan personalisasi iklan secara dinamis dengan mematuhi pilihan izin pengguna. Menerapkan API mode izin Google.

• Mengaktifkan atau menonaktifkan personalisasi iklan di tingkat pengguna: Mengontrol personalisasi iklan sebagai properti pengguna.

• Mengaktifkan atau menonaktifkan personalisasi iklan di tingkat properti Analytics: Menonaktifkan personalisasi iklan per wilayah geografis di properti Analytics Anda.

Menonaktifkan fitur iklan yang dipersonalisasi melalui properti pengguna

API mode izin Google adalah cara yang direkomendasikan untuk mengaktifkan dan menonaktifkan iklan yang dipersonalisasi.

Namun, jika aplikasi Anda belum menggunakan mode izin, Anda dapat mengontrol personalisasi dengan opsi berikut.

Untuk menonaktifkan 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.

Catatan: Dalam situasi tertentu, Google dapat menonaktifkan personalisasi iklan 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 berusia di bawah persyaratan usia yang berlaku sesuai dengan kebijakan periklanan kami).

Mengaktifkan kembali fitur iklan yang dipersonalisasi melalui properti pengguna

Jika menggunakan parameter AnalyticsUserPropertyAllowAdPersonalizationSignals untuk mengontrol personalisasi iklan, Anda dapat mengaktifkan kembali personalisasi iklan dengan 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];

Unity

Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, true);

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];

Unity

Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, ...);
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

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 pengguna membatalkan izin yang diberikan sebelumnya untuk penyimpanan Analytics atau Iklan, Google Analytics akan menghapus semua properti pengguna, termasuk izin untuk ad personalization. Guna mempertahankan pilihan izin pengguna untuk personalisasi iklan, pulihkan nilai sebelumnya untuk personalisasi iklan menggunakan setConsent (Swift | Obj-C) .

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.