In diesem Leitfaden wird beschrieben, wie Sie dem Google Mobile Ads SDK Targeting-Informationen zur Verfügung stellen.
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. Eine Liste der 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)Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration();
MobileAds.setRequestConfiguration(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 Altersbehandlung können Sie angeben, ob Google Mobile Ads SDK bestimmte Schutzmaßnahmen für Kinder oder Teenager bei der Anzeigenbereitstellung anwenden soll. Wenn Sie die Einstellung verwenden, enthält Google Mobile Ads SDK den Parameter tfat in Anzeigenanfragen. Lassen Sie sich von Ihrem Rechtsbeistand beraten, um die anwendbare Alterskennzeichnung für Ihre Nutzer basierend auf Ihren rechtlichen und regulatorischen Verpflichtungen festzulegen. Weitere Informationen finden Sie unter Anzeigenanfragen mit einem Tag zur Altersbeschränkung versehen.
Sie können die Alterskennzeichnung mit der Methode setAgeRestrictedTreatment() über die RequestConfiguration.Builder-API festlegen.
Alterskennzeichnung für Kinder festlegen
Im folgenden Beispiel wird angegeben, dass Anzeigenanfragen eine Alterskennzeichnung für Kinder erhalten sollen:
Java
RequestConfiguration requestConfiguration =
MobileAds.getRequestConfiguration().toBuilder()
// Indicate that ad requests should have child age treatment.
.setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);Kotlin
val requestConfiguration =
MobileAds.getRequestConfiguration()
.toBuilder()
// Indicate that ad requests should have child age treatment.
.setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)Alterskennzeichnung für Teenager festlegen
Das folgende Beispiel zeigt, dass Anzeigenanfragen eine Alterskennzeichnung für Teenager erhalten sollen:
Java
RequestConfiguration requestConfiguration =
MobileAds.getRequestConfiguration().toBuilder()
// Indicate that ad requests should have teen age treatment.
.setAgeRestrictedTreatment(AgeRestrictedTreatment.TEEN)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);Kotlin
val requestConfiguration =
MobileAds.getRequestConfiguration()
.toBuilder()
// Indicate that ad requests should have teen age treatment.
.setAgeRestrictedTreatment(AgeRestrictedTreatment.TEEN)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)Keine spezifische Alterskennzeichnung festlegen
Im folgenden Beispiel wird angegeben, dass für Anzeigenanfragen keine bestimmte Alterskennzeichnung festgelegt werden soll:
Java
RequestConfiguration requestConfiguration =
MobileAds.getRequestConfiguration().toBuilder()
// Indicate that ad requests should have unspecified age treatment.
.setAgeRestrictedTreatment(AgeRestrictedTreatment.UNSPECIFIED)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);Kotlin
val requestConfiguration =
MobileAds.getRequestConfiguration()
.toBuilder()
// Indicate that ad requests should have unspecified age treatment.
.setAgeRestrictedTreatment(AgeRestrictedTreatment.UNSPECIFIED)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)Von TFCD und TFUA zur Alterskennzeichnung migrieren
Die Einstellung für die Alterskennzeichnung ersetzt die Einstellungen .setTagForChildDirectedTreatment() (TFCD) und .setTagForUnderAgeOfConsent() (TFUA), die nicht mehr unterstützt werden.
In der folgenden Tabelle sind die Einstellungen für „Tag für Kinder unter 13 Jahren“ (TFCD) und „Tag für Nutzer in der EU“ (TFUA) sowie die entsprechenden Altersfreigaben 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.
Einstellung „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 „Als Inhalte für Kinder kennzeichnen“. Indem Sie dieses Tag festlegen, bestätigen Sie, dass diese Benachrichtigung korrekt ist und Sie die Berechtigung haben, im Namen des App-Inhabers zu handeln. Sie sind sich bewusst, dass ein Missbrauch dieser Einstellung zur Kündigung Ihres Google-Kontos führen kann.
Als App-Entwickler können Sie bei einer Anzeigenanfrage angeben, ob Ihre Inhalte als auf Kinder ausgerichtet klassifiziert werden sollen. 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 Kinder“ über setTagForChildDirectedTreatment() anwenden:
Rufen Sie
setTagForChildDirectedTreatmentmitTAG_FOR_CHILD_DIRECTED_TREATMENT_TRUEauf, um anzugeben, dass Ihre Inhalte im Rahmen des COPPA als auf Kinder ausgerichtet behandelt werden sollen. Dadurch wird die Übertragung der Android-Werbe-ID (AAID) verhindert.Rufen Sie
setTagForChildDirectedTreatmentmitTAG_FOR_CHILD_DIRECTED_TREATMENT_FALSEauf, um anzugeben, dass Ihre Inhalte im Rahmen des COPPA nicht als Inhalte für Kinder behandelt werden sollen.Rufen Sie
setTagForChildDirectedTreatmentmitTAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIEDauf, 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 im Sinne von COPPA als auf Kinder ausgerichtet behandelt 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);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
Bei Verwendung dieser Funktion 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 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()mitTAG_FOR_UNDER_AGE_OF_CONSENT_TRUEauf, 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 (AAID) verhindert.Rufen Sie
setTagForUnderAgeOfConsent()mitTAG_FOR_UNDER_AGE_OF_CONSENT_FALSEauf, um anzugeben, dass die Anzeigenanfrage nicht für minderjährige Nutzer im Europäischen Wirtschaftsraum (EWR) verarbeitet werden soll.Rufen Sie
setTagForUnderAgeOfConsent()mitTAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIEDauf, um anzugeben, dass Sie nicht angegeben haben, ob die Anzeigenanfrage für minderjährige Nutzer im Europäischen Wirtschaftsraum (EWR) verarbeitet werden soll.
Das folgende Beispiel zeigt, dass Sie TFUA in Ihre Anzeigenanfragen einbeziehen möchten:
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 werden. Sollte dieser Fall eintreten, hat die Einstellung „Für Kinder“ Vorrang.
Filtern von Anzeigeninhalten
Um der Richtlinie zu unangemessenen Anzeigen von Google Play zu entsprechen, 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 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 Nutzerinnen und Nutzern in Anzeigen präsentiert werden. Sie können eine maximale Altersfreigabe festlegen, um die Einhaltung der Plattformrichtlinien zu unterstützen.
Apps können mit der Methode
setMaxAdContentRating
eine höchste 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_GMAX_AD_CONTENT_RATING_PGMAX_AD_CONTENT_RATING_TMAX_AD_CONTENT_RATING_MA
Im folgenden Code wird ein RequestConfiguration-Objekt so konfiguriert, dass zurückgegebene Anzeigeninhalte einer Kennzeichnung 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-API (PPT) ist ein optionales Tool, mit dem Apps angeben können, ob die Personalisierung von Anzeigen 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) aufgenommen.
Anzeigenanfragen an Google führen standardmäßig zur Auslieferung personalisierter Anzeigen. Mit dem folgenden Code wird die Anzeigenpersonalisierung 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 AdManagerAdRequest-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)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 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()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. So können Sie beispielsweise Personen im mittleren 20er-Alter ansprechen und nicht nur 25-Jährige.
Kotlin
.addCustomTargeting("age", listOf("24", "25", "26"))Java
.addCustomTargeting("age", Arrays.asList("24", "25", "26"))Kategorieausschlüsse
Sie können einer Anfrage eine Ausschlussstufe für Kategorien auf Slot-Ebene hinzufügen, indem Sie die Methode addCategoryExclusion() verwenden:
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 example.
Vom Publisher bereitgestellte Kennungen
Sie können eine vom Publisher bereitgestellte Kennung (Publisher Provided Identifier, PPID) für Frequency Capping, Zielgruppensegmentierung und ‑targeting, sequenzielle Anzeigenrotation und andere zielgruppenbasierte Einstellungen der Anzeigenauslieferung auf verschiedenen Geräten festlegen.
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();Beispiel für Ad Manager-PPID für eine Implementierung von Publisher Provided Identifiers (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 zur Verbesserung der programmatischen Monetarisierung verwenden, indem Sie Ihre Zielgruppenmerkmale mithilfe von Standardtaxonomien an Bieter in allen Transaktionstypen weitergeben, ohne Nutzer-IDs freizugeben. 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 inhaltsbezogene 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()Java
AdManagerAdRequest.Builder builder = new AdManagerAdRequest.Builder();
builder.setContentUrl("https://www.example.com");
AdManagerAdRequest request = builder.build();Markensicherheit (Beta)
Anwendungen, in denen dynamische Inhalte für unterschiedliche Zielgruppen angezeigt werden, können eine kurze Liste von URLs angeben:
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.