Menyiapkan mode izin untuk aplikasi

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. Anda dapat menerapkan mode izin dengan cara dasar atau lanjutan. Jika Anda tidak yakin apakah akan menerapkan mode izin dasar atau lanjutan, pelajari lebih lanjut mode izin dasar versus lanjutan dan periksa pedoman perusahaan Anda.

Sebelum memulai

Sebelum dapat mengelola izin pengguna, Anda perlu menerapkan:

  • Google Analytics for Firebase SDK

  • Banner setelan izin untuk mencatat izin pengguna

Untuk menyiapkan mode izin, Anda perlu:

  1. Tetapkan status izin default.

Secara default, tidak ada nilai mode izin yang ditetapkan. Guna menetapkan status izin default untuk aplikasi Anda:

  1. Buka file info.plist aplikasi Anda.

  2. Tambahkan pasangan nilai kunci mode izin. Kunci mendeskripsikan jenis izin dan nilai menunjukkan status izin. Nilai dapat berupa true, yang berarti izin diberikan, atau false, yang berarti izin ditolak.

    Sesuai dengan perubahan pada mode izin untuk traffic di Wilayah Ekonomi Eropa (EEA), nilai eu_consent_policy dapat ditetapkan untuk ad_user_data dan ad_personalization, yang berarti izin ditolak hanya untuk pengguna di wilayah yang tunduk pada Kebijakan Izin Pengguna Uni Eropa.

    Tetapkan 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

  3. Simpan perubahan. Selanjutnya, terapkan mekanisme untuk memperbarui nilai izin.

Misalnya, guna menetapkan "berikan semua izin" untuk semua parameter secara default:

<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_ANALYTICS_STORAGE</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_STORAGE</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>

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 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).

Contoh berikut menampilkan metode setConsent yang memperbarui berbagai nilai izin ke granted:

Swift

Analytics.setConsent([
  .analyticsStorage: .granted,
  .adStorage: .granted,
  .adUserData: .granted,
  .adPersonalization: .granted,
])

Objective-C

[FIRAnalytics setConsent:@{
  FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdUserData : FIRConsentStatusGranted,
  FIRConsentTypeAdPersonalization : FIRConsentStatusGranted,
}];

Jika pengguna memutuskan untuk mencabut izinnya, pastikan Anda memperbarui status izin yang sesuai

Sebagai bagian dari komitmen berkelanjutan Google terhadap ekosistem periklanan digital yang menjaga privasi, kami akan memperketat pemberlakuan kebijakan izin pengguna Uni Eropa kami.

Pelajari lebih lanjut Perubahan pada mode izin untuk traffic di Wilayah Ekonomi Eropa (EEA).

Pengguna mode izin harus mengirim dua parameter baru selain penyimpanan iklan dan penyimpanan analisis:

  1. Perbarui info.plist aplikasi Anda untuk menyertakan:

    <key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>

  2. Perbarui panggilan izin Anda guna menyertakan parameter untuk data pengguna iklan dan personalisasi iklan:

    Swift

    Analytics.setConsent([
.analyticsStorage: .granted,
.adStorage: .granted,
.adUserData: .granted,
.adPersonalization: .granted,
])

    Objective-C

    [FIRAnalytics setConsent:@{
  FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdUserData : FIRConsentStatusGranted,
  FIRConsentTypeAdPersonalization : FIRConsentStatusGranted,
}];

Anda dapat memverifikasi bahwa setelan izin Anda berfungsi sebagaimana mestinya dengan melihat konsol debug Xcode untuk aplikasi Anda.

Ikuti langkah-langkah berikut:

  1. Aktifkan logging panjang di perangkat Anda.

  2. Di konsol debug Xcode, cari:

    • ad_storage
    • analytics_storage
    • ad_user_data
    • ad_personalization

    Misalnya, jika penyimpanan Iklan diaktifkan, Anda akan melihat pesan berikut:

    ad_storage is granted.