Ausrichtung

In dieser Anleitung wird erläutert, wie Sie dem Google Mobile Ads SDK Targeting-Informationen bereitstellen.

Voraussetzungen

Bevor Sie fortfahren, richten Sie GMA Next-Gen SDK ein.

RequestConfiguration

RequestConfiguration erfasst Targeting-Informationen, die global auf jede Anzeigenanfrage angewendet werden. Verfügbare Targeting-Tags finden Sie in der RequestConfiguration.Builder Dokumentation.

Erstellen Sie ein RequestConfiguration Objekt mit den gewünschten Targeting-Tags mit dem Builder und legen Sie die Konfiguration dann mit MobileAds.setRequestConfiguration() fest.

Wichtig: Wenn Sie MobileAds.setRequestConfiguration() aufrufen, wird jede vorhandene Konfiguration ersetzt.

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 bei 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

Das GMA Next-Gen SDK bietet eine Einstellung für die Alterskennzeichnung, mit der Sie die Einhaltung der geltenden Datenschutzbestimmungen für Kinder und Jugendliche besser verwalten können. Mit dieser Einstellung können Sie angeben, ob GMA Next-Gen SDK bestimmte Schutzmaßnahmen für die Anzeigenbereitstellung für Kinder oder Jugendliche anwenden soll. Wenn Sie die Einstellung verwenden, GMA Next-Gen SDK fügt einen tfat Parameter in Anzeigenanfragen ein. 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 aus Apps als Inhalte mit Altersbeschränkung kennzeichnen.

Sie können die Alterskennzeichnung mit der setAgeRestrictedTreatment() Methode mit der RequestConfiguration.Builder API festlegen.

Alterskennzeichnung für Kinder festlegen

Im folgenden Beispiel wird angegeben, dass Anzeigenanfragen als Inhalte für Kinder gekennzeichnet werden sollen:

Kotlin

val requestConfiguration =
  RequestConfiguration.Builder()
    // Indicate that ad requests should have child age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

Java

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

Alterskennzeichnung für Jugendliche festlegen

Im folgenden Beispiel wird angegeben, dass Anzeigenanfragen als Inhalte für Jugendliche gekennzeichnet werden sollen:

Kotlin

val requestConfiguration =
  RequestConfiguration.Builder()
    // Indicate that ad requests should have teenage treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.TEEN)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    new RequestConfiguration.Builder()
        // Indicate that ad requests should have teenage treatment.
        .setAgeRestrictedTreatment(AgeRestrictedTreatment.TEEN)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

Keine spezifische Alterskennzeichnung festlegen

Im folgenden Beispiel wird angegeben, dass Anzeigenanfragen keine spezifische Alterskennzeichnung erhalten sollen:

Kotlin

val requestConfiguration =
  RequestConfiguration.Builder()
    // Indicate that ad requests should have unspecified age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.UNSPECIFIED)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    new RequestConfiguration.Builder()
        // Indicate that ad requests should have unspecified age treatment.
        .setAgeRestrictedTreatment(AgeRestrictedTreatment.UNSPECIFIED)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

Von TFCD und TFUA zur Alterskennzeichnung migrieren

Die Einstellung für die Alterskennzeichnung ersetzt die verworfenen Einstellungen .setTagForChildDirectedTreatment() (TFCD) und .setTagForUnderAgeOfConsent() (TFUA).

In der folgenden Tabelle sind die TFCD- und TFUA-Einstellungen und die entsprechenden Alterskennzeichnungen 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 zwischen Alterskennzeichnung und 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 Designed for Families Programm, die als hauptsächlich auf Kinder ausgerichtet gekennzeichnet sind und bei Nutzern, die in Google-Konten angemeldet sind, die mit Family Link verwaltet werden, werden alle Inhalte für alle Anzeigenanfragen automatisch als Inhalte für Kinder behandelt.

Einstellung für Inhalte für Kinder

Warnung: Die Methode setTagForChildDirectedTreatment() wurde verworfen. Legen Sie stattdessen die Methode setAgeRestrictedTreatment() fest.

Für das US-Gesetz zum Schutz der Privatsphäre von Kindern im Internet (Children's Online Privacy Protection Act (COPPA), gibt es eine Einstellung namens „Tag für Inhalte für Kinder“. Wenn Sie dieses Tag festlegen, bestätigen Sie, dass diese Benachrichtigung korrekt ist und Sie die Berechtigung haben, im Auftrag des App-Inhabers zu handeln. Sie sind sich 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 klassifizieren soll, deaktivieren wir interessenbezogene Werbung und Remarketing-Anzeigen für diese Anzeigenanfrage.

Sie können die Einstellung für Inhalte für Kinder über setTagForChildDirectedTreatment() anwenden:

• Rufen Sie setTagForChildDirectedTreatment mit TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE auf, um anzugeben, dass Ihre Inhalte gemäß COPPA als Inhalte für Kinder behandelt werden sollen. Dadurch wird die Übertragung der Android-Werbe-ID (Android Advertising ID, AAID) verhindert.

• Rufen Sie setTagForChildDirectedTreatment mit TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE auf, um anzugeben, dass Ihre Inhalte gemäß COPPA nicht als Inhalte für Kinder 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.

Im folgenden Beispiel wird angegeben, dass Ihre Inhalte gemäß COPPA als Inhalte für Kinder behandelt 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);

Hinweis: Bei Apps im Designed for Families Programm, die als hauptsächlich auf Kinder ausgerichtet gekennzeichnet sind und bei Nutzern, die in Google-Konten angemeldet sind, die mit Family Link verwaltet werden, werden alle Inhalte für alle Anzeigenanfragen automatisch als Inhalte für Kinder behandelt.

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

Warnung: Die Methode setTagForUnderAgeOfConsent() wurde verworfen. Legen Sie stattdessen die set Methode setAgeRestrictedTreatment() fest.

Sie können Ihre Anzeigenanfragen für die 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 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 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 für Kinder 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 minderjährige Nutzer im Europäischen Wirtschaftsraum (EWR) verarbeitet werden soll. Dadurch wird auch die Übertragung der Android-Werbe-ID (Android Advertising 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 festgelegt 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 Ihre Anzeigenanfragen aufgenommen werden 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 für Inhalte für Kinder und setTagForUnderAgeOfConsent() sollten nicht gleichzeitig auf true gesetzt werden. Sollte dieser Fall auftreten, hat die Einstellung für Inhalte für Kinder Vorrang.

Anzeigeninhalte filtern

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, der jeweiligen 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 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 setMaxAdContentRating Methode eine höchste Altersfreigabe für Anzeigeninhalte für ihre Anzeigenanfragen festlegen. AdMob-Anzeigen, die zurückgegeben werden, wenn diese Einstellung konfiguriert ist, haben eine Altersfreigabe, die dieser Stufe entspricht oder niedriger ist. Die möglichen Werte für diese Netzwerkerweiterung basieren auf den Klassifizierungen von Labels für digitale Inhalte 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

Der folgende Code konfiguriert ein RequestConfiguration-Objekt, um anzugeben, dass die zurückgegebenen Anzeigeninhalte ein Label für digitale Inhalte haben müssen, das 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:

• Höchste Altersfreigabe für einzelne Anzeigenanfragen festlegen

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

Hinweis: Die über GMA Next-Gen SDK festgelegten Filtereinstellungen für die Altersfreigabe für Inhalte überschreiben alle 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 mithilfe der setPublisherPrivacyPersonalizationState() Methode angeben können, ob personalisierte Anzeigen für alle Anzeigenanfragen deaktiviert werden sollen. 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 für Anzeigenanfragen an Google personalisierte Anzeigen ausgeliefert. Mit dem folgenden Code wird die Personalisierung von Anzeigen 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);

Hinweis: Bei Anzeigenanfragen mit mehreren Signalen zum Datenschutz von Nutzern 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.

Netzwerkerweiterungen hinzufügen

Netzwerkerweiterungen sind zusätzliche Details, die mit einer Anzeigenanfrage gesendet werden und für eine einzelne Anzeigenquelle spezifisch sind.

Im folgenden Code-Snippet wird für Google ein zusätzlicher Parameterschlüssel collapsible mit dem Wert bottom festgelegt:

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);