Halaman ini ditujukan untuk developer yang menggunakan Google Analytics for Firebase SDK di aplikasi mereka dan ingin mengintegrasikan mode izin. Untuk mempelajari pengantar mode izin, baca artikel Ringkasan mode izin.
Google Analytics menawarkan mode izin untuk menyesuaikan perilaku SDK Anda berdasarkan status izin pengguna. Lihat jenis izin untuk semua parameter yang tersedia.
Sebelum memulai
Sebelum dapat mengelola izin pengguna, Anda perlu menerapkan:
- Google Analytics for Firebase SDK
Banner setelan izin untuk mencatat izin pengguna
Menyiapkan mode izin
Untuk menyiapkan mode izin, Anda perlu:
- Menetapkan izin default.
- Memperbarui status izin berdasarkan interaksi pengguna dengan setelan izin Anda.
Langkah 1: Tetapkan izin default
Secara default, tidak ada nilai mode izin yang ditetapkan. Guna menetapkan status izin default untuk aplikasi Anda:
- Buka file AndroidManifest.xml aplikasi Anda.
Tambahkan pasangan nilai kunci mode izin. Kunci mendeskripsikan jenis izin dan nilai menunjukkan status izin. Nilai dapat berupa
true
, yang berarti izin diberikan, ataufalse
, yang berarti izin ditolak. Tetapkan nilai berikut ini:google_analytics_default_allow_analytics_storage
google_analytics_default_allow_ad_storage
google_analytics_default_allow_ad_user_data
google_analytics_default_allow_ad_personalization_signals
Simpan perubahan. Selanjutnya, terapkan mekanisme untuk memperbarui nilai izin.
Misalnya, guna menetapkan "berikan semua izin" untuk semua parameter secara default:
<meta-data android:name="google_analytics_default_allow_analytics_storage" android:value="true" />
<meta-data android:name="google_analytics_default_allow_ad_storage" android:value="true" />
<meta-data android:name="google_analytics_default_allow_ad_user_data" android:value="true" />
<meta-data android:name="google_analytics_default_allow_ad_personalization_signals" android:value="true" />
Langkah 2: Perbarui izin
Untuk memperbarui nilai izin setelah aplikasi diluncurkan, panggil metode setConsent
.
Nilai yang ditetapkan oleh metode setConsent
akan menggantikan setelan default dan akan tetap ada di seluruh eksekusi aplikasi. Nilai tersebut akan tetap memiliki status tersebut hingga setConsent
dipanggil lagi, bahkan jika pengguna menutup dan membuka kembali aplikasi. setConsent
hanya akan memperbarui parameter yang Anda tentukan.
Jika pengguna membatalkan izin yang diberikan sebelumnya untuk penyimpanan Analisis 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 menggunakansetConsent
(Kotlin+KTX | Java).
Contoh berikut menampilkan metode setConsent
yang memperbarui berbagai nilai izin ke granted
:
Java
// Set consent types.
Map<ConsentType, ConsentStatus> consentMap = new EnumMap<>(ConsentType.class);
consentMap.put(ConsentType.ANALYTICS_STORAGE, ConsentStatus.GRANTED);
consentMap.put(ConsentType.AD_STORAGE, ConsentStatus.GRANTED);
consentMap.put(ConsentType.AD_USER_DATA, ConsentStatus.GRANTED);
consentMap.put(ConsentType.AD_PERSONALIZATION, ConsentStatus.GRANTED);
mFirebaseAnalytics.setConsent(consentMap);
Kotlin
Firebase.analytics.setConsent {
analyticsStorage(ConsentStatus.GRANTED)
adStorage(ConsentStatus.GRANTED)
adUserData(ConsentStatus.GRANTED)
adPersonalization(ConsentStatus.GRANTED)
}
Mengupgrade ke mode izin v2
Sebagai bagian dari komitmen berkelanjutan Google terhadap ekosistem periklanan digital yang menjaga privasi, kami akan memperketat pemberlakuan kebijakan izin pengguna Uni Eropa kami.
Pengguna mode izin harus mengirim dua parameter baru selain penyimpanan iklan dan penyimpanan analisis:
Perbarui AndroidManifest.xml aplikasi Anda untuk menyertakan:
<meta-data android:name="google_analytics_default_allow_ad_user_data" android:value="true" /> <meta-data android:name="google_analytics_default_allow_ad_personalization_signals" android:value="true" />
Perbarui panggilan izin Anda guna menyertakan parameter untuk data pengguna iklan dan personalisasi iklan:
Java
// Set consent types. Map<ConsentType, ConsentStatus> consentMap = new EnumMap<>(ConsentType.class); consentMap.put(ConsentType.ANALYTICS_STORAGE, ConsentStatus.GRANTED); consentMap.put(ConsentType.AD_STORAGE, ConsentStatus.GRANTED); consentMap.put(ConsentType.AD_USER_DATA, ConsentStatus.GRANTED); consentMap.put(ConsentType.AD_PERSONALIZATION, ConsentStatus.GRANTED); mFirebaseAnalytics.setConsent(consentMap);
Kotlin
Firebase.analytics.setConsent { analyticsStorage(ConsentStatus.GRANTED) adStorage(ConsentStatus.GRANTED) adUserData(ConsentStatus.GRANTED) adPersonalization(ConsentStatus.GRANTED) }
Memverifikasi setelan izin
Anda dapat memverifikasi bahwa setelan izin berfungsi sebagaimana mestinya dengan melihat pesan log untuk aplikasi Anda.
Ikuti langkah-langkah berikut:
- Aktifkan logging panjang di perangkat Anda.
Di logcat Android Studio, temukan pesan log yang diawali dengan
Setting consent
. Misalnya, jika penyimpanan Iklan saat ini diaktifkan, Anda akan melihat pesan log berikut:Setting consent, ... AD_STORAGE=granted