Mengelola setelan izin (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. Lihat jenis izin untuk semua parameter yang tersedia.

iOS Android

Penting: Mode izin untuk aplikasi telah diperbarui pada 30 Oktober 2023 dan sekarang berisi dua parameter tambahan. Jika Anda sudah menggunakan mode izin, upgrade ke mode izin v2.

Sebelum memulai

Sebelum dapat mengelola izin pengguna, Anda perlu menerapkan:

• Google Analytics for Firebase SDK

• Banner setelan izin untuk mencatat izin pengguna

  Tips: Jika Anda tidak ingin menerapkan sendiri setelan izin, pertimbangkan untuk menggunakan platform pengelolaan izin (CMP).

Menyiapkan mode izin

Untuk menyiapkan mode izin, Anda perlu:

1. Menetapkan izin default.
2. 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:

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

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/>

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

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:

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

Memverifikasi setelan izin

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.