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

Platform seçin: iOS+ Android


Bu sayfada, Analytics verilerinin toplanmasını ve kullanılmasını kontrol etmenize olanak tanıyan Google Analytics özellikleri açıklanmaktadır.

Analytics veri toplamayı devre dışı bırakma

Bazı durumlarda, son kullanıcı izni almak veya yasal yükümlülükleri yerine getirmek gibi nedenlerle Analytics verilerinin toplanmasını geçici veya kalıcı olarak devre dışı bırakmak isteyebilirsiniz. Google Analytics, Analytics koleksiyonunu devre dışı bırakmak ve kapatmak için birden fazla seçenek sunar. Birlikte kullanıldıklarında birçok tipik kullanım alanını desteklerler.

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

Veri toplamadan önce son kullanıcı izni almak gibi nedenlerle Analytics toplama işlemini geçici olarak devre dışı bırakmak istiyorsanız uygulamanızın Info.plist dosyasında FIREBASE_ANALYTICS_COLLECTION_ENABLED değerini NO (Boole) olarak ayarlayabilirsiniz. Örneğin, kaynak XML'de şu şekilde görünür:

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

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

Swift

Not: Bu Firebase ürünü, watchOS hedefinde kullanılamaz. 
Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

Not: Bu Firebase ürünü, watchOS hedefinde kullanılamaz. 
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Unity

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

Herhangi bir nedenle koleksiyonu tekrar askıya almanız gerekirse aşağıdakileri çağırabilirsiniz. Koleksiyon, siz yeniden etkinleştirene kadar askıya alınır.

Swift

Not: Bu Firebase ürünü, watchOS hedefinde kullanılamaz. 
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ütme işlemleri boyunca kalıcı olur 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, kullanıcı uygulamanızı kapatıp yeniden açsa bile setAnalyticsCollectionEnabled tekrar çağrılana kadar Analytics toplama işlemi bu durumda kalır.

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

Uygulamanızın bir sürümünde Analytics veri toplamayı kalıcı olarak devre dışı bırakmanız gerekiyorsa uygulamanızın Info.plist dosyasında FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED değerini YES (Boole) olarak ayarlayın. FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED ayarını YES (Boole) olarak belirlemek, uygulamanızın Info.plist dosyasındaki FIREBASE_ANALYTICS_COLLECTION_ENABLED değerlerine ve setAnalyticsCollectionEnabled ile ayarlanan değerlere göre önceliklidir.

Koleksiyonu yeniden etkinleştirmek için Info.plist öğenizden FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED özelliğini kaldırın. FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED değerini NO (Boole) olarak ayarlamanın bir etkisi yoktur ve Info.plist dosyanızda FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED değerinin ayarlanmamasıyla aynı davranışa neden olur.

IDFA toplamayı devre dışı bırakma

FirebaseAnalytics modülünü SPM veya CocoaPods aracılığıyla uygulamanıza yüklediyseniz ve Apple uygulamanızda IDFA (cihazın reklam kimliği) toplama özelliğini devre dışı bırakmak istiyorsanız uygulamanıza AdSupport çerçevesinin dahil edilmediğinden emin olun.

Firebase'i IDFA toplama özelliği olmadan yüklemek için FirebaseAnalytics bağımlılığı yerine aşağıdakini kullanın:

Swift Package Manager

  .target(
    name: "MyTargetName",
    dependencies: [
      .product(name: "FirebaseAnalyticsCore", package: "Firebase"),
      // ...
    ]
  ),

CocoaPods

pod 'FirebaseAnalytics/Core'

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

IDFV toplamayı devre dışı bırakma

Apple uygulamanızda IDFV (Tedarikçi Kimliği) toplama özelliğini 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 veya başka bir şekilde reklam entegrasyonunu etkinleştirdiyseniz ya da veri paylaşımını etkinleştirdiyseniz Analytics verileriniz kişiselleştirilmiş reklamcılıkta kullanılabilir. Örneğin, bu verilerin kişiselleştirilmiş reklamcılık için kullanılamayacağını belirtmediğiniz sürece, yeniden pazarlama için kitle listeleri oluşturmak ve dağıtmak amacıyla first_open gibi toplanan etkinlikleri kullanabilirsiniz.

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:

Kişiselleştirilmiş reklamcılık özelliklerini bir kullanıcı özelliği aracılığıyla devre dışı bırakma

Kişiselleştirilmiş reklamcılığı etkinleştirmek ve devre dışı bırakmak için Google'ın izin modu API'si önerilir.

Ancak uygulamanız henüz izin modunu kullanmıyorsa kişiselleştirmeyi aşağıdaki seçenekle 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.

Kişiselleştirilmiş reklamcılık özelliklerini bir kullanıcı özelliği aracılığıyla yeniden etkinleştirme

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

Swift

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

Objective-C

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

Unity

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

Analiz verilerinin toplanmasını geçici olarak devre dışı bırakmayı seçtiyseniz (örneğin, son kullanıcı izin verene kadar) ve bir kullanıcı için analiz verilerinin toplanmasını yeniden etkinleştirdikten sonra kişiselleştirilmiş reklamcılık özelliklerini kontrol etmek istiyorsanız bu ayarı belirtmek için yaptığınız çağrının, analiz verilerinin toplanmasını yeniden etkinleştirmek için yaptığınız çağrıdan önce olduğundan emin olun. Örneğin:

Swift

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

Objective-C

Not: Bu Firebase ürünü, watchOS hedefinde kullanılamaz. 
[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, söz konusu kullanıcının cihazından kaydedilen sonraki etkinlik paketleri, paketteki etkinliklerin kişiselleştirilmiş reklamcılık için kullanılamadığını belirtmek üzere 1 değerine sahip non_personalized_ads adlı bir kullanıcı özelliği içerir. 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ıktan sonra SDK, değişiklikleri indirir. Bu işlem hızlı ve sorunsuz olduğundan değişikliklerinizi hemen test edebilirsiniz. Analytics üzerinde yaptığınız değişikliklerin uygulamanızda yayınlanması birkaç dakika sürebilir. Uygulamanız yayındaysa tam dağıtım sürecinin tamamlanması bir saati bulabilir.