In diesem Leitfaden wird erläutert, wie Sie Ausrichtungsinformationen für eine Anzeigenanfrage angeben.
Wenn Sie sehen möchten, wie Anzeigen-Targeting funktioniert, laden Sie die iOS API Demo-App in Swift oder Objective-C herunter.
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:
Swift
let requestConfiguration = MobileAds.shared.requestConfiguration
Objective-C
GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;
Damit die Änderungen der Anfragekonfiguration auf alle Anzeigenanfragen angewendet werden, legen Sie die Anfragekonfiguration fest, bevor Sie Google Mobile Ads SDK initialisieren.
Alterskennzeichnung festlegen
Um Ihnen die Einhaltung der anwendbaren Datenschutzbestimmungen für Kinder und Jugendliche zu erleichtern, 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 spezifische 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 als Inhalte für Kinder gekennzeichnet werden sollen:
Swift
// Indicates that ad requests should have child age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .child
Wenn Sie eine Altersgruppe für Teenager oder eine nicht angegebene Altersgruppe 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;
Wenn Sie die Alterskennzeichnung für Teenager oder eine nicht angegebene Alterskennzeichnung angeben möchten, ersetzen Sie die Einstellung GADAgeRestrictedTreatmentChild durch Folgendes:
GADAgeRestrictedTreatmentTeenGADAgeRestrictedTreatmentUnspecified
Wenn Sie die Einstellung verwenden, fügt Google Mobile Ads SDK den Parameter tfat in Anzeigenanfragen ein. Lassen Sie sich von Ihrem Rechtsbeistand beraten, um die anwendbare Alterskennzeichnung 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 Attribute tagForChildDirectedTreatment (TFCD) und tagForUnderAgeOfConsent (TFUA).
In der folgenden Tabelle sind die Einstellungen für tagForChildDirectedTreatment und tagForUnderAgeOfConsent sowie die entsprechenden Altersgruppen 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.
Einstellung „Für Kinder“
.Im Sinne des US-Gesetzes 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 einstufen soll, ergreift Google Maßnahmen, um interessenbezogene Werbung und Remarketing-Anzeigen für diese Anzeigenanfrage zu deaktivieren. Die Einstellungsoptionen sind:
- Setzen Sie
tagForChildDirectedTreatmentauftrue, um anzugeben, dass Ihre Inhalte im Rahmen des COPPA als für Kinder bestimmt behandelt werden sollen. Dadurch wird die Übertragung des Identifier for Advertising (IDFA) verhindert. - Legen Sie
tagForChildDirectedTreatmentauffalsefest, um anzugeben, dass Ihre Inhalte im Sinne von COPPA nicht als auf Kinder ausgerichtet eingestuft werden sollen. - Legen Sie
tagForChildDirectedTreatmentnicht 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:
Swift
MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;
Indem Sie dieses Tag festlegen, bestätigen Sie, dass diese Benachrichtigung korrekt ist und Sie berechtigt sind, im Namen des App-Inhabers 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 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 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, „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 GADMobileAds.requestConfiguration-Objekt festlegen und true übergeben.
- Setzen Sie
tagForUnderAgeOfConsentauftrue, um anzugeben, dass Anzeigenanfragen für minderjährige Nutzer verarbeitet werden sollen. Dadurch wird auch die Übertragung der Werbe-ID (IDFA) verhindert. - Wenn Sie
tagForUnderAgeOfConsentnicht festlegen, werden Anzeigenanfragen nicht für minderjährige Nutzer verarbeitet.
Das folgende Beispiel zeigt, wie Sie TFUA in Ihre Anzeigenanfrage einfügen:
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 werden.
Sollte dieser Fall eintreten, hat die Einstellung „Für Kinder“ Vorrang.
Filtern von Anzeigeninhalten
Apps können mit der maxAdContentRating-Eigenschaft 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 Klassifizierungen von Labels für digitalen Content und sollten eine der folgenden Konstanten sein:
GADMaxAdContentRatingGeneralGADMaxAdContentRatingParentalGuidanceGADMaxAdContentRatingTeenGADMaxAdContentRatingMatureAudience
Im folgenden Code wird für alle Anzeigenanfragen konfiguriert, dass die zurückgegebenen Anzeigeninhalte ein Label für digitale Inhalte haben müssen, das 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-API (PPT) ist ein optionales Tool, mit dem Apps angeben können, ob die Personalisierung von Anzeigen für alle Anzeigenanfragen mit der publisherPrivacyPersonalizationState-Eigenschaft von GADRequestConfiguration deaktiviert werden soll. Wenn Sie diese Funktion verwenden, wird ein Parameter für die Verarbeitung von Daten zum Schutz der Privatsphäre von Publishern (Publisher Privacy Treatment, PPT) in alle zukünftigen Anzeigenanfragen für den Rest der Sitzung aufgenommen.
Standardmäßig werden über Anzeigenanfragen an Google personalisierte Anzeigen ausgeliefert. Mit dem folgenden Code wird die Personalisierung von Anzeigen für alle Anzeigenanfragen deaktiviert:
Swift
MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
.disabled
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
GADPublisherPrivacyPersonalizationStateDisabled;
GADRequest
Im GADRequest-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:
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 die Anzeige mithilfe von Keyword-Targeting dem Inhalt zugeordnet werden.
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 auszurichten:
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
GADRequest-Objekt wieder für das Targeting verwendet. Wenn Sie ein neues Targeting festlegen möchten, rufen SieloadRequestfürGADBannerViewmit einem neuenGADRequest-Objekt auf. - Wie übergebe ich zusätzliche Targeting-Parameter an Vermittlungsnetzwerke?
- Informationen zum Senden von Targeting an Vermittlungsnetzwerke finden Sie unter Vermittlung.