Konfigurieren Sie die Analytics-Datenerfassung und -nutzung

Google Analytics bietet Funktionen, mit denen Sie die Erfassung und Verwendung von Analytics-Daten steuern können.

Deaktivieren Sie die Analytics-Datenerfassung

In einigen Fällen möchten Sie möglicherweise die Erfassung von Analytics-Daten vorübergehend oder dauerhaft deaktivieren, beispielsweise um die Einwilligung des Endbenutzers einzuholen oder um rechtliche Verpflichtungen zu erfüllen. Google Analytics bietet mehrere Optionen zum Deaktivieren und Deaktivieren der Analytics-Erfassung. Zusammengenommen unterstützen sie viele typische Anwendungsfälle.

Deaktivieren Sie die Erfassung vorübergehend

Wenn Sie die Analytics-Erfassung vorübergehend deaktivieren möchten, um beispielsweise vor der Datenerfassung die Zustimmung des Endbenutzers einzuholen, können Sie den Wert von FIREBASE_ANALYTICS_COLLECTION_ENABLED in der Info.plist Datei Ihrer App auf NO (Boolean) setzen. Beispielsweise im Quell-XML angezeigt:

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

Um die Erfassung erneut zu aktivieren, beispielsweise nachdem ein Endbenutzer seine Einwilligung erteilt hat, rufen Sie die Instanzmethode setAnalyticsCollectionEnabled von Analytics auf. Zum Beispiel:

Schnell

Hinweis: Dieses Firebase-Produkt ist auf dem macOS-Ziel nicht verfügbar.
Analytics.setAnalyticsCollectionEnabled(true)

Ziel c

Hinweis: Dieses Firebase-Produkt ist auf dem macOS-Ziel nicht verfügbar.
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Wenn Sie die Abholung aus irgendeinem Grund erneut aussetzen müssen, können Sie anrufen

Schnell

Hinweis: Dieses Firebase-Produkt ist auf dem macOS-Ziel nicht verfügbar.
Analytics.setAnalyticsCollectionEnabled(false)

Ziel c

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

und die Erfassung wird ausgesetzt, bis Sie sie erneut aktivieren. Der von der setAnalyticsCollectionEnabled -Methode festgelegte Wert bleibt über alle App-Ausführungen hinweg bestehen und überschreibt den Wert für FIREBASE_ANALYTICS_COLLECTION_ENABLED in der Info.plist Datei Ihrer App. Sobald Sie einen Wert für setAnalyticsCollectionEnabled festgelegt haben, bleibt die Analytics-Sammlung in diesem Zustand, bis setAnalyticsCollectionEnabled erneut aufgerufen wird, selbst wenn ein Benutzer Ihre App schließt und erneut öffnet.

Sammlung dauerhaft deaktivieren

Wenn Sie die Analytics-Erfassung in einer Version Ihrer App dauerhaft deaktivieren müssen, legen Sie FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED in der Info.plist Datei Ihrer App auf YES (Boolean) fest. Das Festlegen von FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED auf YES (Boolescher Wert) hat Vorrang vor allen Werten für FIREBASE_ANALYTICS_COLLECTION_ENABLED in Info.plist Ihrer App sowie vor allen mit setAnalyticsCollectionEnabled festgelegten Werten.

Um die Sammlung wieder zu aktivieren, entfernen Sie FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED aus Ihrer Info.plist . Das Festlegen FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED auf NO (Boolean) hat keine Auswirkung und führt zum gleichen Verhalten, als wenn FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED nicht in Ihrer Info.plist Datei festgelegt wäre.

Deaktivieren Sie die IDFA-Erfassung

Wenn Sie Firebase über CocoaPods installiert haben, indem Sie pod 'Firebase/Analytics' zur Poddatei Ihrer App hinzugefügt haben und die Erfassung des IDFA (der Werbekennung eines Geräts) in Ihrer Apple-App deaktivieren möchten, stellen Sie sicher, dass das AdSupport-Framework nicht in Ihrer App enthalten ist.

Um Firebase ohne IDFA-Erfassungsfunktion zu installieren, verwenden Sie die folgende Unterspezifikation anstelle des pod 'Firebase/Analytics' :

pod 'Firebase/AnalyticsWithoutAdIdSupport'

Erfahren Sie mehr über IDFA in der Dokumentation von Apple:

Deaktivieren Sie die IDFV-Sammlung

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

Kontrollieren Sie die Datenerfassung für personalisierte Werbung

Wenn Sie Ihr Google Analytics-Projekt mit einem Anzeigenkonto verknüpft oder anderweitig eine Anzeigenintegration aktiviert oder der Datenfreigabe zugestimmt haben, können Ihre Analytics-Daten möglicherweise für personalisierte Werbung verwendet werden. Das bedeutet beispielsweise, dass Sie gesammelte Ereignisse wie first_open verwenden dürfen, um Zielgruppenlisten für 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 mithilfe einer der folgenden Optionen programmgesteuert steuern, ob die Analytics-Daten eines Benutzers für personalisierte Werbung verwendet werden sollen:

Deaktivieren Sie personalisierte Werbefunktionen über eine Benutzereigenschaft

Googles Einwilligungsmodus-APIist die empfohlene Methode zum Aktivieren und Deaktivieren personalisierter Werbung.

Wenn Ihre App jedoch noch keinen Zustimmungsmodus verwendet, können Sie die Personalisierung mit der folgenden Option steuern.

Um personalisiertes Werbeverhalten standardmäßig zu deaktivieren, setzen Sie den Wert von GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS in der Info.plist Datei Ihrer App auf NO (Boolean).

Aktivieren Sie personalisierte Werbefunktionen über eine Benutzereigenschaft erneut

Wenn Sie den Parameter AnalyticsUserPropertyAllowAdPersonalizationSignals verwenden, um die Anzeigenpersonalisierung zu steuern, können Sie die Anzeigenpersonalisierung mit der setUserProperty -Methode wie unten gezeigt wieder aktivieren:

Schnell

Hinweis: Dieses Firebase-Produkt ist auf dem macOS-Ziel nicht verfügbar.
Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)

Ziel c

Hinweis: Dieses Firebase-Produkt ist auf dem macOS-Ziel nicht verfügbar.
[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];

Wenn Sie sich dafür entschieden haben, die Analyseerfassung vorübergehend zu deaktivieren (z. B. bis ein Endbenutzer seine Einwilligung erteilt) und Sie die personalisierten Werbefunktionen steuern möchten, nachdem Sie die Analyseerfassung für einen Benutzer erneut aktiviert haben, stellen Sie sicher, dass Ihr Anruf zum Festlegen dieser Einstellung vor Ihrem Aufruf erfolgt Aufruf zum erneuten Aktivieren der Analysesammlung. Zum Beispiel:

Schnell

Hinweis: Dieses Firebase-Produkt ist auf dem macOS-Ziel nicht verfügbar.
Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)

Ziel c

Hinweis: Dieses Firebase-Produkt ist auf dem macOS-Ziel nicht verfügbar.
[FIRAnalytics setUserPropertyString:... forName:kFIRUserPropertyAllowAdPersonalizationSignals];
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Bestätigen Sie Ihre Einstellungen

Wenn Anzeigenpersonalisierungssignale für einen Benutzer über einen der oben definierten Mechanismen deaktiviert wurden, enthalten nachfolgende Ereignispakete, die vom Gerät dieses Benutzers protokolliert werden, eine Benutzereigenschaft namens non_personalized_ads mit dem Wert 1, um anzugeben, dass Ereignisse in diesem Paket nicht für die Personalisierung verfügbar sind Werbung. Die Deaktivierung personalisierter Werbung hat keinen Einfluss auf die Verwendung der Daten zu Messzwecken, einschließlich Berichterstellung und Zuordnung.

Sehen Sie sich Ihre Konfigurationsänderungen an

Sobald Sie Änderungen an Ihren 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 die Bereitstellung in Ihrer App einige Minuten dauern. Wenn Ihre App live ist, kann der vollständige Bereitstellungsprozess bis zu einer Stunde dauern.