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 in der Übersicht zum Einwilligungsmodus.

In Google Analytics können Sie den Einwilligungsmodus verwenden, um das Verhalten des SDKs an den Einwilligungsstatus Ihrer Nutzer anzupassen. Sie können den Einwilligungsmodus auf einfache oder erweiterte Weise implementieren. Wenn Sie sich nicht sicher sind, ob Sie den einfachen oder den erweiterten Einwilligungs modus implementieren sollen, lesen Sie den Hilfeartikel Einfacher und erweiterter Einwilligungs modus und prüfen 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 zu erfassen

So richten Sie den Einwilligungsmodus ein:

  1. Legen Sie den Standardstatus für die Einwilligung fest.

Standardmäßig sind keine Werte für den Einwilligungsmodus festgelegt. So legen Sie den Standardstatus für die Einwilligung 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 Einwilligungs typ und der Wert gibt den Einwilligungsstatus an. Die Werte können entweder true (Einwilligung erteilt) oder false (Einwilligung verweigert) sein.

    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 verweigert wird, die der Richtlinie zur Einwilligung der Nutzer in der EU unterliegen.

    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.

Beispiel: So erteilen Sie standardmäßig die Einwilligung für alle Parameter:

<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 setConsent Methode auf.

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

Wenn ein Nutzer seine zuvor erteilte Einwilligung für Analytics oder den Speicher für Werbung widerruft, löscht Google Analytics alle Nutzerattribute, einschließlich der Einwilligung für ad_personalization. Wenn Sie die Einwilligung des Nutzers für die personalisierte Werbung beibehalten möchten, stellen Sie den vorherigen Wert für die personalisierte Werbung mit setConsent (Swift | Obj-C) wieder her.

Im folgenden Beispiel wird mit der Methode setConsent der Wert für die verschiedenen Einwilligungen 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 die Einwilligungsstatus entsprechend aktualisieren und die Datenerhebung in Analytics mit setAnalyticsCollectionEnabled() wieder deaktivieren.

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

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

Nutzer des Einwilligungsmodus müssen zusätzlich zum Speicher für Werbung und zum Speicher für Analytics zwei neue Parameter senden:

  1. Aktualisieren Sie die Datei „info.plist“ Ihrer App und fügen Sie 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 Einwilligungsaufrufe und fügen Sie die Parameter für Nutzerdaten für Werbung und personalisierte Werbung hinzu:

    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 überprüfen, ob Ihre Einwilligungseinstellungen wie gewünscht funktionieren, indem Sie die Debugkonsole von Xcode für Ihre App ansehen.

Gehen Sie so vor:

  1. Aktivieren Sie das ausführliche Logging auf Ihrem Gerät.

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

    • ad_storage
    • analytics_storage
    • ad_user_data
    • ad_personalization

    Wenn beispielsweise der Speicher für Werbung aktiviert ist, sehen Sie die folgende Meldung:

    ad_storage is granted.