In dieser Anleitung wird erläutert, wie Sie einer Anzeigenanfrage Targeting-Informationen hinzufügen.
Wenn Sie sich das Anzeigen-Targeting in der Praxis ansehen möchten, laden Sie die iOS API Demo-App in Swift oder Objective-C herunter.
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 alle Anzeigenanfragen die Änderungen an der Anfragenkonfiguration übernehmen, legen Sie die Anfragenkonfiguration 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 der ageRestrictedTreatment Property auf
GADRequestConfiguration festlegen.
Im folgenden Beispiel wird angegeben, dass Anzeigenanfragen für Kinder gekennzeichnet werden sollen:
Swift
// Indicates that ad requests should have child age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .child
Wenn Sie die Alterskennzeichnung für Jugendliche oder ein nicht angegebenes Alter festlegen möchten, ersetzen Sie die Einstellung .child durch eine der folgenden Einstellungen:
.teen.unspecified
Objective-C
// Indicates that ad requests should have child age treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment =
GADAgeRestrictedTreatmentChild;
Wenn Sie die Alterskennzeichnung für Jugendliche oder ein nicht angegebenes Alter festlegen möchten, ersetzen Sie die Einstellung GADAgeRestrictedTreatmentChild durch eine der folgenden Einstellungen:
GADAgeRestrictedTreatmentTeenGADAgeRestrictedTreatmentUnspecified
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 anwendbare Alterskennzeichnung 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 verworfenen
tagForChildDirectedTreatment (TFCD) und tagForUnderAgeOfConsent (TFUA)
Properties.
In der folgenden Tabelle sind die Einstellungen tagForChildDirectedTreatment und tagForUnderAgeOfConsent sowie die entsprechenden Einstellungen für die Alterskennzeichnung 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.
Einstellung „Für Kinder“
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 Einstellungen sind verfügbar:
- Setzen Sie
tagForChildDirectedTreatmentauftrue, 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
tagForChildDirectedTreatmentauffalse, um anzugeben, dass Ihre Inhalte gemäß COPPA nicht als auf Kinder ausgerichtet behandelt werden sollen. - Legen Sie
tagForChildDirectedTreatmentnicht 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 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
Sie können Ihre Anzeigenanfragen für die 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 die EU-Richtlinien und wenden Sie sich gegebenenfalls an Ihren Rechtsberater. 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
Property
tagForUnderAgeOfConsent für das
GADMobileAds.requestConfiguration Objekt festlegen und true übergeben.
- Setzen Sie
tagForUnderAgeOfConsentauftrue, um anzugeben, dass Anzeigenanfragen so verarbeitet werden sollen, dass sie für Nutzer geeignet sind, die das Mindestalter für Google-Konten noch nicht erreicht haben. Dadurch wird auch die Übertragung der Werbe-ID (IDFA) verhindert. - Wenn Sie
tagForUnderAgeOfConsentnicht festlegen, werden Anzeigenanfragen nicht so verarbeitet, dass sie für Nutzer geeignet sind, die das Mindestalter für Google-Konten noch nicht erreicht haben.
Im folgenden Beispiel wird angegeben, dass TFUA in Ihre Anzeigenanfrage aufgenommen werden soll:
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.
Filterung von Anzeigeninhalten
Apps können mit der Property 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 Property basieren auf den Klassifizierungen von Labeln für digitalen Content
und müssen eine
der folgenden Konstanten sein:
GADMaxAdContentRatingGeneralGADMaxAdContentRatingParentalGuidanceGADMaxAdContentRatingTeenGADMaxAdContentRatingMatureAudience
Mit dem folgenden Code wird konfiguriert, dass für alle Anzeigenanfragen angegeben wird, dass die zurückgegebenen Anzeigeninhalte einer Kennzeichnung für digitales Content-Label entsprechen müssen, die nicht höher als GADMaxAdContentRatingGeneral ist.
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
publisherPrivacyPersonalizationState
Property von GADRequestConfiguration verwendet. Wenn Sie diese Funktion verwenden, wird der Parameter „Publisher Privacy Treatment“ (PPT) in alle zukünftigen Anzeigenanfragen für den Rest der Sitzung 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;
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 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
Beim Anfordern einer Anzeige können Apps 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 = 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
GADRequestwieder für das Targeting verwendet. Wenn Sie ein neues Targeting festlegen möchten, rufen SieloadRequestfürGADBannerViewmit einem neuen ObjektGADRequestauf. - Wie übergebe ich zusätzliche Targeting-Parameter an Vermittlungsnetzwerke?
- Unter Vermittlung erfahren Sie, wie Sie Targeting an Vermittlungsnetzwerke senden.