In diesem Leitfaden erfahren Sie, wie Sie dem Google Mobile Ads SDK Targeting-Informationen zur Verfügung stellen.
Laden Sie die Android API Demo App herunter, um ein funktionierendes Beispiel zu sehen.Vorbereitung
- Führen Sie die Schritte im Startleitfaden aus.
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()
.toBuilder()
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Einstellung für Inhalte für Kinder
Gemäß dem US-Gesetz 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 einfügen, bestätigen Sie, dass diese Mitteilung korrekt ist und Sie berechtigt sind, im Namen des Inhabers der App zu handeln. Ihnen ist 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 einstufen soll, deaktivieren wir interessenbezogene Werbung und Remarketing-Anzeigen für diese Anzeigenanfrage.
Sie können die Einstellung für Apps für Kinder über
setTagForChildDirectedTreatment()
:
Rufen Sie
setTagForChildDirectedTreatment
mitTAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE
auf, um anzugeben, dass Ihre Inhalte im Rahmen von COPPA als für Kinder bestimmt behandelt werden sollen. Dadurch wird die Übertragung der Android-Werbe-ID (AAID) verhindert.Rufen Sie
setTagForChildDirectedTreatment
mitTAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE
an, um anzugeben, dass Ihre Inhalte nicht gemäß dem COPPA als Inhalte für Kinder behandelt werden sollen.Rufen Sie
setTagForChildDirectedTreatment
mitTAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED
an, wenn Sie nicht angeben möchten, wie Ihre Inhalte in Anzeigenanfragen gemäß COPPA behandelt werden sollen.
Im folgenden Beispiel wird angegeben, dass Ihre Inhalte gemäß COPPA als für Kinder bestimmt 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 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
Bei Verwendung dieser Funktion wird der Parameter „Tag für minderjährige Nutzer in Europa“ (TFUA) 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 auf Kinder ausgerichtete Inhalte gibt es auch in RequestConfiguration.Builder
eine Methode zum Festlegen des TFUA-Parameters:
setTagForUnderAgeOfConsent()
und.
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. Außerdem wird dadurch die Übertragung der Android-Werbe-ID (Android Advertising Identifier, AAID) verhindert.Rufen Sie
setTagForUnderAgeOfConsent()
mitTAG_FOR_UNDER_AGE_OF_CONSENT_FALSE
auf, um anzugeben, dass die Anzeigenanfrage nicht für Nutzer im Europäischen Wirtschaftsraum (EWR) verarbeitet werden soll, die das erforderliche Mindestalter noch nicht erreicht haben.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.
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, mit denen die Einstellung für Inhalte für Kinder aktiviert wird, und setTagForUnderAgeOfConsent()
sollten nicht gleichzeitig auf true
gesetzt werden.
Sollte dieser Fall auftreten, hat die Einstellung für die Klassifizierung von Inhalten für Kinder Vorrang.
Filterung von Anzeigeninhalten
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, für die Altersfreigabe Ihrer App geeignet sein, auch wenn die Inhalte selbst ansonsten mit den Richtlinien von Google Play übereinstimmen.
Mit Tools wie der höchsten Altersfreigabe für Anzeigeninhalte können Sie besser steuern, welche Inhalte Nutzern in Anzeigen präsentiert werden. Diese Einstellung hilft Ihnen, die Plattformrichtlinien einzuhalten.
Mit der Methode
setMaxAdContentRating
können Entwickler eine höchste Altersfreigabe für Anzeigeninhalte für ihre Anzeigenanfragen festlegen. AdMob-Anzeigen, die bei dieser Konfiguration zurückgegeben werden, haben eine Altersfreigabe, die dieser Altersfreigabe entspricht oder darunter liegt. Die möglichen Werte für dieses Netzwerk-Extra basieren auf den 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 mit einer maximalen Kennzeichnung von G
entsprechen müssen:
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 auf App- oder Kontoebene festlegen
Publisher Privacy Treatment (Beta)
Die
Publisher Privacy Treatment
API (PPT API) ist ein optionales Tool, mit dem Apps angeben können, ob personalisierte Anzeigen für alle Anzeigenanfragen mithilfe der Methode setPublisherPrivacyPersonalizationState()
deaktiviert werden sollen.
Wenn Sie diese Funktion verwenden, wird der Parameter „Publisher Privacy Treatment“ (PPT) in alle zukünftigen Anzeigenanfragen für den Rest der Sitzung aufgenommen.
Bei Anzeigenanfragen an Google werden standardmäßig personalisierte Anzeigen ausgeliefert. 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
Im AdRequest
-Objekt werden Targeting-Informationen erfasst, die mit einer Anzeigenanfrage gesendet werden.
In diesem Beispiel wird das Anzeigen-Targeting in der Android API-Demo-App implementiert.