Targeting

In diesem Leitfaden wird erläutert, wie Sie Ausrichtungsinformationen für eine Anzeigenanfrage angeben.

Wenn Sie das Anzeigen-Targeting in Aktion sehen 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, in dem Targeting-Informationen erfasst werden, die global über die freigegebene Instanz GADMobileAds angewendet werden. Sie können mit dem folgenden Code darauf zugreifen:

let requestConfiguration = MobileAds.shared.requestConfiguration

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

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

Alterskennzeichnung festlegen

Google Mobile Ads SDK bietet eine Einstellung für die Altersbehandlung, mit der Sie die Einhaltung der anwendbaren Datenschutzbestimmungen für Kinder und Jugendliche 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 Attribut ageRestrictedTreatment in GADRequestConfiguration festlegen.

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

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

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

Wenn Sie die Einstellung verwenden, enthält Google Mobile Ads SDK in Anzeigenanfragen einen tfat-Parameter. Lassen Sie sich von Ihrem Rechtsbeistand beraten, um die anwendbare Alterskennzeichnung für Ihre Nutzer basierend auf Ihren rechtlichen und regulatorischen Verpflichtungen festzulegen. Weitere Informationen finden Sie unter Anzeigenanfragen mit einem Tag für die Alterskennzeichnung versehen.

Von TFCD und TFUA zur Alterskennzeichnung migrieren

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

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

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.

Alterskennzeichnung mit Vermittlung 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 von Vermittlungsadaptern aufgeführt, die das Weiterleiten des Signals für die Behandlung von Inhalten mit Altersbeschränkung an das vermittelte Drittanbieter-SDK unterstützen:

Einstellung für Inhalte für Kinder

Für das US-Gesetz 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, ergreift Google Maßnahmen, um interessenbezogene Werbung und Remarketing-Anzeigen für diese Anzeigenanfrage zu deaktivieren. Folgende Einstellungsoptionen sind verfügbar:

• Legen Sie tagForChildDirectedTreatment auf true fest, um anzugeben, dass Ihre Inhalte gemäß COPPA als auf Kinder ausgerichtet behandelt werden sollen. Dadurch wird die Übertragung des Identifier for Advertising (IDFA) verhindert.
• Legen Sie tagForChildDirectedTreatment auf false fest, 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 in Bezug auf COPPA behandelt werden sollen.

Das folgende Beispiel zeigt, dass Ihre Inhalte gemäß COPPA als für Kinder bestimmt eingestuft werden sollen:

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

Durch das Festlegen 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

Sie können Ihre Anzeigenanfragen zur Verarbeitung für minderjährige Nutzer im Europäischen Wirtschaftsraum (EWR) kennzeichnen. Mit dieser Funktion soll die Einhaltung der EU-Datenschutz-Grundverordnung (DSGVO) erleichtert werden. Möglicherweise gelten für Sie im Rahmen der DSGVO noch weitere rechtliche Verpflichtungen. Lesen Sie sich die Richtlinien der Europäischen Union durch 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 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 von Drittanbietern.

Die Einstellung kann mit allen Versionen von Google Mobile Ads SDK verwendet werden. Dazu müssen Sie die Eigenschaft tagForUnderAgeOfConsent für das GADMobileAds.requestConfiguration-Objekt festlegen und true übergeben.

• Legen Sie tagForUnderAgeOfConsent auf true fest, um anzugeben, dass Anzeigenanfragen für Nutzer unter dem erforderlichen Mindestalter verarbeitet werden sollen. Dadurch wird auch die Übertragung der Werbe-ID (IDFA) verhindert.
• Wenn Sie tagForUnderAgeOfConsent nicht festlegen, werden Anfragen für Anzeigen nicht für Nutzer unter dem erforderlichen Mindestalter bearbeitet.

Im folgenden Beispiel wird angegeben, dass TFUA in Ihre Anzeigenanfrage aufgenommen werden soll:

MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true

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.

Anzeigeninhalte filtern

Apps können mit der maxAdContentRating-Property 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 diese Property basieren auf Klassifizierungen von Labels für digitalen Content und sollten eine der folgenden Konstanten sein:

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

Mit dem folgenden Code wird festgelegt, dass bei allen Anzeigenanfragen zurückgegebene Anzeigeninhalte ein Digital Content Label mit einer Einstufung von höchstens GADMaxAdContentRatingGeneral haben müssen.

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

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 Anzeigenpersonalisierung für alle Anzeigenanfragen mit der publisherPrivacyPersonalizationState-Eigenschaft von GADRequestConfiguration deaktiviert werden soll. Wenn Sie diese Funktion verwenden, wird in alle zukünftigen Anzeigenanfragen für den Rest der Sitzung ein Parameter für die Datenschutzbehandlung für Publisher (Publisher Privacy Treatment, PPT) eingefügt.

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

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

GAMRequest

Im GAMRequest-Objekt werden Targeting-Informationen erfasst, 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:

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

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. So kann die Anzeige mithilfe des Keyword-Targetings auf die Inhalte abgestimmt werden.

Wenn in Ihrer App beispielsweise eine Anzeige angefordert wird, während Inhalte von https://www.example.com angezeigt werden, können Sie diese URL übergeben, um relevante Keywords auszurichten:

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

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

Benutzerdefinierte Ausrichtung

Nachdem Sie Schlüssel/Wert-Paare in der Ad Manager-Benutzeroberfläche konfiguriert haben, legen Sie benutzerdefiniertes Targeting mit den Schlüsselwerten in einer Anzeigenanfrage fest. Werbebuchungen mit Targeting auf diese Schlüssel/Wert-Paare können dann für die Anzeigenanfrage ausgeliefert werden. Wenn Sie mehrere Werte für einen Schlüssel festlegen möchten, geben Sie die Werte als kommagetrennten String ein.

let request = AdManagerRequest()
request.customTargeting = ["gender" : "male", "section" : "health,fitness"];

GAMRequest *request = [GAMRequest request];
request.customTargeting = @{@"gender" : @"male", @"section" : @"health,fitness"};

Markensicherheit (Beta)

Apps, in denen dynamische Inhalte für unterschiedliche Zielgruppen präsentiert werden, können über die neighboringContentURLs-Property eine kurze Liste von URLs angeben. Die URLs für benachbarte Inhalte unterscheiden sich von der Property contentURL dadurch, dass sie nur aus Gründen der Markensicherheit verwendet werden.

Angenommen, in Ihrer App werden Inhalte von vier URLs in einem Feed angezeigt, der auch Anzeigen enthält. Sie können Anzeigen mit einer ähnlichen Altersfreigabe wie die der URLs anfordern, indem Sie sie so übergeben:

let request = AdManagerRequest()
request.neighboringContentURLs =
    ["https://www.example1.com", "https://www.example2.com",
    "https://www.example3.com", "https://www.example4.com"]

GAMRequest *request = [GAMRequest request];
request.neighboringContentURLs =
    @[@"https://www.example1.com", @"https://www.example2.com",
    @"https://www.example3.com", @"https://www.example4.com"];

Vom Publisher bereitgestellte Kennungen

Sie können eine vom Publisher bereitgestellte Kennung (Publisher Provided Identifier, PPID) für das Frequency Capping, die Zielgruppensegmentierung und das Targeting auf Zielgruppen, die sequenzielle Anzeigenrotation und andere Funktionen zur zielgruppenbasierten Anzeigenauslieferung auf beliebigen Geräten festlegen.

Die PPID wird über GAMRequest festgelegt:

let request = AdManagerRequest()
request.publisherProvidedID = "AB123456789"

GAMRequest *request = [GAMRequest request];
request.publisherProvidedID = @"AB123456789";

Ein Beispiel für die Implementierung von Publisher Provided Identifiers (PPIDs) in der iOS API-Demo-App finden Sie unter „Ad Manager PPID example“:

Swift Objective-C

Vom Publisher bereitgestellte Signale

Sie können Zielgruppen- und Kontextdaten als vom Publisher bereitgestellte Signale (Publisher Provided Signals, PPS) in Anzeigenanfragen senden. Mit PPS können Sie Ihre Nutzerdaten zur Verbesserung der programmatischen Monetarisierung verwenden, indem Sie Ihre Zielgruppenmerkmale mithilfe von Standardtaxonomien an Bieter in allen Transaktionstypen weitergeben, ohne Nutzerkennzeichnungen teilen zu müssen. Zu Ihren Zielgruppenmerkmalen können verhaltens- und interessenbezogene Daten (IAB-Taxonomie für Zielgruppen 1.1) und kontextbezogene Daten (IAB-Taxonomie für Inhalte 2.2) gehören.

let extras = Extras()
extras.additionalParameters = [
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    "IAB_AUDIENCE_1_1": [6, 284],
    // Set the content to sedan, station wagon and SUV automotive values.
    "IAB_CONTENT_2_2": [4, 5, 6]
]

let request = AdManagerRequest()
request.register(extras)

GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    @"IAB_AUDIENCE_1_1":@[@6, @284],
    // Set the content to sedan, station wagon and SUV automotive values.
    @"IAB_CONTENT_2_2":@[@4,@5,@6]
};

GAMRequest *request = [GAMRequest request];
[request registerAdNetworkExtras:extras];

FAQ

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

Beim Aktualisieren der Anzeige wird das zuvor angegebene GAMRequest-Objekt wieder für das Targeting verwendet. Wenn Sie ein neues Targeting festlegen möchten, rufen Sie loadRequest für GAMBannerView mit einem neuen GAMRequest-Objekt auf.

Wie übergebe ich zusätzliche Ausrichtungsparameter an Vermittlungsnetzwerke?

Informationen zum Senden von Targeting an Vermittlungsnetzwerke finden Sie unter Vermittlung.