Auf dieser Seite werden die Funktionen von Google Analytics beschrieben, mit denen Sie die Erhebung und Verwendung von Analytics-Daten steuern können.
Datenerhebung für Analytics 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 von Endnutzern einzuholen oder rechtliche Verpflichtungen zu erfüllen. Google Analytics bietet mehrere Optionen zum Deaktivieren der Analytics-Datenerhebung. In Kombination 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 vor der Erhebung von Daten die Einwilligung des Endnutzers einzuholen, können Sie den Wert von FIREBASE_ANALYTICS_COLLECTION_ENABLED in der Info.plist-Datei Ihrer App auf NO (boolescher Wert) setzen. Beispiel im Quell-XML-Code:
<key>FIREBASE_ANALYTICS_COLLECTION_ENABLED</key><false/>
Wenn Sie die Erfassung wieder aktivieren möchten, z. B. nachdem ein Endnutzer seine 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 Erfassung aus irgendeinem Grund wieder pausieren möchten, können Sie die folgende Funktion aufrufen. Die Erfassung wird dann pausiert, bis Sie sie wieder aktivieren.
Swift
Analytics.setAnalyticsCollectionEnabled(false)
Objective-C
[FIRAnalytics setAnalyticsCollectionEnabled:NO];
Einheit
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(false);
Der von der setAnalyticsCollectionEnabled-Methode festgelegte Wert bleibt über mehrere App-Ausführungen hinweg erhalten und überschreibt den Wert für FIREBASE_ANALYTICS_COLLECTION_ENABLED in der Info.plist-Datei Ihrer App. Nachdem Sie einen Wert für setAnalyticsCollectionEnabled festgelegt haben, bleibt die Analytics-Erfassung in diesem Status, bis setAnalyticsCollectionEnabled wieder aufgerufen wird, 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 für FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED den Wert YES (boolescher Wert) fest. Wenn Sie FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED auf YES (boolescher Wert) festlegen, hat dies 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 Sammlung wieder aktivieren möchten, entfernen Sie FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED aus Info.plist. Wenn Sie FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED auf NO (boolescher Wert) festlegen, hat das keine Auswirkungen. Das Verhalten entspricht dem, das auftritt, wenn FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED in der Info.plist-Datei nicht festgelegt ist.
Erhebung von IDFAs deaktivieren
Wenn Sie Firebase über CocoaPods installiert haben, indem Sie der Podfile Ihrer App pod 'Firebase/Analytics' hinzugefügt haben, und die Erhebung der IDFA (Werbe-ID eines Geräts) in Ihrer Apple-App deaktivieren möchten, darf das AdSupport-Framework nicht in Ihrer App enthalten sein.
Wenn Sie Firebase ohne IDFA-Erfassungsfunktion installieren möchten, verwenden Sie anstelle von pod 'Firebase/Analytics' die folgende Subspec:
pod 'Firebase/AnalyticsWithoutAdIdSupport'
Weitere Informationen zur IDFA finden Sie in der Apple-Dokumentation:
IDFV-Erhebung deaktivieren
Wenn Sie die Erhebung der IDFV (Identifier for Vendor) in Ihrer Apple-App deaktivieren möchten, legen Sie in der Info.plist-Datei Ihrer App den Wert für GOOGLE_ANALYTICS_IDFV_COLLECTION_ENABLED auf NO (boolescher Wert) fest.
Datenerhebung für personalisierte Werbung verwalten
Wenn Sie Ihr Google Analytics-Projekt mit einem Google Ads-Konto verknüpft oder anderweitig eine Google Ads-Verknüpfung aktiviert oder die Datenfreigabe aktiviert 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 Remarketing zu erstellen und zu implementieren, es sei denn, Sie geben an, dass diese 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 stehen Ihnen die folgenden Optionen zur Verfügung:
Empfohlen: Aktivieren oder deaktivieren Sie personalisierte Werbung dynamisch, indem Sie die Einwilligungsentscheidung des Nutzers berücksichtigen. Implementieren Sie die API für den Einwilligungsmodus von Google.
Personalisierte Werbung auf Nutzerebene aktivieren oder deaktivieren: Personalisierte Werbung als Nutzereigenschaft verwalten
Personalisierte Anzeigen auf Analytics-Property-Ebene aktivieren oder deaktivieren: Personalisierte Anzeigen für einzelne Regionen in Ihrer Analytics-Property deaktivieren
Funktionen für personalisierte Werbung über eine Nutzereigenschaft deaktivieren
Die Einwilligungsmodus-API von Google wird empfohlen, um personalisierte Werbung zu aktivieren und zu deaktivieren.Wenn in Ihrer App jedoch noch nicht der Einwilligungsmodus verwendet wird, können Sie die Personalisierung mit der folgenden Option steuern.
Wenn Sie das Verhalten für personalisierte Werbung standardmäßig deaktivieren möchten, setzen Sie in der Info.plist-Datei Ihrer App den Wert von GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS auf NO (boolescher Wert).
Personalisierte Werbefunktionen über eine Nutzereigenschaft wieder aktivieren
Wenn Sie personalisierte Werbung mit dem Parameter AnalyticsUserPropertyAllowAdPersonalizationSignals steuern, können Sie sie 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 Analyseerhebung vorübergehend deaktiviert haben (z. B. bis ein Endnutzer seine Einwilligung erteilt) und die personalisierten Werbefunktionen steuern möchten, sobald Sie die Analyseerhebung für einen Nutzer wieder aktivieren, muss der Aufruf zum Festlegen dieser Einstellung vor dem Aufruf zum erneuten Aktivieren der Analyseerhebung 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 beschriebenen Mechanismen deaktiviert wurden, enthalten nachfolgende Ereignisbündel, die vom Gerät dieses Nutzers protokolliert werden, die Nutzereigenschaft non_personalized_ads mit dem Wert „1“. Damit wird angegeben, dass Ereignisse in diesem Bündel nicht für personalisierte Anzeigen verfügbar sind. Die Deaktivierung personalisierter Werbung hat keine Auswirkungen auf die Verwendung der Daten zu Analysezwecken, einschließlich Berichterstellung und Attribution.
Konfigurationsänderungen ansehen
Nachdem Sie Änderungen an den Google Analytics-Einstellungen vorgenommen haben, werden sie vom SDK heruntergeladen. 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 online ist, kann die vollständige Bereitstellung bis zu einer Stunde dauern.