Ausrichtung

Plattform auswählen: Android iOS Unity Flutter

In dieser Anleitung wird beschrieben, wie Sie dem Google Mobile Ads SDK Targeting-Informationen bereitstellen.

Ein funktionierendes Beispiel finden Sie in der Android API Demo App.

Voraussetzungen

Bevor Sie fortfahren, richten Sie Google Mobile Ads SDK ein.

RequestConfiguration

RequestConfiguration erfasst Targeting-Informationen, die global auf jede Anzeigenanfrage angewendet werden. Verfügbare Targeting-Tags finden Sie in der RequestConfiguration.Builder Dokumentation.

So aktualisieren Sie die Anfragekonfiguration: Rufen Sie einen Builder aus der vorhandenen Konfiguration ab, nehmen Sie die gewünschten Aktualisierungen vor und legen Sie ihn so fest:

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
MobileAds.setRequestConfiguration(requestConfiguration)RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration();
MobileAds.setRequestConfiguration(requestConfiguration);RequestConfigurationSnippets.java

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

Einstellung für Inhalte für Kinder

Im Rahmen des US-Gesetzes zum Schutz der Privatsphäre von Kindern im Internet (Children's Online Privacy Protection Act, COPPA), gibt es die Einstellung „Tag für Inhalte für Kinder“. 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.

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, deaktivieren wir interessenbezogene Werbung und Remarketing-Anzeigen für diese Anzeigenanfrage.

Sie können die Einstellung für Inhalte für Kinder über setTagForChildDirectedTreatment() anwenden:

Rufen Sie setTagForChildDirectedTreatment mit TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE auf, um anzugeben, dass Ihre Inhalte im Hinblick auf COPPA als Inhalte für Kinder behandelt werden sollen. Dadurch wird die Übertragung der Android-Werbe-ID (Android Advertising Identifier, AAID) verhindert.
Rufen Sie setTagForChildDirectedTreatment mit TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE auf, um anzugeben, dass Ihre Inhalte im Hinblick auf COPPA _nicht_ als Inhalte für Kinder behandelt werden sollen.
Rufen Sie setTagForChildDirectedTreatment mit TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED auf, wenn Sie in Anzeigenanfragen nicht angeben möchten, wie Ihre Inhalte im Hinblick auf COPPA behandelt werden sollen.

Im folgenden Beispiel wird angegeben, dass Ihre Inhalte im Hinblick auf COPPA als Inhalte für Kinder behandelt werden sollen:

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setTagForChildDirectedTreatment(
            RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);RequestConfigurationSnippets.java

Minderjährige Nutzer

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. Beachten Sie, dass Sie möglicherweise anderen rechtlichen Verpflichtungen im Rahmen der DSGVO unterliegen. Lesen Sie die Richtlinien der Europäischen Union 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, Tag für minderjährige Nutzer in Europa) in die Anzeigenanfrage aufgenommen. Mit diesem Parameter werden personalisierte Anzeigen, einschließlich Remarketing, für alle Anzeigenanfragen deaktiviert. Außerdem werden Anfragen an Drittanbieter deaktiviert, z. B. Tracking-Pixel zur Messung der Anzeigenleistung und Ad-Server von Drittanbietern.

Wie bei den Einstellungen für Inhalte für Kinder gibt es in RequestConfiguration.Builder eine Methode zum Festlegen des TFUA-Parameters: setTagForUnderAgeOfConsent(), mit den folgenden Optionen.

Rufen Sie setTagForUnderAgeOfConsent() mit TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE auf, um anzugeben, dass die Anzeigenanfrage für minderjährige Nutzer im Europäischen Wirtschaftsraum (EWR) verarbeitet werden soll. Dadurch wird auch die Übertragung der Android-Werbe-ID (Android Advertising Identifier, AAID) verhindert.
Rufen Sie setTagForUnderAgeOfConsent() mit TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE auf, um anzugeben, dass die Anzeigenanfrage nicht für minderjährige Nutzer im Europäischen Wirtschaftsraum (EWR) verarbeitet werden soll.
Rufen Sie setTagForUnderAgeOfConsent() mit TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED auf, um anzugeben, dass Sie nicht festgelegt haben, ob die Anzeigenanfrage für minderjährige Nutzer im Europäischen Wirtschaftsraum (EWR) verarbeitet werden soll.

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

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);RequestConfigurationSnippets.java

Die Tags zum Aktivieren der Einstellung für Inhalte für Kinder und sollten nicht gleichzeitig auf gesetzt werden.setTagForUnderAgeOfConsent()true Sollte dieser Fall auftreten, hat die Einstellung für Inhalte für Kinder Vorrang.

Anzeigeninhalte filtern

Gemäß der Google Play-Richtlinie zu unangemessenen Anzeigen , die auch zugehörige Angebote in einer Anzeige umfasst, müssen alle Anzeigen und die zugehörigen Angebote, die in Ihrer App eingeblendet werden, der jeweiligen Altersfreigabe Ihrer App entsprechen, auch wenn der Inhalt der Werbeanzeigen selbst die Richtlinien von Google Play erfüllt.

Anhand der höchsten Altersfreigabe für Anzeigeninhalte lässt sich besser kontrollieren, welche Inhalte Nutzern in Anzeigen präsentiert werden. Diese Einstellung hilft Ihnen, die Plattformrichtlinien einzuhalten.

Apps können mit der setMaxAdContentRating Methode eine höchste Altersfreigabe für Anzeigeninhalte für ihre Anzeigenanfragen festlegen. Für AdMob-Anzeigen, die zurückgegeben werden, wenn diese Einstellung konfiguriert ist, gilt eine Altersfreigabe, die dieser Stufe entspricht oder darunter liegt. Die möglichen Werte für diese Netzwerkerweiterung basieren auf den Kennzeichnungen für digitale Inhalteund müssen einer der folgenden Strings sein:

MAX_AD_CONTENT_RATING_G
MAX_AD_CONTENT_RATING_PG
MAX_AD_CONTENT_RATING_T
MAX_AD_CONTENT_RATING_MA

Im folgenden Code wird ein RequestConfiguration-Objekt konfiguriert, um anzugeben, dass die zurückgegebenen Anzeigeninhalte einer Kennzeichnung für digitale Inhalte entsprechen müssen, die nicht höher als G ist:

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);RequestConfigurationSnippets.java

Weitere Informationen zum Festlegen der höchsten Altersfreigabe für einzelne Anzeigenanfragen

Google Mobile Ads SDK

Publisher Privacy Treatment (Beta)

Die Publisher Privacy Treatment (PPT) API ist ein optionales Tool, mit dem Apps angeben können, ob die personalisierten Anzeigen für alle Anzeigenanfragen mit der setPublisherPrivacyPersonalizationState() Methode deaktiviert werden sollen. Wenn Sie diese Funktion verwenden, wird für den Rest der Sitzung in alle zukünftigen Anzeigenanfragen ein PPT-Parameter (Publisher Privacy Treatment) aufgenommen.

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

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setPublisherPrivacyPersonalizationState(
      RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED
    )
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setPublisherPrivacyPersonalizationState(
            RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);RequestConfigurationSnippets.java

Anzeigenanfrage

Das AdManagerAdRequest Objekt erfasst Targeting-Informationen, die mit einer Anzeigenanfrage gesendet werden sollen.

Netzwerkerweiterungen hinzufügen

Netzwerkerweiterungen sind zusätzliche Details, die mit einer Anzeigenanfrage gesendet werden und für eine einzelne Anzeigenquelle spezifisch sind.

Im folgenden Code-Snippet wird ein zusätzlicher Parameterschlüssel collapsible mit dem Wert bottom an Google gesendet:

Kotlin

val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest =
  AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()
adView.loadAd(adRequest)AdRequestSnippets.kt

Java

Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
AdRequest adRequest =
    new AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();
adView.loadAd(adRequest);AdRequestSnippets.java

Benutzerdefiniertes Targeting

Sie können benutzerdefinierte Schlüssel/Wert-Paare übergeben, um Google Ad Manager-Kampagnen (Werbebuchungen) auszurichten. Im folgenden Beispiel wird ein benutzerdefiniertes Schlüssel/Wert-Paar in einer Anzeigenanfrage übergeben:

Kotlin

// Example: Pass custom targeting "age=25".
val newRequest = AdManagerAdRequest.Builder().addCustomTargeting("age", "25").build()AdRequestSnippets.kt

Java

// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest =
    new AdManagerAdRequest.Builder().addCustomTargeting("age", "25").build();AdRequestSnippets.java

Sie können mehrere Werte für einen Schlüssel als Liste von Strings übergeben. Beispielsweise, um Personen im Alter von 20 bis 29 Jahren anstelle von nur 25-Jährigen anzusprechen.

Kotlin

.addCustomTargeting("age", listOf("24", "25", "26"))AdRequestSnippets.kt

Java

.addCustomTargeting("age", Arrays.asList("24", "25", "26"))AdRequestSnippets.java

Im Beispiel für benutzerdefiniertes Targeting in Ad Manager finden Sie eine Implementierung des benutzerdefinierten Targetings in der Android API Demo App.

Kategorieausschlüsse

Sie können einer Anfrage einen Kategorieausschluss auf Slot-Ebene hinzufügen, indem Sie die addCategoryExclusion() Methode verwenden:

Kotlin

// Example: Exclude "automobile" and "boat" categories.
val newRequest =
  AdManagerAdRequest.Builder()
    .addCategoryExclusion("automobile")
    .addCategoryExclusion("boat")
    .build()AdRequestSnippets.kt

Java

// Example: Exclude "automobile" and "boat" categories.
AdManagerAdRequest newRequest =
    new AdManagerAdRequest.Builder()
        .addCategoryExclusion("automobile")
        .addCategoryExclusion("boat")
        .build();AdRequestSnippets.java

Im Beispiel für Kategorieausschlüsse in Ad Manager finden Sie eine Implementierung von Kategorieausschlüssen in der Android API Demo App.

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.

Hier ist ein Beispiel für das Festlegen der PPID:

Kotlin

val adRequest = AdManagerAdRequest.Builder().setPublisherProvidedId("AB123456789").build()AdRequestSnippets.kt

Java

AdManagerAdRequest adRequest =
    new AdManagerAdRequest.Builder().setPublisherProvidedId("AB123456789").build();AdRequestSnippets.java

Im Beispiel für PPIDs in Ad Manager finden Sie eine Implementierung von vom Publisher bereitgestellten Kennungen (PPIDs) in der Android API Demo App.

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, indem Sie Ihre Zielgruppeneigenschaften an Bieter in allen Transaktionstypen mithilfe von Standardtaxonomien weitergeben, ohne Nutzerkennungen teilen zu müssen. Zu Ihren Zielgruppen eigenschaften können verhaltensbezogene und interessenbezogene Daten (IAB-Taxonomie für Zielgruppen 1.1) und Kontext daten (IAB-Taxonomie für Inhalte 2.2) gehören.

Kotlin

val extras = Bundle()
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6, 284))
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4, 5, 6))

val request =
  AdManagerAdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()AdRequestSnippets.kt

Java

Bundle extras = new Bundle();
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", new ArrayList<>(Arrays.asList(6, 284)));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", new ArrayList<>(Arrays.asList(4, 5, 6)));

AdManagerAdRequest request =
    new AdManagerAdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();AdRequestSnippets.java

Inhalts-URL

Wenn Sie eine Inhalts-URL für auf Inhalte ausgerichtete Anzeigen und die Markensicherheit angeben möchten, fügen Sie Folgendes hinzu:

Kotlin

val builder = AdManagerAdRequest.Builder()
builder.setContentUrl("https://www.example.com")
val request = builder.build()AdRequestSnippets.kt

Java

AdManagerAdRequest.Builder builder = new AdManagerAdRequest.Builder();
builder.setContentUrl("https://www.example.com");
AdManagerAdRequest request = builder.build();AdRequestSnippets.java

Markensicherheit (Beta)

Anwendungen, die dynamische Inhalte für unterschiedliche Zielgruppen anzeigen, können eine kurze Liste von URLs bereitstellen:

Kotlin

val urls =
  mutableListOf(
    "https://www.mycontenturl1.com",
    "https://www.mycontenturl2.com",
    "https://www.mycontenturl3.com",
    "https://www.mycontenturl4.com",
  )

val requestWithContent = AdManagerAdRequest.Builder().setNeighboringContentUrls(urls).build()AdRequestSnippets.kt

Java

List<String> urls =
    Arrays.asList(
        "https://www.mycontenturl1.com",
        "https://www.mycontenturl2.com",
        "https://www.mycontenturl3.com",
        "https://www.mycontenturl4.com");

AdManagerAdRequest requestWithContent =
    new AdManagerAdRequest.Builder().setNeighboringContentUrls(urls).build();AdRequestSnippets.java

.setNeighboringContentUrls() unterscheidet sich von .setContentUrl() dadurch, dass es nur für die Markensicherheit verwendet wird.

Ausrichtung Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Voraussetzungen

RequestConfiguration

Kotlin

Java

Einstellung für Inhalte für Kinder

Kotlin

Java

Minderjährige Nutzer

Kotlin

Java

Anzeigeninhalte filtern

Kotlin

Java

Publisher Privacy Treatment (Beta)

Kotlin

Java

Anzeigenanfrage

Netzwerkerweiterungen hinzufügen

Kotlin

Java

Benutzerdefiniertes Targeting

Kotlin

Java

Kotlin

Java

Kategorieausschlüsse

Kotlin

Java

Vom Publisher bereitgestellte Kennungen

Kotlin

Java

Vom Publisher bereitgestellte Signale

Kotlin

Java

Inhalts-URL

Kotlin

Java

Markensicherheit (Beta)

Kotlin

Java

Ausrichtung