Targeting

Plattform auswählen: Android iOS Unity Flutter Android (Legacy)

In diesem Leitfaden wird beschrieben, wie Sie dem Google Mobile Ads SDK Ausrichtungsinformationen 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 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 Änderungen 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 Google Mobile Ads SDK (Legacy) initialisieren.

Alterskennzeichnung festlegen

Google Mobile Ads SDK (Legacy) bietet eine Einstellung für die Altersbehandlung, mit der Sie die Einhaltung der anwendbaren Datenschutzbestimmungen für Kinder und Jugendliche verwalten können. 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() über die 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)
RequestConfigurationSnippets.kt

Java

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

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

• TEEN
• UNSPECIFIED

Wenn Sie die Einstellung verwenden, enthält Google Mobile Ads SDK (Legacy) einen tfat-Parameter in Anzeigenanfragen. 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 eingestellten Einstellungen .setTagForChildDirectedTreatment() (TFCD) und .setTagForUnderAgeOfConsent() (TFUA).

In der folgenden Tabelle sind die Einstellungen für „Für Kinder“ (TFCD) und „Nutzer unter dem gesetzlichen Mindestalter“ (TFUA) sowie 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.

Hinweis :Bei Apps im Programm „Für Familien“, die als hauptsächlich auf Kinder ausgerichtete Apps gelten, sowie bei Nutzern, die in Google-Konten angemeldet sind, die mit Family Link verwaltet werden, werden alle Inhalte bei allen Anzeigenanfragen automatisch als auf Kinder ausgerichtet behandelt.

Alterskennzeichnung mit AdMob Mediation weiterleiten

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

In der folgenden Tabelle sind die Versionen von Vermittlungsadaptern aufgeführt, die das Weiterleiten des Signals für die Behandlung von Inhalten mit 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 (Line)	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

Warnung :Die Methode setTagForChildDirectedTreatment() wird nicht mehr unterstützt. Legen Sie stattdessen die Methode setAgeRestrictedTreatment() fest.

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 „Als Inhalte für Kinder kennzeichnen“. 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. 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 „Auf Kinder ausgerichtet“ über setTagForChildDirectedTreatment() anwenden:

• 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 für Kinder bestimmt 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 in Bezug auf COPPA behandelt werden sollen.

Das folgende Beispiel zeigt, dass Ihre Inhalte gemäß COPPA als für Kinder bestimmt eingestuft 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

Hinweis :Bei Apps im Programm „Für Familien“, die als hauptsächlich auf Kinder ausgerichtete Apps gelten, sowie bei Nutzern, die in Google-Konten angemeldet sind, die mit Family Link verwaltet werden, werden alle Inhalte bei allen Anzeigenanfragen automatisch als auf Kinder ausgerichtet behandelt.

Nutzer, die das gültige Mindestalter noch nicht erreicht haben

Warnung :Die Methode setTagForUnderAgeOfConsent() wird nicht mehr unterstützt. Stattdessen legen Sie die Methode setAgeRestrictedTreatment() fest

.

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 sich die Richtlinien der Europäischen Union durch 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 auf Publisher

Wenn Sie diese Funktion verwenden, wird der Parameter „Tag For Users under the Age of Consent in Europe“ (TFUA) 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, die speziell für Kinder bestimmt sind, 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), die das erforderliche Mindestalter noch nicht erreicht haben, verarbeitet 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 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 angegeben haben, ob die Anzeigenanfrage für Nutzer im Europäischen Wirtschaftsraum (EWR), die das erforderliche Mindestalter noch nicht erreicht haben, 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 „Inhalte für Kinder“ und setTagForUnderAgeOfConsent() sollten nicht gleichzeitig auf true gesetzt sein. Sollte dieser Fall auftreten, hat die Einstellung „An Kinder gerichtet“ Vorrang.

Anzeigeninhalte filtern

Gemäß der Richtlinie zu unangemessenen Anzeigen von Google Play, die auch zugehörige Angebote in einer Anzeige umfasst, müssen alle Anzeigen und die damit verbundenen Angebote, die in Ihrer App eingeblendet werden, für die Altersfreigabe Ihrer App geeignet sein, auch wenn die Inhalte selbst ansonsten den Richtlinien von Google Play entsprechen.

Anhand der höchsten Altersfreigabe für Anzeigeninhalte lässt sich kontrollieren, welche Inhalte Nutzern in Anzeigen präsentiert werden. Sie können eine maximale Altersfreigabe festlegen, um die Einhaltung der Plattformrichtlinien zu unterstützen.

Apps können mithilfe der Methode setMaxAdContentRating eine maximale Altersfreigabe für Anzeigeninhalte für ihre Anzeigenanfragen festlegen. AdMob-Anzeigen, die zurückgegeben werden, wenn diese Option konfiguriert ist, haben eine Altersfreigabe, die diesem Niveau 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 zurückgegebene Anzeigeninhalte einem Label für digitale Inhalte entsprechen, das 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 zu folgenden Themen:

• Höchste Altersfreigabe für einzelne Anzeigenanfragen festlegen

• Höchste Altersfreigabe für Anzeigeninhalte für eine App oder ein Konto festlegen

Hinweis :Einstellungen für Inhaltsfreigabefilter, die über Google Mobile Ads SDK (Legacy) angegeben werden, haben Vorrang vor allen Einstellungen, die über die AdMob-Benutzeroberfläche konfiguriert wurden.

Publisher Privacy Treatment (Beta)

Die Publisher Privacy Treatment (PPT) API ist ein optionales Tool, mit dem Apps angeben können, ob die Anzeigenpersonalisierung für alle Anzeigenanfragen mit der Methode setPublisherPrivacyPersonalizationState() 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) eingefügt.

Standardmäßig werden über Anzeigenanfragen an Google personalisierte Anzeigen ausgeliefert. Mit dem folgenden Code wird die Personalisierung von 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

Hinweis :Bei Anzeigenanfragen mit mehreren Datenschutzsignalen für Nutzerinnen und Nutzer hat das restriktivste Signal Vorrang. Spezifische Beispiele finden Sie in der Dokumentation zur Publisher Privacy Treatment API.

Anzeigenanfrage

Das AdRequest-Objekt 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 für Google festgelegt:

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