Datenerhebung und -nutzung in Analytics konfigurieren

Auf dieser Seite werden die Funktionen von Google Analytics beschrieben, mit denen Sie die Erhebung und Verwendung von Analytics-Daten steuern können.

Datenerhebung deaktivierenAnalytics

In einigen Fällen möchten Sie möglicherweise die Erhebung von Analytics Daten vorübergehend oder dauerhaft deaktivieren, z. B. um die Einwilligung von Endnutzern einzuholen oder gesetzliche Verpflichtungen zu erfüllen. Google Analytics bietet mehrere Optionen zum Deaktivieren und Deaktivieren der Analytics Erhebung. In Kombination unterstützen sie viele typische Anwendungsfälle.

Erhebung vorübergehend deaktivieren

Wenn Sie die Analytics Erhebung vorübergehend deaktivieren möchten, z. B. um die Einwilligung von Endnutzern einzuholen, bevor Sie Daten erheben, können Sie den Wert von FIREBASE_ANALYTICS_COLLECTION_ENABLED auf NO (boolescher Wert) in der Datei Info.plist Ihrer App setzen. Beispiel in der XML-Quelle:

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

Wenn Sie die Erhebung wieder aktivieren möchten, z. B. nachdem ein Endnutzer seine Einwilligung gegeben hat, rufen Sie die setAnalyticsCollectionEnabled Instanzmethode von Analytics auf. Beispiel:

Analytics.setAnalyticsCollectionEnabled(true)

[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

Wenn Sie die Erhebung aus irgendeinem Grund wieder unterbrechen müssen, können Sie Folgendes aufrufen. Die Erhebung wird unterbrochen, bis Sie sie wieder aktivieren.

Analytics.setAnalyticsCollectionEnabled(false)

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(false);

Der mit der Methode setAnalyticsCollectionEnabled festgelegte Wert bleibt bei allen Ausführungen der App bestehen und überschreibt den Wert für FIREBASE_ANALYTICS_COLLECTION_ENABLED in der Datei Info.plist Ihrer App. Sobald Sie einen Wert für setAnalyticsCollectionEnabled festgelegt haben, bleibt die Analytics-Erhebung in diesem Status, bis setAnalyticsCollectionEnabled wieder aufgerufen wird. Das gilt auch, wenn ein Nutzer Ihre App schließt und wieder öffnet.

Erhebung dauerhaft deaktivieren

Wenn Sie die Analytics-Erhebung in einer Version Ihrer App dauerhaft deaktivieren müssen, setzen Sie FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED in der Datei Info.plist Ihrer App auf YES (boolescher Wert). Die Einstellung FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED auf YES (boolescher Wert) hat Vorrang vor allen Werten für FIREBASE_ANALYTICS_COLLECTION_ENABLED in der Datei Info.plist Ihrer App sowie vor allen mit setAnalyticsCollectionEnabled festgelegten Werten.

Wenn Sie die Erhebung wieder aktivieren möchten, entfernen Sie FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED aus Ihrer Datei Info.plist. Wenn Sie FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED auf NO (boolescher Wert) setzen, hat das keine Auswirkungen. Das Verhalten ist dasselbe, als wäre FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED in der Datei Info.plist nicht festgelegt.

IDFA-Erhebung deaktivieren

Wenn Sie das Modul FirebaseAnalytics über SPM oder CocoaPods in Ihrer App installiert haben und die Erhebung der IDFA (Advertising Identifier eines Geräts) in Ihrer Apple-App deaktivieren möchten, darf das AdSupport-Framework nicht in Ihrer App enthalten sein.

Wenn Sie Firebase ohne Funktion für die IDFA-Erhebung installieren möchten, verwenden Sie anstelle der Abhängigkeit FirebaseAnalytics Folgendes:

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

pod 'FirebaseAnalytics/Core'

Weitere Informationen zur IDFA finden Sie in der Dokumentation von Apple:

• User Privacy and Data Use
• App Tracking Transparency

IDFV-Erhebung deaktivieren

Wenn Sie die Erhebung der IDFV (Identifier for Vendor) in Ihrer Apple-App deaktivieren möchten, setzen Sie den Wert von GOOGLE_ANALYTICS_IDFV_COLLECTION_ENABLED in der Datei Info.plist Ihrer App auf NO (boolescher Wert).

Datenerhebung für personalisierte Werbung steuern

Wenn Sie Ihr Google Analytics Projekt mit einem Werbekonto verknüpft oder auf andere Weise eine Werbeintegration aktiviert oder der Datenfreigabe zugestimmt haben, können Ihre Analytics-Daten für personalisierte Werbung verwendet werden. Das bedeutet beispielsweise, dass Sie erhobene Ereignisse wie first_open verwenden können, um Zielgruppenlisten für das Remarketing zu erstellen und bereitzustellen, es sei denn, Sie geben an, dass diese Daten nicht für personalisierte Werbung verfügbar sind.

Sie können programmatisch steuern, ob die Analytics-Daten eines Nutzers für personalisierte Werbung verwendet werden sollen. Dazu haben Sie folgende Möglichkeiten:

• Empfohlen: Aktivieren oder deaktivieren Sie personalisierte Werbung dynamisch, indem Sie die Einwilligung des Nutzers berücksichtigen. Implementieren Sie die Consent Mode API von Google.

• Aktivieren oder deaktivieren Sie personalisierte Werbung auf Nutzerebene: Steuern Sie personalisierte Werbung als Nutzereigenschaft.

• Aktivieren oder deaktivieren Sie personalisierte Werbung auf Analytics-Property-Ebene: Deaktivieren Sie personalisierte Werbung für einzelne geografische Regionen in Ihrer Analytics-Property.

Personalisierte Werbefunktionen über eine Nutzereigenschaft deaktivieren

Die Consent Mode API von Google ist die empfohlene Methode zum Aktivieren und Deaktivieren personalisierter Werbung.

Wenn Ihre App den Einwilligungsmodus jedoch noch nicht verwendet, können Sie die Personalisierung mit der folgenden Option steuern.

Wenn Sie personalisierte Werbung standardmäßig deaktivieren möchten, setzen Sie den Wert von GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS in der Datei Info.plist Ihrer App auf NO (boolescher Wert).

Personalisierte Werbefunktionen über eine Nutzereigenschaft wieder aktivieren

Wenn Sie den AnalyticsUserPropertyAllowAdPersonalizationSignals Parameter verwenden, um personalisierte Werbung zu steuern, können Sie sie mit der setUserProperty Methode wieder aktivieren, wie unten gezeigt:

Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)

[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];

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

Wenn Sie die Analytics-Erhebung vorübergehend deaktiviert haben (z. B. bis ein Endnutzer seine Einwilligung gibt) und personalisierte Werbefunktionen steuern möchten, nachdem Sie die Analytics-Erhebung für einen Nutzer wieder aktiviert haben, muss der Aufruf zum Festlegen dieser Einstellung vor dem Aufruf zum Wiederaktivieren der Analytics-Erhebung erfolgen. Beispiel:

Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)

[FIRAnalytics setUserPropertyString:... forName:kFIRUserPropertyAllowAdPersonalizationSignals];
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

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

Einstellungen bestätigen

Wenn personalisierte Werbesignale für einen Nutzer über einen der oben genannten Mechanismen deaktiviert wurden, enthalten nachfolgende Ereignis-Bundles, die vom Gerät dieses Nutzers protokolliert wurden, eine Nutzereigenschaft namens non_personalized_ads mit dem Wert 1. Das bedeutet, dass Ereignisse in diesem Bundle nicht für personalisierte Werbung verfügbar sind. Die Deaktivierung personalisierter Werbung hat keine Auswirkungen auf die Verwendung der Daten für Messungen, einschließlich Berichterstellung und Attribution.

Konfigurationsänderungen ansehen

Nachdem Sie Änderungen an Ihren Google Analytics Einstellungen vorgenommen haben, lädt das SDK die Änderungen herunter. Der Vorgang ist schnell und nahtlos, sodass Sie Ihre Änderungen schnell testen können. Wenn Sie Änderungen in Analytics vornehmen, kann es einige Minuten dauern, bis sie in Ihrer App bereitgestellt werden. Wenn Ihre App aktiv ist, kann der vollständige Bereitstellungsprozess bis zu einer Stunde dauern.