Analytics veri toplama ve kullanımını yapılandırma


Bu sayfada, Google Analytics'in sunduğu, Analytics verilerinin toplanmasını ve kullanılmasını kontrol etmenizi sağlayan özellikler açıklanmaktadır.

Analytics veri toplama özelliğini devre dışı bırakma

Bazı durumlarda, son kullanıcı izni almak veya yasal yükümlülükleri yerine getirmek gibi amaçlarla Analytics verilerinin toplanmasını geçici ya da kalıcı olarak devre dışı bırakmak isteyebilirsiniz. Google Analytics, Analytics veri toplama işlevini devre dışı bırakmak ve devre dışı bırakmak için çeşitli seçenekler sunar. Birlikte kullanıldıklarında birçok tipik kullanım alanını desteklerler.

Koleksiyonu geçici olarak devre dışı bırakma

Analytics veri toplama özelliğini geçici olarak devre dışı bırakmak (ör. veri toplamadan önce son kullanıcının iznini almak) istiyorsanız uygulamanızın Info.plist dosyasında FIREBASE_ANALYTICS_COLLECTION_ENABLED değerini NO (Boole) olarak ayarlayabilirsiniz. Örneğin, kaynak XML'de görüntülenir:

<key>FIREBASE_ANALYTICS_COLLECTION_ENABLED</key><false/>

Örneğin, bir son kullanıcı izin verdikten sonra koleksiyonu yeniden etkinleştirmek için Analytics öğesinin setAnalyticsCollectionEnabled örnek yöntemini çağırın. Örnek:

Swift

Not: Bu Firebase ürünü, macOS hedefinde kullanılamıyor.
Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

Not: Bu Firebase ürünü, macOS hedefinde kullanılamıyor.
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Unity

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

Herhangi bir nedenle toplama işlemini tekrar askıya almanız gerekirse aşağıdaki komutu çağırabilirsiniz. Bu durumda koleksiyon, siz yeniden etkinleştirene kadar askıya alınır.

Swift

Not: Bu Firebase ürünü, macOS hedefinde kullanılamıyor.
Analytics.setAnalyticsCollectionEnabled(false)

Objective-C

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

Unity

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(false);

setAnalyticsCollectionEnabled yöntemi tarafından ayarlanan değer, uygulama yürütmeleri genelinde değişmeden kalır ve uygulamanızın Info.plist dosyasındaki FIREBASE_ANALYTICS_COLLECTION_ENABLED değerini geçersiz kılar. setAnalyticsCollectionEnabled için bir değer ayarladığınızda Analytics koleksiyonu, kullanıcı uygulamanızı kapatıp yeniden açsa bile setAnalyticsCollectionEnabled tekrar çağrılana kadar bu durumda kalır.

Koleksiyonu kalıcı olarak devre dışı bırak

Uygulamanızın bir sürümünde Analytics koleksiyonunu kalıcı olarak devre dışı bırakmanız gerekiyorsa uygulamanızın Info.plist dosyasında FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED politikasını YES (Boole) olarak ayarlayın. FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED öğesinin YES (Boole) olarak ayarlanması, uygulamanızın Info.plist öğesindeki FIREBASE_ANALYTICS_COLLECTION_ENABLED değerlerinin yanı sıra setAnalyticsCollectionEnabled ile ayarlanan tüm değerlere göre öncelikli olur.

Koleksiyonu yeniden etkinleştirmek için FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED öğelerini Info.plist cihazınızdan kaldırın. FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED öğesinin NO (Boole) olarak ayarlanmasının herhangi bir etkisi olmaz ve Info.plist dosyanızda FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED ayarlanmamış olmasıyla aynı davranışla sonuçlanır.

IDFA toplamayı devre dışı bırakma

Uygulamanızın Podfile dosyasına pod 'Firebase/Analytics' ekleyerek Firebase'i CocoaPods üzerinden yüklediyseniz ve Apple uygulamanızda IDFA'nın (cihazın reklam tanımlayıcısı) toplanmasını devre dışı bırakmak istiyorsanız AdSupport çerçevesinin uygulamanıza dahil edilmediğinden emin olun.

Firebase'i IDFA toplama özelliği olmadan yüklemek için pod 'Firebase/Analytics' yerine aşağıdaki alt spesifikasyonu kullanın:

pod 'Firebase/AnalyticsWithoutAdIdSupport'

Apple'ın belgelerinde IDFA hakkında daha fazla bilgi edinin:

IDFV toplamayı devre dışı bırak

Apple uygulamanızda IDFV'nin (Tedarikçi Tanımlayıcısı) toplanmasını devre dışı bırakmak istiyorsanız uygulamanızın Info.plist dosyasında GOOGLE_ANALYTICS_IDFV_COLLECTION_ENABLED değerini NO (Boole) olarak ayarlayın.

Kişiselleştirilmiş reklamcılık için veri toplamayı kontrol etme

Google Analytics projenizi bir reklam hesabına bağladıysanız, reklam entegrasyonunu etkinleştirdiyseniz ya da veri paylaşımını etkinleştirdiyseniz Analytics verileriniz kişiselleştirilmiş reklamcılıkta kullanılmaya uygun olabilir. Bu, örneğin, bu tür verilerin kişiselleştirilmiş reklamcılık için kullanılamadığını belirtmediğiniz sürece, yeniden pazarlama için kitle listeleri oluşturmak ve bunları dağıtmak amacıyla first_open gibi toplanan etkinlikleri kullanabileceğiniz anlamına gelir.

Aşağıdaki seçeneklerden herhangi birini kullanarak bir kullanıcının Analytics verilerinin kişiselleştirilmiş reklamcılık için kullanılıp kullanılmayacağını programatik olarak kontrol edebilirsiniz:

Kullanıcı özelliği üzerinden kişiselleştirilmiş reklamcılık özelliklerini devre dışı bırakma

Google'ın Consent Mode API kişiselleştirilmiş reklamcılığı etkinleştirmek ve devre dışı bırakmak için önerilen yöntemdir.

Ancak uygulamanız henüz izin modunu kullanmıyorsa aşağıdaki seçenekle kişiselleştirmeyi kontrol edebilirsiniz.

Kişiselleştirilmiş reklamcılık davranışını varsayılan olarak devre dışı bırakmak için uygulamanızın Info.plist dosyasında GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS değerini NO (Boole) olarak ayarlayın.

Bir kullanıcı mülkü aracılığıyla kişiselleştirilmiş reklamcılık özelliklerini yeniden etkinleştirin

Reklam kişiselleştirmeyi kontrol etmek için AnalyticsUserPropertyAllowAdPersonalizationSignals parametresini kullanıyorsanız reklam kişiselleştirmeyi setUserProperty yöntemi ile aşağıda gösterildiği gibi yeniden etkinleştirebilirsiniz:

Swift

Not: Bu Firebase ürünü, macOS hedefinde kullanılamıyor.
Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)

Objective-C

Not: Bu Firebase ürünü, macOS hedefinde kullanılamıyor.
[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];

Unity

Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, true);

Analiz toplamayı geçici olarak devre dışı bırakmayı seçtiyseniz (örneğin, bir son kullanıcı izin verene kadar) ve bir kullanıcı için Analytics toplama özelliğini yeniden etkinleştirdikten sonra kişiselleştirilmiş reklamcılık özelliklerini kontrol etmek istiyorsanız bu ayarı belirtme çağrınızın, Analytics toplamayı yeniden etkinleştirme çağrınızdan önce geldiğinden emin olun. Örnek:

Swift

Not: Bu Firebase ürünü, macOS hedefinde kullanılamıyor.
Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

Not: Bu Firebase ürünü, macOS hedefinde kullanılamıyor.
[FIRAnalytics setUserPropertyString:... forName:kFIRUserPropertyAllowAdPersonalizationSignals];
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Unity

Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, ...);
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

Ayarlarınızı onaylayın

Reklam kişiselleştirme sinyalleri, yukarıda tanımlanan mekanizmalardan biri aracılığıyla bir kullanıcı için devre dışı bırakıldığında bu kullanıcının cihazından günlüğe kaydedilen sonraki etkinlik paketleri, non_personalized_ads adlı bir kullanıcı özelliği içerir. Bu kullanıcı özelliği, bu paketteki etkinliklerin kişiselleştirilmiş reklamcılık için kullanılamadığını belirtir. Kişiselleştirilmiş reklamcılığın devre dışı bırakılması, verilerin raporlama ve ilişkilendirme dahil olmak üzere ölçüm amacıyla kullanılmasını etkilemez.

Yapılandırma değişikliklerinizi görme

Google Analytics ayarlarınızda değişiklik yaptığınızda SDK bu değişiklikleri indirir. Süreç hızlı ve sorunsuz olduğundan, değişikliklerinizi hızla test edebilirsiniz. Analytics'te değişiklik yaptığınızda dağıtımın uygulamanızda tamamlanması birkaç dakikayı bulabilir. Uygulamanız yayındaysa tam dağıtım işleminin tamamlanması bir saati bulabilir.