Targeting

Plattform auswählen: Android iOS Unity Flutter Android (alt)

In diesem Leitfaden wird erläutert, wie Sie Targeting-Informationen für eine Anzeigenanfrage bereitstellen.

Wenn Sie sich das Anzeigen-Targeting in Aktion ansehen möchten, laden Sie die iOS API-Demo-App in Swift oder Objective-C herunter.

API-Demo herunterladen

Vorbereitung

Bevor Sie fortfahren, richten Sie Google Mobile Ads SDK ein.

GADRequestConfiguration

GADRequestConfiguration ist ein Objekt, das Targeting-Informationen erfasst, die global über die freigegebene Instanz GADMobileAds angewendet werden. Der Zugriff erfolgt über den folgenden Code:

Swift

let requestConfiguration = MobileAds.shared.requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

Damit die Änderungen an der Anfragekonfiguration für alle Anzeigenanfragen gelten, müssen Sie die Anfragekonfiguration festlegen, bevor Sie Google Mobile Ads SDK initialisieren.

Alterskennzeichnung festlegen

Damit Sie die geltenden Datenschutzbestimmungen für Kinder und Jugendliche einhalten können, bietet Google Mobile Ads SDK eine Einstellung für die Altersbehandlung. Mit der Einstellung für die Alterskennzeichnung können Sie angeben, ob Google Mobile Ads SDK bestimmte Schutzmaßnahmen für die Anzeigenbereitstellung für Kinder, Jugendliche oder ein nicht angegebenes Alter anwenden soll.

Sie können die Alterskennzeichnung mit dem Attribut ageRestrictedTreatment für GADRequestConfiguration festlegen.

Im folgenden Beispiel wird angegeben, dass Anzeigenanfragen als Inhalte für Kinder gekennzeichnet werden sollen:

Swift

// Indicates that ad requests should have child age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .child
RequestConfigurationSnippets.swift

Wenn Sie die Alterskennzeichnung für Teenager oder nicht angegebene Altersgruppen festlegen möchten, ersetzen Sie die Einstellung .child durch Folgendes:

• .teen
• .unspecified

Objective-C

// Indicates that ad requests should have child age treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment =
    GADAgeRestrictedTreatmentChild;
RequestConfigurationSnippets.m

Wenn Sie die Alterskennzeichnung für Teenager oder nicht angegebene Alterskennzeichnungen angeben möchten, ersetzen Sie die Einstellung GADAgeRestrictedTreatmentChild durch Folgendes:

• GADAgeRestrictedTreatmentTeen
• GADAgeRestrictedTreatmentUnspecified

Wenn Sie die Einstellung verwenden, fügt Google Mobile Ads SDK den Anzeigenanfragen den Parameter tfat hinzu. Lassen Sie sich von Ihrem Rechtsbeistand beraten, um das Mindestalter für Ihre Nutzer basierend auf Ihren rechtlichen und regulatorischen Verpflichtungen festzulegen. Weitere Informationen finden Sie unter Anzeigenanfragen aus Apps als Inhalte mit Altersbeschränkung kennzeichnen.

Von TFCD und TFUA zur Alterskennzeichnung migrieren

Die Einstellung für die Alterskennzeichnung ersetzt die veralteten Attribute tagForChildDirectedTreatment (TFCD) und tagForUnderAgeOfConsent (TFUA).

In der folgenden Tabelle sind die Einstellungen tagForChildDirectedTreatment und tagForUnderAgeOfConsent sowie die entsprechenden Altersbehandlungen aufgeführt:

TFCD

tagForChildDirectedTreatment	Alterskennzeichnung
tagForChildDirectedTreatment = true	GADAgeRestrictedTreatmentChild
tagForChildDirectedTreatment = false	GADAgeRestrictedTreatmentUnspecified
tagForChildDirectedTreatment wurde kein Wert zugewiesen	GADAgeRestrictedTreatmentUnspecified
Kein Äquivalent	GADAgeRestrictedTreatmentTeen

TFUA

tagForUnderAgeOfConsent	Alterskennzeichnung
tagForUnderAgeOfConsent = true	GADAgeRestrictedTreatmentChild
tagForUnderAgeOfConsent = false	GADAgeRestrictedTreatmentUnspecified
tagForUnderAgeOfConsent wurde kein Wert zugewiesen	GADAgeRestrictedTreatmentUnspecified
Kein Äquivalent	GADAgeRestrictedTreatmentTeen

Interaktionen der Alterskennzeichnung mit TFCD und TFUA

Wenn Sie die Einstellung für die Alterskennzeichnung und die TFCD- oder TFUA-Einstellungen festlegen, verwendet Google bei der Verarbeitung von Anzeigenanfragen jeweils die konservativste Variante.

Hinweis: Bei Nutzern, die in Google-Konten angemeldet sind, die mit Family Link verwaltet werden, werden alle Inhalte bei allen Anzeigenanfragen automatisch als auf Kinder ausgerichtet behandelt.

Alterskennzeichnung mit AdMob Mediation weiterleiten

Wenn Sie die Alterskennzeichnung mit Google Mobile Ads SDK festlegen, leiten Vermittlungsadapter das Signal für die Alterskennzeichnung an vermittelte Drittanbieter-SDKs weiter.

In der folgenden Tabelle sind die Versionen der Vermittlungsadapter aufgeführt, die die Weiterleitung des Signals für die Behandlung von Inhalten mit Altersbeschränkung an das vermittelte SDK eines Drittanbieters unterstützen:

Name des Vermittlungsadapters	Unterstützte Mindestversion
AppLovin	13.6.3.0
BidMachine	3.6.1.1
Bigo	5.2.1.0
Chartboost	9.12.0.1
DTExchange (Fyber)	8.4.7.1
i-mobile	2.3.4.7
InMobi	11.2.0.1
IronSource	9.4.1.0.1
Liftoff Monetize (Vungle)	7.7.2.1
LY Ads (Line Ads)	3.0.1.1
maio	2.2.1.2
Meta (Facebook)	6.21.1.1
Mintegral	8.1.3.1
Moloco	4.6.1.1
MyTarget	5.43.0.0
Pangle	7.9.1.1.1
PubMatic	5.1.0.1
Verve	3.8.1.1

Einstellung für Inhalte, die speziell für Kinder bestimmt sind

Warnung: Das Attribut tagForChildDirectedTreatment wird nicht mehr unterstützt. Legen Sie stattdessen das Attribut ageRestrictedTreatment fest.

Für die Zwecke des US-Gesetzes zum Schutz der Privatsphäre von Kindern im Internet (COPPA) gibt es die Einstellung tagForChildDirectedTreatment.

Als App-Entwickler können Sie angeben, ob Google bei einer Anzeigenanfrage Ihre Inhalte als auf Kinder ausgerichtet klassifizieren soll. Wenn Sie angeben, dass Google Ihre Inhalte als auf Kinder ausgerichtet einstufen soll, deaktiviert Google interessenbezogene Werbung und Remarketing-Anzeigen für diese Anzeigenanfrage. Folgende Optionen sind verfügbar:

• Setzen Sie tagForChildDirectedTreatment auf true, um anzugeben, dass Ihre Inhalte gemäß COPPA als auf Kinder ausgerichtet eingestuft werden sollen. Dadurch wird die Übertragung der Werbe-ID (IDFA) verhindert.
• Setzen Sie tagForChildDirectedTreatment auf false, um anzugeben, dass Ihre Inhalte im Sinne von COPPA nicht als auf Kinder ausgerichtet eingestuft werden sollen.
• Legen Sie tagForChildDirectedTreatment nicht fest, wenn Sie nicht angeben möchten, wie Ihre Inhalte im Hinblick auf COPPA behandelt werden sollen.

Im folgenden Beispiel wird angegeben, dass Ihre Inhalte gemäß COPPA als Inhalte speziell für Kinder eingestuft werden sollen:

Swift

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

Durch das Setzen dieses Tags bestätigen Sie, dass diese Benachrichtigung korrekt ist und Sie berechtigt sind, im Namen des Inhabers der App zu handeln. Ihnen ist bewusst, dass ein Missbrauch dieser Einstellung zur Kündigung Ihres Google-Kontos führen kann.

Nutzer, die das gültige Mindestalter noch nicht erreicht haben

Warnung: Das Attribut tagForUnderAgeOfConsent wird nicht mehr unterstützt. Legen Sie stattdessen das Attribut ageRestrictedTreatment fest.

Sie können Ihre Anzeigenanfragen zur Verarbeitung für Nutzer im Europäischen Wirtschaftsraum (EWR), die das gültige Mindestalter noch nicht erreicht haben, kennzeichnen. Mit dieser Funktion soll die Einhaltung der EU-Datenschutz-Grundverordnung (DSGVO) erleichtert werden. Möglicherweise gelten für Sie im Rahmen der DSGVO weitere rechtliche Verpflichtungen. Lesen Sie die Richtlinien der Europäischen Union und wenden Sie sich gegebenenfalls an Ihren Rechtsbeistand. Die Tools von Google sollen die Einhaltung gesetzlicher Bestimmungen erleichtern. Sie entbinden Publisher nicht von ihren gesetzlichen Pflichten. Weitere Informationen zu den Auswirkungen der DSGVO für Publisher

Wenn Sie diese Funktion verwenden, wird der Parameter „Tag For Users under the Age of Consent in Europe“ (TFUA) in alle zukünftigen Anzeigenanfragen aufgenommen. Mit diesem Parameter werden personalisierte Anzeigen, einschließlich Remarketing, für die jeweilige Anzeigenanfrage deaktiviert. Außerdem werden Anfragen an Drittanbieter deaktiviert, z. B. Tracking-Pixel zur Messung der Anzeigenleistung und Ad-Server eines Drittanbieters.

Die Einstellung kann mit allen Versionen von Google Mobile Ads SDK verwendet werden. Dazu muss das Attribut tagForUnderAgeOfConsent für das Objekt GADMobileAds.requestConfiguration festgelegt und true übergeben werden.

• Legen Sie für tagForUnderAgeOfConsent den Wert true fest, um anzugeben, dass Anzeigenanfragen so verarbeitet werden sollen, dass sie für Nutzer geeignet sind, die das Mindestalter noch nicht erreicht haben. Dadurch wird auch die Übertragung der Werbe-ID (IDFA) verhindert.
• Wenn Sie tagForUnderAgeOfConsent nicht festlegen, bedeutet das, dass Anzeigenanfragen nicht so behandelt werden sollen, wie es für Nutzer unter dem Mindestalter erforderlich ist.

Im folgenden Beispiel wird angegeben, dass TFUA in der Anzeigenanfrage enthalten sein soll:

Swift

MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

Die Tags zum Aktivieren der Einstellung „Inhalte für Kinder“ und tagForUnderAgeOfConsent sollten nicht gleichzeitig auf true gesetzt sein. Sollte dieser Fall auftreten, hat die Einstellung „An Kinder gerichtet“ Vorrang.

Wichtiger Hinweis: Dieser tagForUnderAgeOfConsent-Parameter wird nicht an Vermittlungsadapter für Anzeigenquellen von Drittanbietern weitergeleitet. Sie sind dafür verantwortlich, dass jedes Drittanbieter-Werbenetzwerk in Ihrer App Anzeigen ausliefert, die für Nutzer geeignet sind, die das gemäß DSGVO erforderliche Mindestalter noch nicht erreicht haben.

Filtern von Anzeigeninhalten

In Apps kann mit der Property maxAdContentRating von GADRequestConfiguration eine höchste Altersfreigabe für Anzeigeninhalte für alle Anzeigenanfragen festgelegt werden. Diese Einstellung gilt für alle zukünftigen Anzeigenanfragen für den Rest der Sitzung. Die möglichen Werte für dieses Attribut basieren auf Klassifizierungen von Labels für digitale Inhalte und sollten eine der folgenden Konstanten sein:

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

Mit dem folgenden Code werden alle Anzeigenanfragen so konfiguriert, dass die zurückgegebenen Anzeigeninhalte einem Label für digitale Inhalte entsprechen, das nicht höher als GADMaxAdContentRatingGeneral ist.

Wichtiger Hinweis: Die über das SDK festgelegten Filtereinstellungen für die Altersfreigabe überschreiben alle Einstellungen, die über die AdMob-Benutzeroberfläche konfiguriert wurden.

Swift

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

Publisher Privacy Treatment (Beta)

Die Publisher Privacy Treatment API (PPT API) ist ein optionales Tool, mit dem Apps angeben können, ob personalisierte Anzeigen für alle Anzeigenanfragen deaktiviert werden sollen. Dazu wird die Property publisherPrivacyPersonalizationState von GADRequestConfiguration verwendet. Wenn Sie diese Funktion verwenden, wird für den Rest der Sitzung in alle zukünftigen Anzeigenanfragen ein PPT-Parameter (Publisher Privacy Treatment) aufgenommen.

Standardmäßig werden bei Anzeigenanfragen an Google personalisierte Anzeigen ausgeliefert. Mit dem folgenden Code wird die Personalisierte Werbung für alle Anzeigenanfragen deaktiviert:

Swift

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

Hinweis: Bei Anzeigenanfragen mit mehreren Datenschutzsignalen für Nutzerinnen und Nutzer hat das restriktivste Signal Vorrang. Spezifische Beispiele finden Sie in der Dokumentation zur Publisher Privacy Treatment API.

GADRequest

Das GADRequest-Objekt erfasst Targeting-Informationen, die mit einer Anzeigenanfrage gesendet werden sollen.

Netzwerk-Extras hinzufügen

Netzwerk-Extras sind zusätzliche Details, die mit einer Anzeigenanfrage gesendet werden und sich auf eine einzelne Anzeigenquelle beziehen.

Im folgenden Code-Snippet wird ein zusätzlicher Parameterschlüssel collapsible mit dem Wert bottom für Google festgelegt:

Swift

let request = Request()
let extras = Extras()
extras.additionalParameters = ["collapsible": "bottom"]
request.register(extras)
adLoader?.load(request)

Objective-C

GADRequest *request = [GADRequest request];
GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{@"collapsible": @"bottom"};
[request registerAdNetworkExtras:extras];
[self.adLoader loadRequest:request];

Inhalts-URL

Wenn eine Anzeige angefordert wird, können Apps die URL des Inhalts übergeben, den sie bereitstellen. So kann die Anzeige mithilfe von Keyword-Targeting auf die Inhalte abgestimmt werden.

Wenn deine App beispielsweise eine Anzeige anfordert, während Inhalte von https://www.example.com angezeigt werden, kannst du diese URL übergeben, um relevante Keywords anzusprechen:

Swift

let request = Request()
request.contentURL = "https://www.example.com"

Objective-C

GADRequest *request = [GADRequest request];
request.contentURL = @"https://www.example.com";

FAQ

Welches Targeting wird verwendet, wenn eine Anzeige automatisch aktualisiert wird?

Bei der Anzeigenaktualisierung wird das zuvor angegebene GADRequest-Objekt wieder für das Targeting verwendet. Wenn Sie ein neues Targeting festlegen möchten, rufen Sie loadRequest explizit für GADBannerView mit einem neuen GADRequest-Objekt auf.

Wie übergebe ich zusätzliche Targeting-Parameter an Vermittlungsnetzwerke?

Unter Vermittlung erfahren Sie, wie Sie Targeting-Informationen an Vermittlungsnetzwerke senden.