In diesem Leitfaden wird erläutert, wie Sie dem Google Mobile Ads SDK Targeting-Informationen zur Verfügung stellen.
Voraussetzungen
Bevor Sie fortfahren, richten Sie GMA Next-Gen SDK 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.
Erstellen Sie mit dem Builder ein RequestConfiguration-Objekt mit den erforderlichen Targeting-Tags und legen Sie dann die Konfiguration fest, indem Sie MobileAds.setRequestConfiguration() aufrufen.
Kotlin
val requestConfiguration = RequestConfiguration
.Builder()
// Set your targeting tags.
.setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = new RequestConfiguration
.Builder()
// Set your targeting tags.
.setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Wenn Sie Targeting-Tags aus der ersten Anzeigenanfrage anwenden möchten, geben Sie die Anfragekonfiguration während der SDK-Initialisierung an:
Kotlin
val requestConfiguration = RequestConfiguration
.Builder()
// Set your targeting tags.
.setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build()
CoroutineScope(Dispatchers.IO).launch {
// Initialize GMA Next-Gen SDK on a background thread.
MobileAds.initialize(
this@MainActivity,
InitializationConfig
// Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
.Builder("SAMPLE_APP_ID")
.setRequestConfiguration(requestConfiguration)
.build()
) {
// Adapter initialization is complete.
}
// Other methods on MobileAds can now be called.
}
Java
RequestConfiguration requestConfiguration = new RequestConfiguration
.Builder()
// Set your targeting tags.
.setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build();
new Thread(
() -> {
// Initialize GMA Next-Gen SDK on a background thread.
MobileAds.initialize(
this,
// Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
new InitializationConfig
.Builder("SAMPLE_APP_ID")
.setRequestConfiguration(requestConfiguration)
.build(),
initializationStatus -> {
// Adapter initialization is complete.
});
// Other methods on MobileAds can now be called.
})
.start();
Alterskennzeichnung festlegen
Damit Sie die Einhaltung der geltenden Datenschutzbestimmungen für Kinder und Jugendliche besser verwalten können, bietet GMA Next-Gen SDK eine Einstellung für die Altersbehandlung. Mit der Einstellung für die Alterskennzeichnung können Sie angeben, ob GMA Next-Gen SDK bestimmte Schutzmaßnahmen für die Anzeigenbereitstellung für Kinder, Teenager 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 =
RequestConfiguration.Builder()
// Indicate that ad requests should have child age treatment.
.setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)Java
RequestConfiguration requestConfiguration =
new RequestConfiguration.Builder()
// 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:
TEENUNSPECIFIED
Wenn Sie die Einstellung verwenden, fügt GMA Next-Gen SDK 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 aus Apps als Inhalte mit Altersbeschränkung kennzeichnen.
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 AdMob Mediation weiterleiten
Wenn Sie die Alterskennzeichnung mit GMA Next-Gen SDK 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
setTagForChildDirectedTreatmentmitTAG_FOR_CHILD_DIRECTED_TREATMENT_TRUEauf, 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
setTagForChildDirectedTreatmentmitTAG_FOR_CHILD_DIRECTED_TREATMENT_FALSEauf, um anzugeben, dass Ihre Inhalte im Sinne des COPPA nicht als Inhalte für Kinder behandelt werden sollen.Rufen Sie
setTagForChildDirectedTreatmentmitTAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIEDauf, 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 = RequestConfiguration
.Builder()
.setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = new RequestConfiguration
.Builder()
.setTagForChildDirectedTreatment(TagForChildDirectedTreatment.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 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 Inhalte, die speziell auf Kinder ausgerichtet sind, gibt es auch 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 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()mitTAG_FOR_UNDER_AGE_OF_CONSENT_FALSEauf, 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()mitTAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIEDauf, 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 = RequestConfiguration
.Builder()
.setTagForUnderAgeOfConsent(RequestConfiguration.TagForUnderAgeOfConsent.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = new RequestConfiguration
.Builder()
.setTagForUnderAgeOfConsent(TagForUnderAgeOfConsent.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_GMAX_AD_CONTENT_RATING_PGMAX_AD_CONTENT_RATING_TMAX_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 = RequestConfiguration
.Builder()
.setMaxAdContentRating(RequestConfiguration.MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = new RequestConfiguration
.Builder()
.setMaxAdContentRating(MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Weitere Informationen zu folgenden Themen:
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 (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 = RequestConfiguration
.Builder()
.setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = new RequestConfiguration
.Builder()
.setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Ungefähren Standort erfassen
GMA Next-Gen SDK kann den ungefähren Standort erfassen, um Anzeigen basierend auf dem Gerätestandort auszurichten. Wenn ein Nutzer in Ihrer App die Berechtigung zur Standortermittlung erteilt, erfasst GMA Next-Gen SDK den ungefähren Standort.
Ab GMA Next-Gen SDK-Version 1.7.0 ist die Erfassung des ungefähren Standorts standardmäßig aktiviert. Sie können die Erfassung des ungefähren Standorts mit der Methode setCoarseLocationCollectionEnabled() deaktivieren.
Im folgenden Beispiel wird die Erfassung des ungefähren Standorts deaktiviert:
Kotlin
val requestConfiguration =
RequestConfiguration.Builder()
// Disable automatic coarse location collection by the SDK.
.setCoarseLocationCollectionEnabled(false)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)Java
RequestConfiguration requestConfiguration =
new RequestConfiguration.Builder()
// Disable automatic coarse location collection by the SDK.
.setCoarseLocationCollectionEnabled(false)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);Anzeigenanfrage
Das Objekt AdRequest 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 =
NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAd.NativeAdType.NATIVE))
.setGoogleExtrasBundle(extras)
.build()
NativeAdLoader.load(adRequest, adCallback)
Java
Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
NativeAdRequest adRequest =
new NativeAdRequest.Builder("AD_UNIT_ID", Arrays.asList(NativeAd.NativeAdType.NATIVE))
.setGoogleExtrasBundle(extras)
.build();
NativeAdLoader.load(adRequest, adCallback);