Targeting

In diesem Leitfaden wird erläutert, wie Sie dem Google Mobile Ads SDK Targeting-Informationen zur Verfügung stellen.

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

API-Demo herunterladen

Voraussetzungen

Bevor Sie fortfahren, richten Sie Google Mobile Ads SDK (Legacy) ein.

RequestConfiguration

RequestConfiguration erfasst Targeting-Informationen, die global auf jede Anzeigenanfrage angewendet werden. Informationen zu den verfügbaren Targeting-Tags finden Sie in der Dokumentation zu RequestConfiguration.Builder.

Wenn Sie die Anfragekonfiguration aktualisieren möchten, rufen Sie einen Builder aus der vorhandenen Konfiguration ab, nehmen Sie die gewünschten Aktualisierungen vor und legen Sie sie so fest:

Kotlin

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

Java

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

Damit die Änderungen an der Anfragekonfiguration für alle Anzeigenanfragen gelten, müssen Sie die Anfragekonfiguration festlegen, bevor Sie Google Mobile Ads SDK (Legacy) initialisieren.

Alterskennzeichnung festlegen

Damit Sie die Einhaltung der geltenden Datenschutzbestimmungen für Kinder und Jugendliche besser verwalten können, bietet Google Mobile Ads SDK (Legacy) eine Einstellung für die Altersbehandlung. Mit der Einstellung für die Alterskennzeichnung können Sie angeben, ob Google Mobile Ads SDK (Legacy) 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 Methode setAgeRestrictedTreatment() der RequestConfiguration.Builder API festlegen.

Im folgenden Beispiel wird angegeben, dass Anzeigenanfragen eine Alterskennzeichnung für Kinder erhalten sollen:

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    // Indicate that ad requests should have child age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        // Indicate that ad requests should have child age treatment.
        .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Wenn Sie die Alterskennzeichnung für Teenager oder eine nicht angegebene Alterskennzeichnung verwenden möchten, ersetzen Sie die Einstellung CHILD durch Folgendes:

  • TEEN
  • UNSPECIFIED

Wenn Sie die Einstellung verwenden, fügt Google Mobile Ads SDK (Legacy) den Parameter tfat in Anzeigenanfragen ein. Lassen Sie sich von Ihrem Rechtsbeistand beraten, um das Mindestalter für Ihre Nutzerinnen und Nutzer basierend auf Ihren rechtlichen und regulatorischen Verpflichtungen festzulegen. Weitere Informationen finden Sie unter Anzeigenanfragen für die Alterskennzeichnung taggen.

Von TFCD und TFUA zur Alterskennzeichnung migrieren

Die Einstellung für die Alterskennzeichnung ersetzt die veralteten Einstellungen .setTagForChildDirectedTreatment() (TFCD) und .setTagForUnderAgeOfConsent() (TFUA).

In der folgenden Tabelle sind die TFCD- und TFUA-Einstellungen und die entsprechenden Altersgruppen aufgeführt:

TFCD

TFCD Alterskennzeichnung
TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE AgeRestrictedTreatment.CHILD
TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE AgeRestrictedTreatment.UNSPECIFIED
TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED AgeRestrictedTreatment.UNSPECIFIED
Kein Wert zugewiesen .setTagForChildDirectedTreatment() AgeRestrictedTreatment.UNSPECIFIED
Kein Äquivalent AgeRestrictedTreatment.TEEN

TFUA

TFUA Alterskennzeichnung
TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE AgeRestrictedTreatment.CHILD
TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE AgeRestrictedTreatment.UNSPECIFIED
TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED AgeRestrictedTreatment.UNSPECIFIED
Kein Wert zugewiesen .setTagForUnderAgeOfConsent() AgeRestrictedTreatment.UNSPECIFIED
Kein Äquivalent AgeRestrictedTreatment.TEEN

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.

Alterskennzeichnung mit Vermittlung weiterleiten

Wenn Sie die Alterskennzeichnung mit Google Mobile Ads SDK (Legacy) festlegen, leiten Vermittlungsadapter das Signal für die Alterskennzeichnung an vermittelte SDKs von Drittanbietern weiter.

In der folgenden Tabelle sind die Versionen der Vermittlungsadapter aufgeführt, die die Weiterleitung des Signals für die Altersbeschränkung an das vermittelte Drittanbieter-SDK unterstützen:

Name des Vermittlungsadapters Unterstützte Mindestversion
AppLovin 13.6.3.0
BidMachine 3.7.1.1
Bigo 5.9.0.1
Chartboost 9.12.1.1
DTExchange (Fyber) 8.4.5.1
i-mobile 2.3.2.4
InMobi 11.3.0.1
IronSource 9.4.3.0
Liftoff Monetize (Vungle) 7.7.4.2
LY (Linie) 3.1.1.1
maio 2.0.9.0
Meta (Facebook) 6.21.0.4
Mintegral 17.1.61.1
Moloco 4.10.0.0
MyTarget 5.47.1.1
Pangle 8.1.0.3.1
PubMatic 5.1.2.2
Verve 3.9.0.0

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 eine Einstellung namens „Tag zur Klassifizierung als Inhalte für Kinder“. Durch das Setzen dieses Tags bestätigen Sie, dass diese Mitteilung korrekt ist und Sie berechtigt sind, im Namen des Inhabers der App zu handeln. Ihnen ist bewusst, dass ein 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 einstufen soll, deaktivieren wir interessenbezogene Werbung und Remarketing-Anzeigen für diese Anzeigenanfrage.

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

  • Rufen Sie setTagForChildDirectedTreatment mit TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE auf, um anzugeben, dass Ihre Inhalte gemäß COPPA als auf Kinder ausgerichtet behandelt werden sollen. Dadurch wird die Übertragung der Android-Werbe-ID (AAID) verhindert.

  • Rufen Sie setTagForChildDirectedTreatment mit TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE auf, um anzugeben, dass Ihre Inhalte im Sinne des COPPA nicht als Inhalte für Kinder behandelt werden sollen.

  • Rufen Sie setTagForChildDirectedTreatment mit TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED auf, wenn Sie nicht angeben möchten, wie Ihre Inhalte in Bezug auf COPPA in Anzeigenanfragen behandelt werden sollen.

Im folgenden Beispiel wird angegeben, dass Ihre Inhalte gemäß COPPA als Inhalte speziell für Kinder eingestuft werden sollen:

Kotlin

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

Java

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

Sie können Ihre Anzeigenanfragen zur Verarbeitung für Nutzer im Europäischen Wirtschaftsraum (EWR), die das gültige Mindestalter noch nicht erreicht haben, kennzeichnen. Mit dieser Funktion soll die Einhaltung der EU-Datenschutz-Grundverordnung (DSGVO) erleichtert werden. Möglicherweise gelten für Sie im Rahmen der DSGVO weitere rechtliche Verpflichtungen. Lesen Sie die Richtlinien der Europäischen Union 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 für Publisher

Wenn Sie diese Funktion verwenden, wird der Parameter „TFUA“ (Tag For Users under the Age of Consent in Europe) 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 eines Drittanbieters.

Wie bei den Einstellungen für an Kinder gerichtete Inhalte 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 Nutzer im Europäischen Wirtschaftsraum (EWR) unter dem gültigen Mindestalter behandelt werden soll. Dadurch wird auch die Übertragung der Android-Werbe-ID (AAID) verhindert.

  • Rufen Sie setTagForUnderAgeOfConsent() mit TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE auf, um anzugeben, dass die Anzeigenanfrage nicht für Nutzer im Europäischen Wirtschaftsraum (EWR) unter dem gültigen Mindestalter 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 Nutzer im Europäischen Wirtschaftsraum (EWR) unter dem gültigen Mindestalter behandelt werden soll.

Im folgenden Beispiel wird angegeben, dass TFUA in Ihren Anzeigenanfragen enthalten sein soll:

Kotlin

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

Java

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

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

Filtern von Anzeigeninhalten

Gemäß der Richtlinie zu unangemessenen Anzeigen von Google Play, die auch zugehörige Angebote innerhalb einer Anzeige umfasst, müssen alle Anzeigen und zugehörigen Angebote, die in Ihrer App eingeblendet werden, der 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 kontrollieren, welche Inhalte Nutzern in Anzeigen präsentiert werden. Diese Einstellung hilft Ihnen, die Plattformrichtlinien einzuhalten.

In Apps kann mit der Methode setMaxAdContentRating eine höchste Altersfreigabe für Anzeigeninhalte für Anzeigenanfragen festgelegt werden. Wenn diese Option konfiguriert ist, haben die zurückgegebenen AdMob-Anzeigen eine Altersfreigabe, die diesem Wert entspricht oder darunter liegt. Die möglichen Werte für dieses Netzwerk-Extra basieren auf Klassifizierungen von Labels für digitalen Content und 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 so konfiguriert, dass die zurückgegebenen Anzeigeninhalte einer Bezeichnung für digitale Inhalte entsprechen, die nicht höher als G ist:

Kotlin

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

Java

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

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

Publisher Privacy Treatment (Beta)

Die Publisher Privacy Treatment (PPT) API ist ein optionales Tool, mit dem Apps angeben können, ob die Personalisierung von Anzeigen für alle Anzeigenanfragen deaktiviert werden soll. Dazu wird die Methode setPublisherPrivacyPersonalizationState() verwendet. 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 bei Anzeigenanfragen an Google personalisierte Anzeigen ausgeliefert. Mit dem folgenden Code wird die Personalisierte Werbung für alle Anzeigenanfragen deaktiviert:

Kotlin

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

Java

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

Anzeigenanfrage

Das Objekt AdManagerAdRequest 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 sich auf eine einzelne Anzeigenquelle beziehen.

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)

Java

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

Benutzerdefinierte Ausrichtung

Sie können benutzerdefinierte Schlüssel/Wert-Paare übergeben, um das Targeting von Google Ad Manager-Kampagnen (Werbebuchungen) festzulegen. 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()

Java

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

Sie können mehrere Werte für einen Schlüssel als Liste von Strings übergeben. Beispielsweise können Sie Personen Mitte zwanzig ansprechen, anstatt nur 25-Jährige.

Kotlin

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

Java

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

Ein Beispiel für die Implementierung des benutzerdefinierten Targetings in der Android API-Demo-App finden Sie unter Ad Manager Custom Targeting.

Kategorieausschlüsse

Mit der Methode addCategoryExclusion() können Sie einer Anfrage einen Kategorieausschluss auf Anzeigenflächenebene hinzufügen:

Kotlin

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

Java

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

Ein Beispiel für die Implementierung von Kategorieausschlüssen in der Android API-Demo-App finden Sie unter Ad Manager Category Exclusions.

Vom Publisher bereitgestellte Kennungen

Sie können eine vom Publisher bereitgestellte Kennung (PPID) festlegen, die beim Frequency Capping, bei der Zielgruppensegmentierung und beim Targeting auf Zielgruppen, bei der sequenziellen Anzeigenrotation und bei anderen Funktionen zur zielgruppenbasierten Anzeigenauslieferung auf beliebigen Geräten verwendet wird.

Hier ein Beispiel für das Festlegen der PPID:

Kotlin

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

Java

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

Im Ad Manager-PPID-Beispiel finden Sie eine Implementierung von vom Publisher bereitgestellten Kennungen (PPID) in der Android API-Demo-App.

Vom Publisher bereitgestellte Signale

Sie können Zielgruppen- und Kontextdaten als vom Publisher bereitgestellte Signale (PPS) in Anzeigenanfragen senden. Mit PPS können Sie Ihre Nutzerdaten verwenden, um die programmatische Monetarisierung zu verbessern. Dazu geben Sie die Merkmale Ihrer Zielgruppe mithilfe von Standardtaxonomien an Bieter in allen Transaktionstypen weiter, ohne Nutzer-IDs teilen zu müssen. Zu den Merkmalen Ihrer Zielgruppe können verhaltens- und interessenbezogene Daten (IAB-Taxonomie für Zielgruppen 1.1) und kontextbezogene 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()

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();

Inhalts-URL

Wenn Sie eine Content-URL für Anzeigen mit inhaltsbezogenem Targeting und Markensicherheit angeben möchten, fügen Sie Folgendes hinzu:

Kotlin

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

Java

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

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()

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();

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