了解 2023 年 Google I/O 大会上介绍的 Firebase 亮点。了解详情

Konfigurieren Sie die Erfassung und Verwendung von Analytics-Daten

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 file 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).

Konfigurieren Sie die Verwendung von Analytics-Daten

Deaktivieren Sie personalisierte Werbefunktionen

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.

Um programmgesteuert zu steuern, ob die Analytics-Daten eines Benutzers für personalisierte Werbung verwendet werden sollen, legen Sie das entsprechende Standardverhalten in der Datei AndroidManifest.xml der App fest und verwenden Sie dann die unten beschriebenen Methoden, um dieses Standardverhalten zu überschreiben.

Um das standardmäßige personalisierte Werbeverhalten festzulegen, legen Sie in Info.plist Datei Ihrer App den Wert von GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS auf NO (Boolescher Wert) fest.

Sie können auch steuern, ob die von Endbenutzern gesammelten Daten für die Personalisierung von Anzeigen verwendet werden dürfen, indem Sie die Einstellungen für die Personalisierung von Anzeigen in den Eigenschafteneinstellungen von Google Analytics verwenden.

Aktivieren Sie personalisierte Werbefunktionen wieder

Um personalisierte Werbefunktionen für einen Benutzer zur Laufzeit wieder zu aktivieren, beispielsweise nachdem ein Endbenutzer seine Einwilligung gegeben hat, verwenden Sie die setUserProperty -Methode wie unten gezeigt:

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 verfügbar sind für personalisierte 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.