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 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

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 standardmäßigen Einwilligungsstatus für Ihre App fest:

  1. Öffnen Sie die Datei AndroidManifest.xml Ihrer App.

  2. 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, oder false, was bedeutet, dass die Einwilligung verweigert wurde. 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 gesamte Einwilligung für alle Parameter fest:

<meta-data android:name="google_analytics_default_allow_analytics_storage" android:value="true" />
<meta-data android:name="google_analytics_default_allow_ad_storage" android:value="true" />
<meta-data android:name="google_analytics_default_allow_ad_user_data" android:value="true" />
<meta-data android:name="google_analytics_default_allow_ad_personalization_signals" android:value="true" />

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 mit setConsent (Kotlin+KTX | Java) wiederherstellen.

Das folgende Beispiel zeigt, wie die Methode setConsent die verschiedenen Einwilligungswerte auf granted aktualisiert:

Java

// Set consent types.
Map<ConsentType, ConsentStatus> consentMap = new EnumMap<>(ConsentType.class);
consentMap.put(ConsentType.ANALYTICS_STORAGE, ConsentStatus.GRANTED);
consentMap.put(ConsentType.AD_STORAGE, ConsentStatus.GRANTED);
consentMap.put(ConsentType.AD_USER_DATA, ConsentStatus.GRANTED);
consentMap.put(ConsentType.AD_PERSONALIZATION, ConsentStatus.GRANTED);

mFirebaseAnalytics.setConsent(consentMap);

Kotlin

Firebase.analytics.setConsent {
  analyticsStorage(ConsentStatus.GRANTED)
  adStorage(ConsentStatus.GRANTED)
  adUserData(ConsentStatus.GRANTED)
  adPersonalization(ConsentStatus.GRANTED)
}