Einwilligungsmodus für Apps einrichten

Diese Seite richtet sich an Entwickler, die das Google Analytics for Firebase SDK in ihrer App verwenden und den Einwilligungsmodus einbinden möchten. Eine Einführung in den Einwilligungsmodus finden Sie im Hilfeartikel Einwilligungsmodus.

In Google Analytics gibt es den Einwilligungsmodus, mit dem sich das Verhalten Ihres SDKs an den Einwilligungsstatus der Nutzer anpassen lässt. Sie können den Einwilligungsmodus auf einfache oder erweiterte Weise implementieren. Wenn Sie sich nicht sicher sind, ob Sie den einfachen oder erweiterten Einwilligungsmodus implementieren sollen, lesen Sie die Informationen zum einfachen und zum erweiterten Einwilligungsmodus und lesen Sie die Richtlinien Ihres Unternehmens.

Hinweis

Bevor Sie die Nutzereinwilligung verwalten können, müssen Sie Folgendes implementieren:

  • Google Analytics for Firebase SDK

  • Ein Banner mit Einwilligungseinstellungen, um die Nutzereinwilligung einzuholen

So richten Sie den Einwilligungsmodus ein:

  1. Standardstatus für die Einwilligung festlegen

Standardmäßig sind keine Werte für den Einwilligungsmodus festgelegt. So legen Sie den Standard-Einwilligungsstatus für Ihre App fest:

  1. Öffnen Sie die Datei info.plist Ihrer App.

  2. Fügen Sie die Schlüssel/Wert-Paare für den Einwilligungsmodus hinzu. Der Schlüssel beschreibt den Einwilligungstyp und der Wert den Einwilligungsstatus. Die Werte können entweder true sein, was bedeutet, dass die Einwilligung erteilt wurde, oder false, was bedeutet, dass die Einwilligung abgelehnt wurde.

    Gemäß den Änderungen am Einwilligungsmodus für Traffic im Europäischen Wirtschaftsraum (EWR) kann für ad_user_data und ad_personalization der Wert eu_consent_policy festgelegt werden. Das bedeutet, dass die Einwilligung nur für Nutzer in Regionen abgelehnt wird, für die die Richtlinie zur Einwilligung der Nutzer in der EU gilt.

    Legen Sie Folgendes fest:

    • GOOGLE_ANALYTICS_DEFAULT_ALLOW_ANALYTICS_STORAGE
    • GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_STORAGE
    • GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA
    • GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS

  3. Speichern Sie die Änderungen. Implementieren Sie als Nächstes den Mechanismus zum Aktualisieren der Einwilligungswerte.

So legen Sie beispielsweise standardmäßig die Einwilligung für alle Parameter fest:

<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_ANALYTICS_STORAGE</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_STORAGE</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>

Wenn Sie die Einwilligungswerte nach dem Start einer App aktualisieren möchten, rufen Sie die Methode setConsent auf.

Der mit der setConsent-Methode festgelegte Wert überschreibt die Standardeinstellung und bleibt bei allen App-Ausführungen erhalten. Der Wert bleibt in diesem Status, bis setConsent noch einmal aufgerufen wird, auch wenn ein Nutzer die App schließt und wieder öffnet. setConsent aktualisiert nur die von Ihnen angegebenen Parameter.

Wenn ein Nutzer seine zuvor erteilte Einwilligung für Analytics oder die Anzeigenspeicherung widerruft, werden in Google Analytics alle Nutzereigenschaften gelöscht, einschließlich der Einwilligung für ad_personalization. Wenn Sie die Einwilligung des Nutzers für personalisierte Werbung beibehalten möchten, setzen Sie den vorherigen Wert für personalisierte Werbung mit setConsent (Swift | Obj-C) zurück.

Im folgenden Beispiel wird mit der Methode setConsent die Einwilligung in verschiedene Datennutzungen auf granted aktualisiert:

Swift

Analytics.setConsent([
  .analyticsStorage: .granted,
  .adStorage: .granted,
  .adUserData: .granted,
  .adPersonalization: .granted,
])

Objective-C

[FIRAnalytics setConsent:@{
  FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdUserData : FIRConsentStatusGranted,
  FIRConsentTypeAdPersonalization : FIRConsentStatusGranted,
}];

Wenn ein Nutzer seine Einwilligung widerruft, müssen Sie den Einwilligungsstatus entsprechend aktualisieren

Im Rahmen unserer kontinuierlichen Bemühungen um eine datenschutzkonforme Plattform für digitale Werbung verstärken wir die Maßnahmen zur Durchsetzung unserer Richtlinie zur Einwilligung der Nutzer in der EU.

Weitere Informationen zu den Änderungen am Einwilligungsmodus für Traffic im Europäischen Wirtschaftsraum (EWR)

Nutzer im Einwilligungsmodus müssen zusätzlich zum Speichern von Anzeigen und Analysedaten zwei neue Parameter senden:

  1. Fügen Sie der Info.plist Ihrer App Folgendes hinzu:

    <key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>

  2. Aktualisieren Sie Ihre Einwilligungsanfragen, um die Parameter für Daten von Anzeigennutzern und die Anzeigenpersonalisierung einzuschließen:

    Swift

    Analytics.setConsent([
.analyticsStorage: .granted,
.adStorage: .granted,
.adUserData: .granted,
.adPersonalization: .granted,
])

    Objective-C

    [FIRAnalytics setConsent:@{
  FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdUserData : FIRConsentStatusGranted,
  FIRConsentTypeAdPersonalization : FIRConsentStatusGranted,
}];

Sie können in der Xcode-Debugkonsole Ihrer App prüfen, ob Ihre Einwilligungseinstellungen wie vorgesehen funktionieren.

Gehen Sie so vor:

  1. Aktivieren Sie die ausführliche Protokollierung auf Ihrem Gerät.

  2. Suchen Sie in der Xcode-Debugkonsole nach Folgendem:

    • ad_storage
    • analytics_storage
    • ad_user_data
    • ad_personalization

    Wenn beispielsweise der Anzeigenspeicher aktiviert ist, wird die folgende Meldung angezeigt:

    ad_storage is granted.