Ausrichtung

Plattform auswählen:Android iOS Unity Flutter

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

Wenn Sie sehen möchten, wie die Anzeigenausrichtung funktioniert, laden Sie die iOS API Demo-App in Swift oder Objective-C herunter.

API-Demo herunterladen

Vorbereitung

Führen Sie die Schritte im Startleitfaden aus.

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 an der Anfragekonfiguration auf alle Anzeigenanfragen angewendet werden, legen Sie die Anfragekonfiguration fest, bevor Sie das Mobile Ads SDK initialisieren.

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 wie folgt:

  • Legen Sie tagForChildDirectedTreatment auf true fest, 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 tagForChildDirectedTreatment auf false fest, wenn Ihre Inhalte im Sinne von COPPA nicht als auf Kinder ausgerichtet eingestuft werden sollen.
  • Lassen Sie tagForChildDirectedTreatment weg, wenn Sie nicht angeben möchten, wie Ihre Inhalte in Bezug auf COPPA behandelt werden sollen.

Das folgende Beispiel zeigt, dass Ihre Inhalte im Sinne der COPPA-Bestimmungen als für Kinder bestimmt behandelt 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.

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

Bei Verwendung dieser Funktion 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 an Drittanbieter gerichtete Anfragen deaktiviert, z. B. Tracking-Pixel und Ad-Server eines Drittanbieters.

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

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

Das folgende Beispiel zeigt, dass Sie TFUA in Ihre Anzeigenanfrage einbeziehen 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 werden. Sollte dieser Fall eintreten, hat die Einstellung „Für Kinder“ Vorrang.

Anzeigeninhalte filtern

Apps können mit der Property maxAdContentRating von GADRequestConfiguration eine höchste Altersfreigabe 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

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 API Publisher Privacy Treatment (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 in alle zukünftigen Anzeigenanfragen für den Rest der Sitzung ein Parameter für die Publisher-Datenschutzbehandlung (Publisher Privacy Treatment, PPT) aufgenommen.

Anzeigenanfragen an Google führen standardmäßig zur Auslieferung personalisierter Anzeigen. Mit dem folgenden Code wird die Anzeigenpersonalisierung 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 des Keyword-Targetings 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

Welche Ausrichtung wird verwendet, wenn eine Anzeige automatisch aktualisiert wird?
Bei der Anzeigenaktualisierung wird das zuvor angegebene GADRequest-Objekt wieder für das Targeting verwendet. Rufen Sie loadRequest für GADBannerView mit einem neuen GADRequest-Objekt auf, um neues Targeting festzulegen.
Wie übergebe ich zusätzliche Targeting-Parameter an Vermittlungsnetzwerke?
Informationen zum Senden von Targeting an Vermittlungsnetzwerke finden Sie unter Vermittlung.