Uygulamalar için izin modunu ayarlama

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

Google Analytics, kullanıcılarınızın izin durumuna göre SDK'nızın davranışını ayarlamanız için izin modu sunar. İzin modunu temel veya gelişmiş şekilde uygulayabilirsiniz. Temel izin modunu mu yoksa 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 kontrol edin.

Önemli: ad_storage veya analytics_storage izin parametresi, varsayılan izin durumu veya setConsent yöntemiyle reddedildi olarak ayarlanırsa belirli bir uygulama örneğiyle ilişkili analiz verileri kalıcı olarak sıfırlanır. Örneğin, analiz verileri tüm uygulama örnekleri için sıfırlanırsa kullanıcı sayısı olduğundan yüksek çıkabilir.

• iOS: 10.23.0 veya sonraki bir sürüme güncelleyerek bu sorunu önleyebilirsiniz.
• Android: Google Play Hizmetleri yüklü cihazlar otomatik olarak bir güncelleme alır ve bu cihazlar artık bu sorundan etkilenmez. Başka bir işlem yapmanıza gerek yoktur.

Uygulamanız Google Play Hizmetleri'nin bulunmadığı cihazlarda çalışıyorsa bu sorunu önlemek için gelecek 22.0.1 sürümünde Android SDK'sını güncelleyebileceksiniz. O zamana kadar aşağıdaki adımları uygulayarak bu cihazlarda bu sorunu önleyebilirsiniz:

1. Uygulamanızın manifest dosyasında ad_storage ve analytics_storage için varsayılan değerler ayarlamayın.
2. Uygulama örneğinin ad_storage ve analytics_storage izin durumunu ayarlamadan önce Analytics toplama özelliğini devre dışı bırakın.
3. Onayınızı aldıktan sonra Analytics veri toplama özelliğini yeniden etkinleştirin. Bu durumda Analytics verileri sıfırlanmaz.

Bir uygulama örneğinin analizlerini sıfırlamak istiyorsanız amaca özel API'yi kullanın. Android örneği için buraya bakın.

Gelişmiş izin modu Temel izin modu

iOS Android

Önemli: Uygulamalar için izin modu 30 Ekim 2023'te güncellendi ve artık iki parametre içeriyor. Zaten izin modunu kullanıyorsanız izin modu v2'ye yükseltin. Google'ın Avrupa Ekonomik Alanı'ndaki (AEA) trafik için izin modu güncellemeleri hakkında daha fazla bilgi edinin.

Başlamadan önce

Kullanıcı rızasını yönetebilmek için aşağıdakileri uygulamanız gerekir:

• Firebase için Google Analytics SDK'sı

• Kullanıcı iznini yakalamak için kullanılan izin ayarları banner'ı

  İpucu: Kullanıcı rızası ayarlarını kendiniz uygulamak istemiyorsanız bir kullanıcı rızası yönetim platformu (CMP) kullanabilirsiniz.

İzin modunu ayarlama

İzin modunu ayarlamak için şunları yapmanız gerekir:

1. Varsayılan izin durumunu ayarlayın.

Varsayılan izin durumunu ayarlama

Varsayılan olarak izin modu değeri ayarlanmamıştır. Uygulamanızın varsayılan izin durumunu ayarlamak için:

1. Uygulamanızın AndroidManifest.xml dosyasını açın.

2. İzin modu anahtar/değer çiftlerini ekleyin. Anahtar, izin türünü açıklar ve değer, izin durumunu gösterir. Değerler, izin verildiği anlamına gelen true veya iznin reddedildiği anlamına gelen false olabilir. 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

3. Değişikliklerinizi kaydedin. Ardından, izin değerlerini güncelleme mekanizmasını uygulayın.

Örneğin, varsayılan olarak tüm parametrelere tüm izin verme iznini ayarlamak için:

<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

Bir 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ütmeleri genelinde geçerliliğini korur. Kullanıcı uygulamayı kapatıp yeniden açsa bile setConsent tekrar çağrılana kadar değer bu durumda kalır. setConsent yalnızca belirttiğiniz parametreleri günceller.

Bir kullanıcı Analytics veya Ad depolama alanı için daha önce verdiği izni geri çekerse Google Analytics, ad_personalization için izin de dahil olmak üzere tüm kullanıcı özelliklerini siler. Kullanıcının reklam kişiselleştirme ile ilgili izin seçimini korumak için setConsent (Kotlin+KTX | Java) kullanarak önceki reklam kişiselleştirme değerini 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)
}