Einstellungen für eingeschränkte Anzeigen und eigene Kennungen

Mit eingeschränktem Anzeigen-Targeting können in Apps Anzeigen ausgeliefert werden, wenn Nutzer nicht einwilligen, personenbezogene Daten weiterzugeben. Im Modus für eingeschränktes Anzeigen-Targeting werden keine personenbezogenen Daten für die Anzeigenauswahl erhoben, weitergegeben oder verwendet. Wenn Nutzer sich gegen die Weitergabe personenbezogener Daten entscheiden, können mit dieser Funktion weiterhin Anzeigen ausgeliefert werden.

In diesem Leitfaden wird beschrieben, wie Sie die Einstellungen für eingeschränktes Anzeigen-Targeting 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 3.0.0 wurde die Property forceLimitedAds eingeführt und die Property allowStorage entfernt. Diese Property befindet sich in der PALSettings Klasse.

Ab Version 3.0.0 liest PAL Daten aus dem Transparency and Consent Framework (TCF) vom Gerät, um festzustellen, ob die Nutzereinwilligung zur lokalen Speicherung vorliegt. Zuvor war Ihre App für die Bestimmung der Einwilligung zur Speicherung verantwortlich. Ihre App muss weiterhin die Parameter gdpr= und gdpr_consent= in der URL des Anzeigen-Tags übergeben.

Wenn die automatische TCF-basierte Bestimmung 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 Property forceLimitedAds auf true setzen, werden in PAL keine Nutzerkennungen im Nonce gespeichert oder an den Server gesendet. Wenn Sie die Property forceLimitedAds auf true setzen, entspricht das dem Hinzufügen des Parameters ltd=1 zur URL der Anzeigenanfrage in IMA SDKs (Interactive Media Ads). Weitere Informationen zu eingeschränktem Anzeigen-Targeting finden Sie unter ltd (Eingeschränktes Anzeigen-Targeting). Wenn Sie die Property forceLimitedAds auf true setzen, fügt PAL den Parameter ltd=1 in das 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 Property allowStorage hatte standardmäßig den Wert false, wodurch das eingeschränkte Anzeigen-Targeting aktiviert wurde. Die forceLimitedAds Property hat standardmäßig den false Wert, wodurch das eingeschränkte Anzeigen-Targeting nicht aktiviert wird.

PAL-Implementierung für die TCF-basierte Bestimmung aktualisieren

Bei der Aktualisierung auf Version 3.0.0 von PAL für tvOS sind Maßnahmen erforderlich. Mit dieser Version kann PAL TCF-Daten vom Gerät lesen, um festzustellen, ob die Nutzereinwilligung zur lokalen Speicherung vorliegt. Außerdem wird in dieser Version die Property forceLimitedAds hinzugefügt und die Property allowStorage entfernt. Aktualisieren Sie Ihre App nur, um die Property forceLimitedAds zu verwenden, wenn die TCF-basierte Aktivierung des eingeschränkten Anzeigen-Targetings nicht den Anforderungen Ihrer App entspricht. Weitere Informationen zur TCF-basierten Bestimmung finden Sie unter Publisher-Integration mit dem IAB Europe TCF.

Globale Einstellungen von Google Ad Manager anpassen

Wenn Sie die Ad Manager-Einstellungen Programmatisch eingeschränktes Anzeigen-Targeting oder Eigene Kennungen für Anzeigen in Apps, verwenden Sie diese neuen APIs, um die Einstellungen in Ad Manager anzupassen. Wenn Sie die APIs nicht verwenden, kann PAL die Kennungen in das Nonce einfügen, das 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, die nur zur Erkennung ungültigen Traffics verwendet werden, und die lokale Speicherung für eingeschränktes Anzeigen-Targeting. 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 der lokalen Speicherung für eingeschränktes Anzeigen-Targeting in PAL zu deaktivieren. Diese Einstellung gilt nicht für nicht eingeschränktes Anzeigen-Targeting.
  • 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 Admin > Globale Einstellungen aktualisiert haben, verwenden Sie diese API, um solche Kennungen in PAL zu deaktivieren. Diese Einstellung gilt nicht für die Verwendung von Kennungen und lokaler Speicherung zur Erkennung ungültigen Traffics.

Im folgenden Beispiel wird die Verarbeitung von Datenschutz und Datennutzung in einer PAL-Implementierung veranschaulicht:

Objective-C

PALSettings *settings = [[PALSettings alloc] init];
// PAL tvOS version 3.0.0 introduces
// `PALSettings.forceLimitedAds` and removes `PALSettings.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.

settings.directedForChildOrUnknownAge = NO;

PALGoogleAdManagerSettings *adManagerSettings = [[PALGoogleAdManagerSettings alloc] init];
// Add this line if the "Programmatic limited ads" toggle is turned off in
// Ad Manager.
adManagerSettings.disableLimitedAdsStorage = YES;
// Add this line if the "First party identifiers for ads on app" toggle
// is turned off in Ad Manager.
adManagerSettings.disableFirstPartyIdentifiers = YES;

self.nonceLoader = [[PALNonceLoader alloc] initWithSettings:settings
                                    googleAdManagerSettings:adManagerSettings];

Swift

let settings = PALSettings()
// PAL tvOS version 3.0.0 introduces
// `PALSettings.forceLimitedAds` and removes `PALSettings.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.

settings.directedForChildOrUnknownAge = false

let adManagerSettings = PALGoogleAdManagerSettings()
// 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 identifiers for ads on app" toggle
// is turned off in Ad Manager.
adManagerSettings.disableFirstPartyIdentifiers = true

self.nonceLoader = PALNonceLoader(
    settings: settings,
    googleAdManagerSettings: adManagerSettings
)