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 unter Einwilligungsmodus – Übersicht.
Google Analytics bietet den Einwilligungsmodus, um das Verhalten Ihres SDK an den Einwilligungsstatus der Nutzer anzupassen. Sie können den Einwilligungsmodus sowohl einfach als auch fortgeschrittener 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 für Einwilligungseinstellungen, um die Nutzereinwilligung einzuholen
Einwilligungsmodus einrichten
So richten Sie den Einwilligungsmodus ein:
Standardstatus für die Einwilligung festlegen
Standardmäßig sind keine Werte für den Einwilligungsmodus festgelegt. So legen Sie den standardmäßigen Einwilligungsstatus für Ihre App fest:
- Öffnen Sie die Datei info.plist Ihrer Anwendung.
Fügen Sie die Schlüssel/Wert-Paare für den Einwilligungsmodus hinzu. Der Schlüssel beschreibt die Einwilligungsart und der Wert gibt den Einwilligungsstatus an. Mögliche Werte sind
true
, was bedeutet, dass die Einwilligung erteilt wurde, oderfalse
, was bedeutet, dass die Einwilligung verweigert wurde.Gemäß den Änderungen am Einwilligungsmodus für Traffic im Europäischen Wirtschaftsraum (EWR) kann für
ad_user_data
undad_personalization
der Werteu_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
Speichern Sie die Änderungen. Implementieren Sie als Nächstes den Mechanismus zum Aktualisieren der Einwilligungswerte.
So legen Sie beispielsweise standardmäßig die gesamte 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/>
Einwilligung aktualisieren
Wenn Sie die Einwilligungswerte nach dem Start einer App aktualisieren möchten, rufen Sie die Methode setConsent
auf.
Der von der Methode setConsent
festgelegte Wert überschreibt die Standardeinstellung und bleibt für alle Anwendungsausfü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
. Damit die Einwilligungsentscheidung des Nutzers für personalisierte Werbung erhalten bleibt, müssen Sie den vorherigen Wert für personalisierte Werbung mitsetConsent
(Swift | Obj-C) wiederherstellen.
Das folgende Beispiel zeigt, wie die Methode setConsent
die verschiedenen Einwilligungswerte 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
Upgrade auf Version 2 des Einwilligungsmodus
Im Rahmen unserer kontinuierlichen Bemühungen um eine datenschutzfreundliche Umgebung für digitale Werbung verstärken wir die Maßnahmen zur Durchsetzung unserer Richtlinie zur Einwilligung der Nutzer in der EU.
Nutzer im Einwilligungsmodus müssen zusätzlich zum Anzeigen- und Analysespeicher zwei neue Parameter senden:
Aktualisieren Sie die info.plist-Datei Ihrer App um Folgendes:
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/> <key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>
Aktualisieren Sie Ihre Einwilligungsaufrufe so, dass sie die Parameter für Nutzerdaten und personalisierte Werbung enthalten:
Swift
Analytics.setConsent([ .analyticsStorage: .granted, .adStorage: .granted, .adUserData: .granted, .adPersonalization: .granted, ])
Objective-C
[FIRAnalytics setConsent:@{ FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted, FIRConsentTypeAdStorage : FIRConsentStatusGranted, FIRConsentTypeAdUserData : FIRConsentStatusGranted, FIRConsentTypeAdPersonalization : FIRConsentStatusGranted, }];
Einwilligungseinstellungen überprüfen
In der Xcode-Debugging-Konsole für Ihre App können Sie prüfen, ob Ihre Einwilligungseinstellungen wie vorgesehen funktionieren.
Gehen Sie so vor:
- Aktivieren Sie die ausführliche Protokollierung auf Ihrem Gerät.
Suchen Sie in der Xcode-Debugging-Konsole nach:
ad_storage
analytics_storage
ad_user_data
ad_personalization
Wenn beispielsweise der Anzeigenspeicher aktiviert ist, wird die folgende Meldung angezeigt:
ad_storage is granted.