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
- Führen Sie die Schritte im Startleitfaden aus.
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()
.toBuilder()
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.build();
MobileAds.setRequestConfiguration(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 Rahmen des US-Gesetzes zum Schutz der Privatsphäre von Kindern im Internet (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 berechtigt sind, im Namen des App-Inhabers 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 Kinder“ über setTagForChildDirectedTreatment()
anwenden:
Rufen Sie
setTagForChildDirectedTreatment
mitTAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE
auf, 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
setTagForChildDirectedTreatment
mitTAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE
auf, um anzugeben, dass Ihre Inhalte im Rahmen des COPPA nicht als Inhalte für Kinder behandelt werden sollen.Rufen Sie
setTagForChildDirectedTreatment
mitTAG_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 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 Mindestalter für Google-Konten 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 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 an Drittanbieter gerichtete Anfragen deaktiviert, z. B. Tracking-Pixel und Ad-Server eines Drittanbieters.
Wie bei den Einstellungen für Inhalte, die auf Kinder ausgerichtet 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_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 (AAID) verhindert.Rufen Sie
setTagForUnderAgeOfConsent()
mitTAG_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()
mitTAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED
auf, 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.
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 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 kontrollieren, welche Inhalte Nutzern in Anzeigen präsentiert werden. Diese Einstellung hilft Ihnen, die Plattformrichtlinien einzuhalten.
Apps können mit der Methode
setMaxAdContentRating
eine höchste Altersfreigabe für Anzeigeninhalte für ihre Anzeigenanfragen festlegen. Für AdMob-Anzeigen, die bei dieser Konfiguration zurückgegeben werden, gilt eine Altersfreigabe für Inhalte, die dieser Stufe entspricht oder darunter liegt. Die möglichen Werte für diese Netzwerk-Extras 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 einer Kennzeichnung für digitales Content-Label 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);
Hier findest du weitere Informationen:
Höchste Altersfreigabe für einzelne Anzeigenanfragen festlegen
Höchste Altersfreigabe für Anzeigeninhalte für eine App oder ein Konto festlegen
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(PublisherPrivacyPersonalizationState.DISABLED)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
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()
adLoader.loadAd(adRequest)
Java
Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
AdRequest adRequest = new AdRequest.Builder()
.addNetworkExtrasBundle(AdMobAdapter.class, extras)
.build();
adLoader.loadAd(adRequest);