Zum Inhalt springen
rdlabo.devdocs

Einwilligung

Das User Messaging Platform (UMP) SDK von Google ist das Datenschutz- und Messaging-Werkzeug zum Einholen der Einwilligung vor Anzeigenanfragen. Googles UMP-Anleitungen für Android und iOS erklären den Ablauf.

Dieses Plugin stellt UMP und iOS App Tracking Transparency über eine gemeinsame API bereit. Erstellen Sie vor der UMP-Nutzung Ihre DSGVO-Nachrichten in AdMob. Sie können außerdem Nachrichten für Identifier for Advertisers (IDFA) einrichten. Sind IDFA-Nachrichten veröffentlicht, zeigt UMP sie und die App-Tracking-Transparency-Abfrage an. Rufen Sie dann nicht zusätzlich requestTrackingAuthorization() auf.

Empfohlene Reihenfolge

  1. Rufen Sie AdMob.initialize() auf. Siehe Konfiguration.
  2. Rufen Sie AdMob.requestConsentInfo() auf.
  3. Rufen Sie bei Bedarf AdMob.showConsentForm() auf.
  4. Laden Sie Anzeigen nur, wenn consentInfo.canRequestAds true ist.
import { AdMob, AdmobConsentStatus } from '@capacitor-community/admob';

await AdMob.initialize();

let consentInfo = await AdMob.requestConsentInfo();
if (consentInfo.isConsentFormAvailable && consentInfo.status === AdmobConsentStatus.REQUIRED) {
  consentInfo = await AdMob.showConsentForm();
}

if (consentInfo.canRequestAds) {
  // Anzeigen können jetzt angefordert werden.
}

method requestConsentInfo(...)

Informationen zur Einwilligung des Nutzers anfordern

requestConsentInfo(options?: AdmobConsentRequestOptions | undefined) => Promise<AdmobConsentInfo>

interface AdmobConsentRequestOptions

Eigenschaft Typ Beschreibung Standard Seit
debugGeography AdmobConsentDebugGeography Legt die Debug-Geografie fest, um die Einwilligung lokal zu testen. 5.0.0
testDeviceIdentifiers string[] Ein Array zulässiger Testgeräte-IDs. Hinweis: Unter iOS kann die ID nach einer Deinstallation und Neuinstallation der App erneuert werden. 5.0.0
tagForUnderAgeOfConsent boolean Auf true setzen, um dem Nutzer die Möglichkeit zu geben, der Anzeige personalisierter Werbung zuzustimmen. false 5.0.0

interface AdmobConsentInfo

Eigenschaft Typ Beschreibung Seit
status AdmobConsentStatus Einwilligungsstatus des Nutzers. 5.0.0
isConsentFormAvailable boolean Bei true ist ein Einwilligungsformular verfügbar; andernfalls nicht. 5.0.0
canRequestAds boolean Bei true kann eine Anzeige angezeigt werden. 7.0.3
privacyOptionsRequirementStatus PrivacyOptionsRequirementStatus Status der erforderlichen Datenschutzoptionen des Nutzers. 7.0.3

enum AdmobConsentStatus

Mitglied Wert Beschreibung
NOT_REQUIRED 'NOT_REQUIRED' Die Einwilligung des Nutzers ist nicht erforderlich.
OBTAINED 'OBTAINED' Die Einwilligung des Nutzers liegt bereits vor.
REQUIRED 'REQUIRED' Die Einwilligung des Nutzers ist erforderlich, liegt aber noch nicht vor.
UNKNOWN 'UNKNOWN' Unbekannter Einwilligungsstatus. AdsConsent.requestInfoUpdate muss aufgerufen werden, um ihn zu aktualisieren.

method showConsentForm()

Zeigt ein Google-Einwilligungsformular an, das aus Ihrer Konfiguration für DSGVO-Meldungen erstellt wird.

showConsentForm() => Promise<AdmobConsentInfo>

Verwenden Sie canRequestAds als Entscheidungsgrundlage. Je nach Nutzer und konfigurierten Nachrichten kann ein Einwilligungsformular nicht verfügbar oder nicht erforderlich sein.

iOS-Tracking-Berechtigung

Wenn Sie keine UMP-IDFA-Nachrichten verwenden, fordern Sie App Tracking Transparency bei einem Status notDetermined selbst an. Überspringen Sie diesen Abschnitt, wenn Identifier-for-Advertisers-Nachrichten in AdMob eingerichtet sind; UMP zeigt diese Abfrage an.

const tracking = await AdMob.trackingAuthorizationStatus();
if (tracking.status === 'notDetermined') {
  /**
   * Wenn Sie Tracking vor dem iOS-Dialog erläutern möchten,
   * zeigen Sie hier Ihre eigene UI an und fahren Sie anschließend fort.
   */
  await AdMob.requestTrackingAuthorization();
}

requestTrackingAuthorization() hat unter Android, im Web und unter iOS-Versionen vor 14 keine Wirkung.

method trackingAuthorizationStatus()

Liefert unter iOS 14 und neuer den aktuellen App-Tracking-Transparency-Autorisierungsstatus.
Auf älteren iOS-Versionen, Android und im Web wird authorized zurückgegeben.

trackingAuthorizationStatus() => Promise<TrackingAuthorizationStatusInterface>

interface TrackingAuthorizationStatusInterface

Aktueller App-Tracking-Transparency-Autorisierungsstatus unter iOS.

Eigenschaft Typ Beschreibung
status 'authorized' | 'denied' | 'notDetermined' | 'restricted' Von App Tracking Transparency gemeldeter Autorisierungsstatus.

method requestTrackingAuthorization()

Fordert unter iOS 14 und neuer die App-Tracking-Transparency-Autorisierung an.
Auf älteren iOS-Versionen, Android und im Web wird der Aufruf ohne Aktion aufgelöst.

requestTrackingAuthorization() => Promise<void>

Datenschutzoptionen

Wenn Ihre Datenschutznachricht einen Einstiegspunkt in der Anwendung erfordert, bieten Sie eine Einstellungsaktion an, die Folgendes aufruft:

await AdMob.showPrivacyOptionsForm();

method showPrivacyOptionsForm()

Zeigt ein Google-Formular für Datenschutzoptionen an, das aus Ihrer Konfiguration für DSGVO-Meldungen erstellt wird.

showPrivacyOptionsForm() => Promise<void>

Einwilligung zurücksetzen

resetConsentInfo() ist für Tests gedacht. Verwenden Sie es nicht, um die Einwilligungsentscheidung eines Produktionsnutzers zu löschen.

method resetConsentInfo()

Setzt den Zustand des UMP SDK zurück. requestConsentInfo erneut aufrufen, damit der Nutzer seine Einwilligung ändern kann.

resetConsentInfo() => Promise<void>

Debug-Regionen und Testgeräte-IDs finden Sie unter Tests.

Diese Seite auf GitHub bearbeiten