Ausrichtung

Plattform auswählen: Android iOS Unity Flutter

In dieser Anleitung wird erläutert, 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 Konfigurationsänderungen für alle Anzeigenanfragen gelten, legen Sie die Anfragekonfiguration fest, bevor Sie initialisieren Google Mobile Ads SDK.

Altersbezogene Verarbeitung festlegen

Das Google Mobile Ads SDK bietet eine Einstellung für die altersbezogene Verarbeitung, mit der Sie die Einhaltung der geltenden Datenschutzbestimmungen für Kinder und Jugendliche besser verwalten können. Mit dieser Einstellung für die Altersbehandlung können Sie angeben, ob Google Mobile Ads SDK bestimmte Schutzmaßnahmen für die Anzeigenbereitstellung für Kinder oder Jugendliche anwenden soll. Wenn Sie die Einstellung verwenden, Google Mobile Ads SDK fügt einen tfat Parameter in Anzeigenanfragen ein. Lassen Sie sich von Ihrem Rechtsbeistand beraten, um die geeignete altersbezogene Verarbeitung für Ihre Nutzer auf Grundlage Ihrer rechtlichen und aufsichtsrechtlichen Verpflichtungen zu bestimmen.

Sie können die altersbezogene Verarbeitung mit der ageRestrictedTreatment Eigenschaft für GADRequestConfiguration festlegen.

Altersbezogene Verarbeitung für Kinder festlegen

Im folgenden Beispiel wird angegeben, dass Anzeigenanfragen altersbezogen für Kinder verarbeitet werden sollen:

Swift

// Indicate that ad requests should have child age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .child

Objective-C

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

Altersbezogene Verarbeitung für Jugendliche festlegen

Im folgenden Beispiel wird angegeben, dass Anzeigenanfragen altersbezogen für Jugendliche verarbeitet werden sollen:

Swift

// Indicate that ad requests should have teenage treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .teen

Objective-C

// Indicate that ad requests should have teenage treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment = GADAgeRestrictedTreatmentTeen;

Keine spezifische altersbezogene Verarbeitung festlegen

Im folgenden Beispiel wird angegeben, dass Anzeigenanfragen nicht altersbezogen verarbeitet werden sollen:

Swift

// Indicate that ad requests should have unspecified age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .unspecified

Objective-C

// Indicate that ad requests should have unspecified age treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment = GADAgeRestrictedTreatmentUnspecified;

Von TFCD und TFUA zur altersbezogenen Verarbeitung migrieren

Die Einstellung für die altersbezogene Verarbeitung ersetzt die verworfenen tagForChildDirectedTreatment (TFCD) und tagForUnderAgeOfConsent (TFUA) Eigenschaften.

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

TFCD

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

TFUA

tagForUnderAgeOfConsent	Altersbezogene Verarbeitung
tagForUnderAgeOfConsent = true	GADAgeRestrictedTreatmentChild
tagForUnderAgeOfConsent = false	GADAgeRestrictedTreatmentUnspecified
Kein Wert für tagForUnderAgeOfConsent zugewiesen	GADAgeRestrictedTreatmentUnspecified
Kein Äquivalent	GADAgeRestrictedTreatmentTeen

Interaktionen zwischen der altersbezogenen Verarbeitung und TFCD und TFUA

Wenn Sie die Einstellung für die altersbezogene Verarbeitung und die Einstellungen für TFCD oder TFUA festlegen, wendet Google die konservativste Verarbeitung an.

Hinweis: Bei Nutzern, die in Google-Konten angemeldet sind, die mit Family Link verwaltet werden, werden alle Inhalte für alle Anzeigenanfragen automatisch als Inhalte für Kinder behandelt.

Einstellung „Für Kinder“

Warnung: Die Eigenschaft tagForChildDirectedTreatment ist veraltet. Legen Sie stattdessen die ageRestrictedTreatment Eigenschaft fest.

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

• Setzen Sie tagForChildDirectedTreatment auf true, um anzugeben, dass Ihre Inhalte gemäß COPPA als Inhalte für Kinder 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 Inhalte für Kinder 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 Inhalte für Kinder 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 Benachrichtigung 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, die das gültige Mindestalter noch nicht erreicht haben

Warnung: Die Eigenschaft tagForUnderAgeOfConsent ist veraltet. Legen Sie stattdessen die Eigenschaft set the ageRestrictedTreatment fest.

Sie können Ihre Anzeigenanfragen für die Verarbeitung für Nutzer im Europäischen Wirtschaftsraum (EWR) unter dem gültigen Mindestalter 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 die EU-Richtlinien 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.

Bei Verwendung dieser Funktion wird der Parameter „Tag For Users under the Age of Consent in Europe“ (TFUA, Tag für Nutzer unter dem gültigen Mindestalter in Europa) 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 Objekt GADMobileAds.requestConfiguration auf true setzen.

• Setzen Sie tagForUnderAgeOfConsent auf true, um anzugeben, dass Anzeigenanfragen für Nutzer, die das Mindestalter für Google-Konten noch nicht erreicht haben, geeignet verarbeitet werden sollen. Dadurch wird auch die Übertragung der Werbe-ID (IDFA) verhindert.
• Wenn Sie tagForUnderAgeOfConsent nicht festlegen, werden Anzeigenanfragen nicht für Nutzer, die das Mindestalter für Google-Konten noch nicht erreicht haben, geeignet verarbeitet.

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 Kinder“ und tagForUnderAgeOfConsent sollten nicht gleichzeitig auf true gesetzt werden. Sollte dieser Fall auftreten, hat die Einstellung „Für Kinder“ Vorrang.

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

Filterung von Anzeigeninhalten

Apps können mit der Eigenschaft 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 diese Eigenschaft basieren auf den Klassifizierungen von Inhaltslabeln 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 ein Label für digitale Inhalte haben müssen, das nicht höher als GADMaxAdContentRatingGeneral ist.

Wichtiger Hinweis: Die über das SDK festgelegten Filter für die Altersfreigabe von Inhalten haben Vorrang vor allen Einstellungen, die über die Ad Manager-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 personalisierte Werbung für alle Anzeigenanfragen deaktiviert werden soll. Dazu wird die Eigenschaft publisherPrivacyPersonalizationState von GADRequestConfiguration verwendet. Wenn Sie diese Funktion verwenden, wird der Parameter „Publisher Privacy Treatment“ (PPT) für den Rest der Sitzung in alle zukünftigen Anzeigenanfragen aufgenommen.

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 Signalen zum Datenschutz von Nutzern hat das restriktivste Signal Vorrang. Spezifische Beispiele finden Sie in der Dokumentation zur Publisher Privacy Treatment API.

GAMRequest

Das Objekt GAMRequest 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 an Google gesendet:

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 Apps eine Anzeige anfordern, können sie die URL der Inhalte übergeben, die sie bereitstellen. So 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 = AdManagerRequest()
request.contentURL = "https://www.example.com"

Objective-C

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

Benutzerdefiniertes Targeting

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

Swift

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

Objective-C

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

Markensicherheit (Beta)

Apps, die dynamische Inhalte für verschiedene Zielgruppen anzeigen, können über die Eigenschaft neighboringContentURLs eine kurze Liste von URLs angeben. Die URLs für benachbarte Inhalte unterscheiden sich von der Eigenschaft contentURL dadurch, dass sie nur für die Markensicherheit verwendet werden.

Angenommen, Ihre App zeigt Inhalte von vier URLs in einem Feed an, der auch Anzeigen enthält. Sie können Anzeigen anfordern, die eine ähnliche Altersfreigabe wie diese URLs haben, indem Sie sie so übergeben:

Swift

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

Objective-C

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

Wichtiger Hinweis: Das SDK verwendet nur die ersten vier URLs. Alle anderen werden ignoriert.

Publisher Provided Identifiers

Sie können eine PPID (Publisher Provided Identifier, vom Publisher bereitgestellte Kennung) 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.

Hinweis: Diese Funktion ist nicht für alle Publisher verfügbar. Weitere Informationen finden Sie unter PPIDs (Publisher Provided Identifiers) für Details.

Die PPID wird über GAMRequest festgelegt:

Swift

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

Objective-C

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

Ein Beispiel für die Implementierung von 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 verwenden, um die programmatische Monetarisierung zu verbessern. Dazu geben Sie Ihre Zielgruppeneigenschaften an Bieter in allen Transaktionstypen mit Standardtaxonomien weiter, ohne Nutzerkennungen freizugeben. Zu Ihren Zielgruppeneigenschaften können Verhaltens- und interessenbezogene Daten ( IAB Audience Taxonomy 1.1) und Kontextdaten ( IAB Content Taxonomy 2.2) gehören.

Swift

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)

Objective-C

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?

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

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

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