Bu sayfa, uygulamalarında Firebase için Google Analytics SDK'sını kullanan ve izin modunu entegre etmek isteyen geliştiriciler içindir. İzin moduna giriş için İzin moduna genel bakış başlıklı makaleyi inceleyin.
Google Analytics, SDK'nızın davranış şeklini kullanıcılarınızın izin durumuna göre ayarlamak 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ı iznini yönetebilmek 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, izin modu değeri ayarlanmaz. Uygulamanız için varsayılan izin durumunu ayarlamak üzere:
- Uygulamanızın info.plist 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 anlamına gelen
true
veya izin reddedildi 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 durumda, izin yalnızca AB Kullanıcı Rızası Politikası'na tabi bölgelerdeki kullanıcılar için reddedilir.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:
<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/>
İ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 çalıştırmalarında devam eder. Kullanıcı uygulamayı kapatıp yeniden açsa bile setConsent
yeniden çağrılana kadar değer bu durumda kalır. setConsent
yalnızca belirttiğiniz parametreleri günceller.
Bir kullanıcı daha önce Analytics veya reklam depolama için verdiği izni geri çekerse Google Analytics,
ad_personalization
izni de dahil olmak üzere tüm kullanıcı özelliklerini siler. Kullanıcının reklam kişiselleştirmeyle ilgili izin seçimini korumak içinsetConsent
(Swift | Obj-C) kullanarak reklam kişiselleştirmenin önceki değerini geri yükleyin.
Aşağıdaki örnekte farklı izin değerlerini granted
olarak güncelleyen setConsent
yöntemi gösterilmektedir:
Swift
Analytics.setConsent([
.analyticsStorage: .granted,
.adStorage: .granted,
.adUserData: .granted,
.adPersonalization: .granted,
])
Objective-C
[FIRAnalytics setConsent:@{
FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted,
FIRConsentTypeAdStorage : FIRConsentStatusGranted,
FIRConsentTypeAdUserData : FIRConsentStatusGranted,
FIRConsentTypeAdPersonalization : FIRConsentStatusGranted,
}];
Bir kullanıcı iznini iptal etmeye karar verirse izin durumlarını buna göre güncellediğinizden
İzin modu v2'ye yükseltin
Google'ın gizlilik açısından güvenli dijital reklamcılık ekosistemine yönelik devam eden taahhüdü kapsamında, AB kullanıcı rızası politikamızın yaptırımını daha sıkı hale getiriyoruz.
Google'ın Avrupa Ekonomik Alanı'ndaki (AEA) trafik için izin modu güncellemeleri hakkında daha fazla bilgi edinin.
İzin modu kullanıcılarının reklam depolama ve Analytics depolama alanına ek olarak iki yeni parametre göndermesi gerekir:
Uygulamanızın info.plist dosyasını aşağıdakileri içerecek şekilde güncelleyin:
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/> <key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>
İzin çağrılarınızı, reklam kullanıcı verileri ve reklam kişiselleştirme parametrelerini içerecek şekilde güncelleyin:
Swift
Analytics.setConsent([ .analyticsStorage: .granted, .adStorage: .granted, .adUserData: .granted, .adPersonalization: .granted, ])
Objective-C
[FIRAnalytics setConsent:@{ FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted, FIRConsentTypeAdStorage : FIRConsentStatusGranted, FIRConsentTypeAdUserData : FIRConsentStatusGranted, FIRConsentTypeAdPersonalization : FIRConsentStatusGranted, }];
İzin ayarlarını doğrulayın
Uygulamanızın Xcode hata ayıklama konsolunu görüntüleyerek izin ayarlarınızın amaçlandığı gibi çalıştığını doğrulayabilirsiniz.
Şu adımları uygulayın:
- Cihazınızda ayrıntılı günlük kaydını etkinleştirin.
Xcode hata ayıklama konsolunda şunları arayın:
ad_storage
analytics_storage
ad_user_data
ad_personalization
Örneğin, Reklam depolama alanı etkinse aşağıdaki mesajı görürsünüz:
ad_storage is granted.