Einstellungen für eingeschränkte Anzeigen und eigene Kennungen

Mit eingeschränkten Anzeigen können in Apps Anzeigen ausgeliefert werden, 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 für die 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 werden die Einstellungen aktualisiert, um die Kontrolle über den Datenschutz und die Datennutzung zu verbessern. In PAL-Version 1.90.0 wird die Property forceLimitedAds eingeführt und die vorhandene Property allowStorage wird eingestellt. Diese Eigenschaften befinden sich in der Klasse ConsentSettings.

Ab Version 1.90.0 liest PAL TCF-Daten (Transparency & Consent Framework) vom Gerät, um festzustellen, ob die Nutzereinwilligung zur lokalen Speicherung vorliegt. Durch diese Änderung beim Lesen von TCF-Daten wird das vorhandene Attribut allowStorage überflüssig. 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 Property forceLimitedAds direkt in Ihrer App fest. Weitere Informationen finden Sie unter Integration des IAB Europe TCF für Publisher. 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. Die vorhandene allowStorage-Property hat standardmäßig den Wert false, wodurch die eingeschränkte Anzeigenausrichtung aktiviert wird. Die Property forceLimitedAds hat standardmäßig den Wert false, wodurch keine eingeschränkte Anzeigenausrichtung aktiviert wird.

Update für Phase 1 der TCF-Ermittlung

Mit der Veröffentlichung von PAL HTML5 Phase 1 wird die Umstellung von der Property ConsentSettings.allowStorage auf die automatische TCF-basierte Bestimmung von eingeschränktem Anzeigen-Targeting vorbereitet.

Während dieser Übergangsphase berücksichtigt PAL die TCF-Daten des Nutzers, die vorhandene allowStorage-Property und die neueste forceLimitedAds-Property. In dieser Phase müssen Sie die Property allowStorage immer auf einen true-Wert festlegen, damit PAL anhand der TCF-Daten ermitteln kann, ob eingeschränkte Anzeigen infrage kommen. Wenn Sie die eingeschränkte Anzeigenbereitstellung unabhängig von der TCF-Entscheidung aktivieren möchten, legen Sie die Eigenschaft forceLimitedAds auf einen true-Wert fest.

In Phase 1 werden eingeschränkte Anzeigen unter den folgenden Umständen aktiviert:

  • Die Eigenschaft allowStorage ist ein false-Wert oder nicht festgelegt. Wir empfehlen, diese Einstellung nicht für die allowStorage-Property zu verwenden, da sie nur zur Unterstützung von Apps dient, die nicht aktualisiert wurden.
  • Die Property forceLimitedAds ist ein true-Wert.
  • PAL erkennt, dass keine Einwilligung für Zweck 1 des TCF des IAB (Interactive Advertising Bureau) vorliegt.

In der folgenden Tabelle sind alle möglichen Status und die Frage aufgeführt, ob die eingeschränkte Anzeigenbereitstellung aktiviert ist:

Einwilligung für TCF-Zweck 1 allowStorage Unterkunft forceLimitedAds Unterkunft Eingeschränktes Anzeigen-Targeting aktiviert
Gewährt Richtig Richtig Richtig
Nicht gewährt Richtig Richtig Richtig
Gewährt Richtig Falsch (Standard) Falsch
Nicht gewährt Richtig Falsch (Standard) Richtig
Gewährt Falsch (Standard) Richtig Richtig
Nicht gewährt Falsch (Standard) Richtig Richtig
Gewährt Falsch (Standard) Falsch (Standard) Richtig
Nicht gewährt Falsch (Standard) Falsch (Standard) Richtig

Vorbereitung auf die TCF-Bestimmung in Phase 2

Mit der Veröffentlichung von Phase 2 werden Funktionen aus dem Attribut allowStorage entfernt. Wir planen die Veröffentlichung von Phase 2 für den 10. März 2026, also 90 Tage nach der Veröffentlichung von Phase 1. Vor diesem Datum müssen Sie Ihre Implementierung aktualisieren, damit der Parameter ConsentSettings.forceLimitedAds verwendet wird.

In Phase 2 ermöglicht PAL eingeschränktes Anzeigen-Targeting, das ausschließlich auf dem Fehlen der Einwilligung für TCF-Zweck 1 und der optionalen Property ConsentSettings.forceLimitedAds basiert:

Einwilligung für TCF-Zweck 1 forceLimitedAds Unterkunft Eingeschränktes Anzeigen-Targeting aktiviert
Gewährt Richtig Richtig
Nicht gewährt Richtig Richtig
Gewährt Falsch (Standard) Falsch
Nicht gewährt Falsch (Standard) Richtig

Globale Google Ad Manager-Einstellungen anpassen

Wenn Sie die Ad Manager-Einstellungen Programmatisch eingeschränkte Anzeigenausrichtung oder Eigene Cookies für Anzeigen im Web aktualisieren, verwenden Sie diese neuen APIs, um die Einstellungen in Ad Manager zu übernehmen. 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 Cookies zur Erkennung ungültiger Zugriffe und die lokale Speicherung für Anzeigen mit eingeschränkter Ausrichtung. 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. Diese Einstellung gilt nicht für Anzeigen, die nicht eingeschränkt ausgeliefert werden.
  • disableFirstPartyIdentifiers: Damit werden eigene Kennungen deaktiviert, die für die Anzeigenauswahl verwendet werden. Wenn Sie die Einstellung Eigene Cookies für Anzeigen im Web in Ad Manager unter Admin > Global aktualisiert haben, verwenden Sie diese API, um solche Kennungen in PAL zu deaktivieren. Diese Einstellung gilt nicht für die Verwendung von Cookies und lokaler Speicherung zur Erkennung ungültiger Zugriffe.

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

const consentSettings = new goog.pal.ConsentSettings();
consentSettings.allowStorage = true;
// During the PAL Phase 1 release, best practice is to always set the
// `allowStorage` property to a `true` value 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.

const adManagerSettings = new goog.pal.GoogleAdManagerSettings();
// Add this line if the "Programmatic limited ads" toggle is turned off in
// Ad Manager.
adManagerSettings.disableLimitedAdsStorage = true;
// Add this line if the "First party cookies for ads on web" toggle
// is turned off in Ad Manager.
adManagerSettings.disableFirstPartyIdentifiers = true;

const nonceLoader = new goog.pal.NonceLoader(consentSettings, adManagerSettings);