Einstellungen für eingeschränkte Anzeigen und eigene Kennungen

Eingeschränktes Anzeigen-Targeting ermöglicht Apps die Auslieferung von Anzeigen, wenn Ihre Nutzer nicht in die Weitergabe personenbezogener Daten einwilligen. Im Modus für eingeschränktes Anzeigen-Targeting wird die Erhebung, Weitergabe und Verwendung personenbezogener Daten zur Anzeigenauswahl deaktiviert. Wenn Ihre Nutzer keine personenbezogenen Daten weitergeben möchten, können Anzeigen mit dieser Funktion trotzdem ausgeliefert werden.

In diesem Leitfaden wird beschrieben, wie Sie die Einstellungen für eingeschränkte Anzeigen in Ihrer App verwenden und das App-Verhalten an die globalen Einstellungen Ihres Google Ad Manager-Netzwerks anpassen.

Einstellungen für eingeschränktes Anzeigen-Targeting für Clients konfigurieren

In PAL-Version 23.0.0 wurde die Property forceLimitedAds eingeführt und die Property allowStorage entfernt. Diese Eigenschaft gehört zur Klasse ConsentSettings.

Ab Version 23.0.0 liest PAL TCF-Daten (Transparency & Consent Framework) vom Gerät, um festzustellen, ob die Nutzereinwilligung zur lokalen Speicherung vorliegt. Bisher war Ihre App dafür verantwortlich, die Einwilligung zur Speicherung einzuholen. Ihre App muss die Parameter gdpr= und gdpr_consent= weiterhin in der Anzeigen-Tag-URL übergeben.

Wenn die automatische TCF-basierte Ermittlung nicht ausreicht, legen Sie die forceLimitedAds-Property direkt in Ihrer App fest. Weitere Informationen finden Sie unter Publisher-Integration mit dem IAB Europe TCF. Wenn Sie die Eigenschaft forceLimitedAds auf den Wert true festlegen, werden keine Nutzer-IDs im Nonce gespeichert oder gesendet, das an den Server gesendet wird. Wenn Sie die forceLimitedAds-Eigenschaft auf einen true-Wert festlegen, ist das dasselbe, als wenn Sie den ltd=1-Parameter der Anzeigenanfrage-URL in IMA SDKs (Interactive Media Ads) hinzufügen. Weitere Informationen zum eingeschränkten Anzeigen-Targeting finden Sie unter ltd (Eingeschränktes Anzeigen-Targeting). Wenn Sie die Eigenschaft forceLimitedAds auf den Wert true festlegen, fügt PAL den Parameter ltd=1 in den Nonce ein.

Wenn Sie das aktuelle Verhalten in Ihrer App beibehalten möchten, müssen Sie möglicherweise Ihre Implementierung aktualisieren, auch wenn Sie die Property allowStorage zuvor nicht festgelegt hatten. Für die Property allowStorage wurde standardmäßig der Wert false festgelegt, wodurch eingeschränkte Anzeigen aktiviert wurden. Die Property forceLimitedAds hat standardmäßig den Wert false, wodurch kein eingeschränktes Anzeigen-Targeting aktiviert wird.

PAL-Implementierung für TCF-basierte Ermittlung aktualisieren

Bei der Aktualisierung auf Version 23.0.0 ist eine Aktion erforderlich, damit PAL für Android TCF-Daten vom Gerät lesen kann, um die Nutzereinwilligung zur lokalen Speicherung zu ermitteln. In dieser Version wird auch die Property forceLimitedAds hinzugefügt und die Property allowStorage entfernt. Aktualisieren Sie Ihre App nur dann, um die Property forceLimitedAds zu verwenden, wenn die TCF-basierte Aktivierung von eingeschränktem Anzeigen-Targeting nicht den Anforderungen Ihrer App entspricht. Weitere Informationen

Globale Google Ad Manager-Einstellungen anpassen

Wenn Sie die Ad Manager-Einstellungen Programmatisch eingeschränkte Anzeigen oder Eigene Kennungen für Anzeigen in Apps aktualisieren, verwenden Sie diese neuen APIs, um die Einstellungen in Ad Manager abzugleichen. Wenn Sie die APIs nicht verwenden, kann PAL die IDs in den Nonce aufnehmen, der in der Anzeigenanfrage an den Server verwendet wird. In Ad Manager werden die Signale jedoch möglicherweise basierend auf den Einstellungen in Ad Manager verworfen.

Die APIs sind:

  • disableLimitedAdsStorage: Deaktiviert Kennungen zur Erkennung von ungültigem Traffic und die lokale Speicherung für Anzeigen mit eingeschränkter Ausrichtung. Wenn Sie die Einstellung Programmatisch eingeschränktes Anzeigen-Targeting in Ad Manager unter Admin > Globale Einstellungen aktualisiert haben, verwenden Sie diese API, um die Verwendung des lokalen Speichers für eingeschränkte Anzeigen in PAL zu deaktivieren. Diese Einstellung gilt nicht für Anzeigen, die nicht eingeschränkt sind.
  • disableFirstPartyIdentifiers: Deaktiviert eigene Kennungen, die für die Anzeigenauswahl verwendet werden. Wenn Sie die Einstellung Eigene Kennungen für Anzeigen in Apps in Ad Manager unter Verwaltung > Globale Einstellungen aktualisiert haben, verwenden Sie diese API, um solche Kennungen in PAL zu deaktivieren. Diese Einstellung gilt nicht für die Verwendung von Kennzeichnungen und den lokalen Speicher zur Erkennung ungültigen Traffics.

Im folgenden Beispiel wird der Datenschutz und die Datennutzung in einer PAL-Implementierung behandelt:

ConsentSettings consentSettings = ConsentSettings.builder()
            .directedForChildOrUnknownAge(false)
            .build();
// PAL Android version 23.0.0 introduces
// `ConsentSettings.forceLimitedAds` and removes `ConsentSettings.allowStorage`.
// Best practice is to not set `forceLimitedAds` to allow PAL to automatically
// determine whether limited ads applies based on the TCF data.
// To enable limited ads regardless of the TCF determination, set the
// `forceLimitedAds` property to a `true` value.

GoogleAdManagerSettings adManagerSettings = GoogleAdManagerSettings.builder()
            // Add this line if the "Programmatic limited ads" toggle is turned
            // off in Ad Manager.
            .disableLimitedAdsStorage(true)
            // Add this line if the
            // "First party identifiers for ads on app" toggle is turned
            // off in Ad Manager.
            .disableFirstPartyIdentifiers(true)
            .build();

nonceLoader = new NonceLoader(this, consentSettings, adManagerSettings);