Auf dieser Seite werden die Funktionen von Google Analytics beschrieben, mit denen Sie die Erhebung und Verwendung von Analytics-Daten steuern können.
Analytics-Datenerhebung deaktivieren
In einigen Fällen möchten Sie die Erhebung von Analytics-Daten möglicherweise vorübergehend oder dauerhaft deaktivieren, z. B. um die Einwilligung der Endnutzer einzuholen oder rechtliche Verpflichtungen zu erfüllen. Google Analytics bietet mehrere Optionen zum Deaktivieren der Analytics-Erhebung. Zusammen unterstützen sie viele typische Anwendungsfälle.
Erhebung vorübergehend deaktivieren
Wenn Sie die Erhebung von Analytics vorübergehend deaktivieren möchten, z. B. um die Einwilligung des Endnutzers einzuholen, bevor Sie Daten erheben, können Sie den Wert von FIREBASE_ANALYTICS_COLLECTION_ENABLED in der Info.plist-Datei Ihrer App auf NO (boolescher Wert) festlegen. Beispiel:
<key>FIREBASE_ANALYTICS_COLLECTION_ENABLED</key><false/>
Wenn Sie die Erhebung wieder aktivieren möchten, z. B. nachdem ein Endnutzer die Einwilligung erteilt hat, rufen Sie die Instanzmethode setAnalyticsCollectionEnabled von Analytics auf. Beispiel:
Swift
Analytics.setAnalyticsCollectionEnabled(true)
Objective-C
[FIRAnalytics setAnalyticsCollectionEnabled:YES];
Einheit
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);
Wenn Sie die Erhebung aus irgendeinem Grund noch einmal aussetzen müssen, können Sie die folgende Funktion aufrufen. Die Erhebung wird dann ausgesetzt, bis Sie sie wieder aktivieren.
Swift
Analytics.setAnalyticsCollectionEnabled(false)
Objective-C
[FIRAnalytics setAnalyticsCollectionEnabled:NO];
Einheit
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(false);
Der mit der Methode setAnalyticsCollectionEnabled festgelegte Wert bleibt über die Ausführungen der App hinweg 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 festlegen, bleibt die Analytics-Erfassung in diesem Zustand, bis setAnalyticsCollectionEnabled noch einmal aufgerufen wird. Das gilt auch, wenn ein Nutzer Ihre App schließt und wieder öffnet.
Datenerhebung dauerhaft deaktivieren
Wenn Sie die Analytics-Erhebung in einer Version Ihrer App dauerhaft deaktivieren möchten, legen Sie in der Info.plist-Datei Ihrer App FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED auf YES (boolescher Wert) fest. Wenn Sie FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED auf YES (boolescher Wert) festlegen, hat das Vorrang vor allen Werten für FIREBASE_ANALYTICS_COLLECTION_ENABLED im Info.plist Ihrer App sowie vor allen Werten, die mit setAnalyticsCollectionEnabled festgelegt wurden.
Wenn Sie die Erfassung wieder aktivieren möchten, entfernen Sie FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED aus Ihrem Info.plist. Wenn Sie FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED auf NO (boolescher Wert) festlegen, hat das keine Auswirkungen. Das Verhalten ist dasselbe, als wenn FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED in Ihrer Info.plist-Datei nicht festgelegt wäre.
IDFA-Erhebung deaktivieren
Wenn Sie Firebase über CocoaPods installiert haben, indem Sie pod 'FirebaseAnalytics' in das Podfile Ihrer App eingefügt haben, und die Erfassung der IDFA (Werbe-ID eines Geräts) in Ihrer Apple-App deaktivieren möchten, muss das AdSupport-Framework in Ihrer App ausgeschlossen werden.
Wenn Sie Firebase ohne Funktion für die IDFA-Erfassung installieren möchten, verwenden Sie anstelle von pod 'FirebaseAnalytics' die folgende Subspec:
pod 'FirebaseAnalytics/Core'
Weitere Informationen zur IDFA finden Sie in der Dokumentation von Apple:
IDFV-Erhebung deaktivieren
Wenn Sie die Erhebung der IDFV (Identifier for Vendor) in Ihrer Apple-App deaktivieren möchten, legen Sie den Wert von GOOGLE_ANALYTICS_IDFV_COLLECTION_ENABLED in der Info.plist-Datei Ihrer App auf NO (Boolesch) fest.
Datenerhebung für personalisierte Werbung verwalten
Wenn Sie Ihr Google Analytics-Projekt mit einem Werbekonto verknüpft oder anderweitig eine Werbeintegration aktiviert oder der Datenfreigabe zugestimmt haben, können Ihre Analytics-Daten möglicherweise für personalisierte Werbung verwendet werden.
Das bedeutet beispielsweise, dass Sie erhobene Ereignisse wie first_open verwenden dürfen, um Zielgruppenlisten für Remarketing zu erstellen und bereitzustellen, sofern Sie nicht angeben, dass solche Daten nicht für personalisierte Werbung verfügbar sind.
Sie können programmatisch festlegen, ob die Analytics-Daten eines Nutzers für personalisierte Werbung verwendet werden sollen. Dazu haben Sie folgende Möglichkeiten:
Empfohlen: Personalisierte Anzeigen dynamisch aktivieren oder deaktivieren, indem Sie die Einwilligung des Nutzers berücksichtigen. Implementieren Sie die Consent Mode API von Google.
Personalisierung von Anzeigen auf Nutzerebene aktivieren oder deaktivieren: Personalisierung von Anzeigen als Nutzereigenschaft steuern
Personalisierte Anzeigen auf Analytics-Property-Ebene aktivieren oder deaktivieren: Personalisierte Anzeigen für einzelne geografische Regionen in Ihrer Analytics-Property deaktivieren
Funktionen für personalisierte Werbung über eine Nutzereigenschaft deaktivieren
Einwilligungsmodus-API von Google ist die empfohlene Methode zum Aktivieren und Deaktivieren personalisierter Werbung.Wenn Ihre App den Einwilligungsmodus noch nicht verwendet, können Sie die Personalisierung mit der folgenden Option steuern.
Wenn Sie personalisierte Werbung standardmäßig deaktivieren möchten, legen Sie den Wert von GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS in der Info.plist-Datei Ihrer App auf NO (boolescher Wert) fest.
Personalisierte Werbefunktionen über eine Nutzereigenschaft reaktivieren
Wenn Sie den Parameter AnalyticsUserPropertyAllowAdPersonalizationSignals verwenden, um personalisierte Anzeigen zu steuern, können Sie personalisierte Anzeigen mit der Methode setUserProperty wieder aktivieren, wie unten gezeigt:
Swift
Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Objective-C
[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];
Einheit
Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, true);
Wenn Sie die Erhebung von Analysedaten vorübergehend deaktiviert haben (z. B. bis ein Endnutzer die Einwilligung erteilt), und Sie personalisierte Werbefunktionen steuern möchten, nachdem Sie die Erhebung von Analysedaten für einen Nutzer wieder aktiviert haben, muss der Aufruf zum Festlegen dieser Einstellung vor dem Aufruf zum Reaktivieren der Erhebung von Analysedaten erfolgen. Beispiel:
Swift
Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)
Objective-C
[FIRAnalytics setUserPropertyString:... forName:kFIRUserPropertyAllowAdPersonalizationSignals];
[FIRAnalytics setAnalyticsCollectionEnabled:YES];
Einheit
Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, ...);
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);
Einstellungen bestätigen
Wenn Signale für personalisierte Anzeigen für einen Nutzer über einen der oben genannten Mechanismen deaktiviert wurden, enthalten nachfolgende Ereignis-Bundles, die vom Gerät dieses Nutzers protokolliert werden, eine Nutzereigenschaft namens non_personalized_ads mit dem Wert 1. So wird angegeben, 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 Analysezwecke, einschließlich Berichterstellung und Attribution.
Konfigurationsänderungen ansehen
Nachdem Sie Änderungen an den Google Analytics-Einstellungen vorgenommen haben, lädt das SDK die Änderungen herunter. Der Prozess 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 gesamte Bereitstellungsprozess bis zu einer Stunde dauern.