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 weiterhin 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. Die Parameter gdpr= und gdpr_consent= müssen weiterhin in der URL des Anzeigen-Tags übergeben werden.
Wenn die automatische TCF-basierte Ermittlung nicht ausreicht, legen Sie das Attribut forceLimitedAds 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 setzen, werden keine Nutzer-IDs im Nonce gespeichert oder an den Server gesendet.
Wenn Sie die forceLimitedAds-Eigenschaft auf einen true-Wert festlegen, ist das dasselbe wie das Hinzufügen des ltd=1-Parameters zur Anzeigenanfrage-URL in IMA SDKs (Interactive Media Ads). Weitere Informationen zum eingeschränkten Anzeigen-Targeting finden Sie unter ltd (Eingeschränktes Anzeigen-Targeting).
Wenn Sie die Eigenschaft forceLimitedAds auf einen true-Wert 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änktes Anzeigen-Targeting aktiviert wurde. Die Property forceLimitedAds hat standardmäßig den Wert false, wodurch das eingeschränkte Anzeigen-Targeting nicht aktiviert wird.
PAL-Implementierung für TCF-basierte Bestimmung aktualisieren
Für PAL Android ist eine Aktion erforderlich, wenn Sie auf Version 23.0.0 aktualisieren. Mit dieser Version kann PAL TCF-Daten vom Gerät lesen, 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 Anzeigenausrichtung oder Erstanbieter-IDs 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 Kennungen in den Nonce aufnehmen, der in der Anzeigenanfrage an den Server verwendet wird. Ad Manager kann die Signale jedoch basierend auf den Einstellungen in Ad Manager verwerfen.
Die APIs sind:
disableLimitedAdsStorage: Deaktiviert Kennungen zur Erkennung ungültigen Traffics und die lokale Speicherung für Anzeigen mit eingeschränktem Anzeigen-Targeting. Wenn Sie die Einstellung Programmatisch eingeschränktes Anzeigen-Targeting in Ad Manager unter Verwaltung > Globale Einstellungen aktualisiert haben, verwenden Sie diese API, um die Verwendung des lokalen Speichers für eingeschränkte Anzeigen in PAL zu deaktivieren. Hinweis: Diese Einstellung gilt nicht für Anzeigen, die nicht eingeschränkt sind.disableFirstPartyIdentifiers: Hiermit werden eigene Kennungen deaktiviert, 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, können Sie diese API verwenden, um solche Kennungen in PAL zu deaktivieren. Diese Einstellung gilt nicht für die Verwendung von Kennzeichnungen und lokalem Speicher zur Erkennung ungültigen Traffics.
Nutzereinwilligung in Ihrer App verarbeiten
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);