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.

Analytics-Datenerhebung deaktivieren

In einigen Fällen kann es sinnvoll sein, die Erhebung von Analytics-Daten vorübergehend oder dauerhaft zu deaktivieren, z. B. um die Einwilligung von Endnutzern einzuholen oder rechtliche Verpflichtungen zu erfüllen. Google Analytics bietet mehrere Optionen zum Deaktivieren und 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 Daten erhoben werden, können Sie den Wert von FIREBASE_ANALYTICS_COLLECTION_ENABLED in der Info.plist-Datei Ihrer App auf NO (boolescher Wert) festlegen. Beispiel für die Darstellung im Quell-XML:

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

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

Analytics.setAnalyticsCollectionEnabled(true)

[FIRAnalytics setAnalyticsCollectionEnabled:YES];

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.

Analytics.setAnalyticsCollectionEnabled(false)

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

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.

Sammlung endgültig 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 Erhebung 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 und führt zum gleichen Verhalten wie wenn FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED in Ihrer Info.plist-Datei nicht festgelegt ist.

IDFA-Erhebung deaktivieren

Wenn Sie das FirebaseAnalytics-Modul über SPM oder CocoaPods in Ihre App eingebunden haben und die Erfassung der IDFA (Werbe-ID eines Geräts) in Ihrer Apple-App deaktivieren möchten, muss das AdSupport-Framework aus Ihrer App entfernt werden.

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

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

pod 'FirebaseAnalytics/Core'

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

• Datenschutz und Datennutzung
• App-Tracking-Transparenz

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 von GOOGLE_ANALYTICS_IDFV_COLLECTION_ENABLED auf NO (Boolesch) fest.

Datenerhebung für personalisierte Anzeigen verwalten

Wenn Sie Ihr Google Analytics-Projekt mit einem Werbekonto verknüpft oder anderweitig eine Werbeeinbindung aktiviert oder der Datenweitergabe zugestimmt haben, können Ihre Analytics-Daten für Personalisierte Anzeigen verwendet werden. Das bedeutet beispielsweise, dass Sie erhobene Ereignisse wie first_open verwenden können, um Zielgruppenlisten für Remarketing zu erstellen und bereitzustellen, sofern Sie nicht angeben, dass solche Daten nicht für Personalisierte Anzeigen verfügbar sind.

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

• Empfohlen: Personalisierte Werbung dynamisch aktivieren oder deaktivieren, indem Sie die Einwilligung 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 Werbung auf Analytics-Property-Ebene aktivieren oder deaktivieren: Personalisierte Werbung in Ihrer Analytics-Property nach geografischer Region deaktivieren

Personalisierte Anzeigenfunktionen über eine Nutzereigenschaft deaktivieren

Die 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 Anzeigen standardmäßig deaktivieren möchten, legen Sie in der Info.plist-Datei Ihrer App den Wert von GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS auf NO (boolescher Wert) fest.

Personalisierte Anzeigenfunktionen über eine Nutzereigenschaft reaktivieren

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

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

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

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

Wenn Sie die Erhebung von Analysen vorübergehend deaktiviert haben (z. B. bis ein Endnutzer die Einwilligung erteilt), und Sie personalisierte Werbefunktionen steuern möchten, wenn die Erhebung von Analysen für einen Nutzer wieder aktiviert wird, muss der Aufruf zum Festlegen dieser Einstellung vor dem Aufruf zum Reaktivieren der Erhebung von Analysen 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 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 mit dem Namen non_personalized_ads und dem Wert 1. Dies gibt an, dass Ereignisse in diesem Bundle nicht für personalisierte Werbung verfügbar sind. Wenn Sie Personalisierte Anzeigen deaktivieren, hat das 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 live ist, kann der gesamte Bereitstellungsprozess bis zu einer Stunde dauern.