Bu sayfa, uygulamalarında Firebase için Google Analytics SDK'sını kullanan ve izin modunu entegre etmek isteyen geliştiricilere yöneliktir. İzin moduna giriş için İzin moduna genel bakış bölümünü okuyun.
Google Analytics, kullanıcılarınızın izin durumuna göre SDK'nızın nasıl davranacağını belirlemek için izin modu sunar. İzin modunu temel veya gelişmiş şekilde uygulayabilirsiniz. Temel veya gelişmiş izin modunu mu uygulayacağınızdan emin değilseniz temel ve gelişmiş izin modu hakkında daha fazla bilgi edinin ve şirketinizin yönergelerini inceleyin.
Başlamadan önce
Kullanıcı rızasını yönetebilmeniz için şunları uygulamanız gerekir:
- Firebase için Google Analytics SDK'sı
Kullanıcı iznini yakalamak için izin ayarları banner'ı
İzin modunu ayarlama
İzin modunu ayarlamak için şunları yapmanız gerekir:
Varsayılan izin durumunu ayarlama
Varsayılan olarak herhangi bir izin modu değeri ayarlanmaz. Uygulamanızın varsayılan izin durumunu ayarlamak için:
- Uygulamanızın AndroidManifest.xml dosyasını açın.
İzin modu anahtar/değer çiftlerini ekleyin. Anahtar, izin türünü, değer ise izin durumunu belirtir. Değerler, izin verildiği anlamına gelen
true
veya iznin reddedildiği anlamına gelenfalse
olabilir.Avrupa Ekonomik Alanı'ndaki (AEA) trafik için izin modunda yapılan güncellemelere uygun şekilde,
ad_user_data
vead_personalization
içineu_consent_policy
değeri ayarlanabilir. Bu, iznin yalnızca AB Kullanıcı Rızası Politikası'na tabi bölgelerdeki kullanıcılar için reddedildiği anlamına gelir.Aşağıdakileri ayarlayın:
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
Değişikliklerinizi kaydedin. Ardından, izin değerlerini güncelleme mekanizmasını uygulayın.
Örneğin, varsayılan olarak tüm parametreler için tüm izin izinlerini ayarlamak üzere:
<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" />
İzni güncelle
Uygulama kullanıma sunulduktan sonra izin değerlerini güncellemek için setConsent
yöntemini çağırın.
setConsent
yöntemi tarafından ayarlanan değer, varsayılan ayarı geçersiz kılar ve uygulama yürütmelerinde geçerliliğini korur. Değer, bir kullanıcı uygulamayı kapatıp yeniden açsa bile setConsent
tekrar çağrılana kadar bu durumda kalır. setConsent
yalnızca belirttiğiniz parametreleri günceller.
Bir kullanıcı Analytics veya reklam depolama alanı için önceden verdiği izni geri çekerse Google Analytics,
ad_personalization
izni de dahil olmak üzere tüm kullanıcı mülklerini siler. Kullanıcının reklam kişiselleştirmeyle ilgili rıza seçimini korumak içinsetConsent
(Kotlin+KTX | Java) kullanarak reklam kişiselleştirmede kullanılan önceki değeri geri yükleyin.
Aşağıdaki örnekte, farklı izin değerlerini granted
olarak güncelleyen setConsent
yöntemi gösterilmektedir:
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)
}