Targeting

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

In dieser Anleitung wird beschrieben, wie Sie einer Anzeigenanfrage Targeting-Informationen hinzufügen.

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

Richten Sie Google Mobile Ads SDK ein, bevor Sie fortfahren.

GADRequestConfiguration

GADRequestConfiguration ist ein Objekt, das Targeting-Informationen erfasst, die global über die GADMobileAds freigegebene Instanz angewendet werden. Sie können mit dem folgenden Code darauf zugreifen:

Swift

let requestConfiguration = MobileAds.shared.requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

Damit die Änderungen an der Anforderungskonfiguration auf alle Anzeigenanfragen angewendet werden, legen Sie die Anforderungskonfiguration fest, bevor Sie initialisieren Google Mobile Ads SDK.

Alterskennzeichnung festlegen

Das Google Mobile Ads SDK bietet eine Einstellung für die Alterskennzeichnung, mit der Sie die Einhaltung der geltenden Datenschutzbestimmungen für Kinder und Jugendliche besser verwalten können. 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 ageRestrictedTreatment Attribut für GADRequestConfiguration festlegen.

Im folgenden Beispiel wird angegeben, dass Anzeigenanfragen eine Alterskennzeichnung für Kinder erhalten sollen:

Swift

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

Wenn Sie eine Alterskennzeichnung für Jugendliche oder ein nicht angegebenes Alter angeben 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 eine Alterskennzeichnung für Jugendliche oder ein nicht angegebenes Alter angeben möchten, ersetzen Sie die Einstellung GADAgeRestrictedTreatmentChild durch Folgendes:

• GADAgeRestrictedTreatmentTeen
• GADAgeRestrictedTreatmentUnspecified

Wenn Sie die Einstellung verwenden, Google Mobile Ads SDK fügt Anzeigenanfragen einen tfat Parameter hinzu. Lassen Sie sich von Ihrem Rechtsbeistand beraten, um das anwendbare Mindestalter für Ihre Nutzer auf Grundlage Ihrer 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 verworfenen tagForChildDirectedTreatment (TFCD) und tagForUnderAgeOfConsent (TFUA) Attribute.

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

TFCD

tagForChildDirectedTreatment	Alterskennzeichnung
tagForChildDirectedTreatment = true	GADAgeRestrictedTreatmentChild
tagForChildDirectedTreatment = false	GADAgeRestrictedTreatmentUnspecified
Kein Wert für tagForChildDirectedTreatment zugewiesen	GADAgeRestrictedTreatmentUnspecified
Kein Äquivalent	GADAgeRestrictedTreatmentTeen

TFUA

tagForUnderAgeOfConsent	Alterskennzeichnung
tagForUnderAgeOfConsent = true	GADAgeRestrictedTreatmentChild
tagForUnderAgeOfConsent = false	GADAgeRestrictedTreatmentUnspecified
Kein Wert für tagForUnderAgeOfConsent 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 für alle Anzeigenanfragen automatisch als für Kinder eingestuft.

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 Alterskennzeichnung an das vermittelte Drittanbieter-SDK 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 für Kinder

Warnung: Das Attribut tagForChildDirectedTreatment ist veraltet. Legen Sie stattdessen das ageRestrictedTreatment Attribut fest.

Für das US-Gesetz zum Schutz der Privatsphäre von Kindern im Internet (Children's Online Privacy Protection Act (COPPA), ) gibt es eine Einstellung namens 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 klassifizieren soll, ergreift Google Maßnahmen, um interessenbezogene Werbung und Remarketing-Anzeigen für diese Anzeigenanfrage zu deaktivieren. Die Einstellungsoptionen sind wie folgt:

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

Im folgenden Beispiel wird angegeben, dass Ihre Inhalte gemäß COPPA als auf Kinder ausgerichtet behandelt werden sollen:

Swift

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

Wenn Sie dieses Tag festlegen, bestätigen Sie, dass diese Mitteilung korrekt ist und Sie berechtigt sind, im Namen des Inhabers der App zu handeln. Sie sind sich bewusst, dass der Missbrauch dieser Einstellung zur Kündigung Ihres Google-Kontos führen kann.

Nutzer unter dem gültigen Mindestalter

Warnung: Das Attribut tagForUnderAgeOfConsent ist veraltet. Legen Sie stattdessen das Attribut ageRestrictedTreatment fest.

Sie können Ihre Anzeigenanfragen zur Verarbeitung für Nutzer im Europäischen Wirtschaftsraum (EWR) kennzeichnen, die das gültige Mindestalter noch nicht erreicht haben. Mit dieser Funktion soll die Einhaltung der Datenschutz-Grundverordnung (DSGVO) erleichtert werden. Unter Umständen gelten für Sie im Rahmen der DSGVO noch 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 auf Publisher.

Wenn Sie diese Funktion verwenden, wird allen zukünftigen Anzeigenanfragen der Parameter „Tag für Nutzer unter dem gültigen Mindestalter in Europa“ (TFUA) hinzugefügt. 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, indem Sie das Attribut tagForUnderAgeOfConsent für das GADMobileAds.requestConfiguration Objekt festlegen und true übergeben.

• Setzen Sie tagForUnderAgeOfConsent auf true, um anzugeben, dass Anzeigenanfragen so verarbeitet werden sollen, dass sie für minderjährige Nutzer geeignet sind. Dadurch wird auch die Übertragung der Werbe-ID (IDFA) verhindert.
• Wenn Sie tagForUnderAgeOfConsent nicht festlegen, werden Anzeigenanfragen nicht so verarbeitet, dass sie für minderjährige Nutzer geeignet sind.

Im folgenden Beispiel wird angegeben, dass Sie TFUA in Ihre Anzeigenanfrage aufnehmen möchten:

Swift

MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

Die Tags zum Aktivieren der Einstellung für Inhalte für Kinder und tagForUnderAgeOfConsent sollten nicht gleichzeitig auf true gesetzt sein. Sollte dieser Fall auftreten, hat die Einstellung für Inhalte für Kinder 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 gemäß DSGVO für Nutzer unter dem gültigen Mindestalter geeignet sind.

Filterung von Anzeigeninhalten

Apps können mit dem Attribut maxAdContentRating von GADRequestConfiguration eine höchste Altersfreigabe für Anzeigeninhalte für alle Anzeigenanfragen festlegen. 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 den Klassifizierungen von Labels für digitale Inhalteund müssen eine der folgenden Konstanten sein:

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

Mit dem folgenden Code wird konfiguriert, dass für alle Anzeigenanfragen angegeben wird, dass die zurückgegebenen Anzeigeninhalte einer Kennzeichnung für digitale Inhalte entsprechen müssen, die nicht höher als GADMaxAdContentRatingGeneral ist.

Wichtiger Hinweis: Einstellungen für den Filter für die Altersfreigabe von Inhalten, die über das SDK festgelegt wurden, ü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 (PPT) API ist ein optionales Tool, mit dem Apps angeben können, ob die Anzeigen personalisierung für alle Anzeigenanfragen deaktiviert werden soll. Dazu wird das publisherPrivacyPersonalizationState Attribut von GADRequestConfiguration verwendet. Wenn Sie diese Funktion verwenden, wird allen zukünftigen Anzeigenanfragen für den Rest der Sitzung ein PPT-Parameter hinzugefügt.

Standardmäßig werden für 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 Objekt GADRequest 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 für eine einzelne Anzeigenquelle spezifisch sind.

Mit dem 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

Beim Anfordern einer Anzeige können Apps die URL der Inhalte übergeben, die sie bereitstellen. Dadurch kann das Keyword-Targeting die Anzeige mit den Inhalten abgleichen.

Wenn Ihre App beispielsweise eine Anzeige anfordert, während Inhalte von https://www.example.com angezeigt werden, können Sie diese URL übergeben, um relevante Keywords zu targeten:

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 Aktualisierung der Anzeige wird das zuvor angegebene Objekt GADRequest wieder für das Targeting verwendet. Wenn Sie ein neues Targeting festlegen möchten, rufen Sie loadRequest für GADBannerView mit einem neuen Objekt GADRequest auf.

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

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