Ausrichtung

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

Voraussetzungen

Richten Sie zuerst ein GMA Next-Gen SDK.

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.

val requestConfiguration = RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

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:

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 Ad Manager 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.
}

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 Ad Manager 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();

Altersangabe festlegen

Das GMA Next-Gen SDK bietet eine Einstellung für die Altersangabe, mit der Sie die Einhaltung der geltenden Datenschutzbestimmungen für Kinder und Jugendliche besser verwalten können. Mit dieser Einstellung für die Altersbehandlung 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 das für Ihre Nutzer geltende Mindestalter auf Grundlage Ihrer rechtlichen und aufsichtsrechtlichen Verpflichtungen zu bestimmen.

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

Altersangabe für Kinder festlegen

Im folgenden Beispiel wird angegeben, dass Anzeigenanfragen die Altersangabe für Kinder erhalten sollen:

val requestConfiguration = MobileAds.getRequestConfiguration().toBuilder()
    // Indicate that ad requests should have child age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
    // Indicate that ad requests should have child age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Altersangabe für Jugendliche festlegen

Im folgenden Beispiel wird angegeben, dass Anzeigenanfragen die Altersangabe für Jugendliche erhalten sollen:

val requestConfiguration = MobileAds.getRequestConfiguration().toBuilder()
    // Indicate that ad requests should have teenage treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.TEEN)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
    // Indicate that ad requests should have teenage treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.TEEN)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Keine bestimmte Altersangabe festlegen

Im folgenden Beispiel wird angegeben, dass Anzeigenanfragen keine bestimmte Altersangabe erhalten sollen:

val requestConfiguration = MobileAds.getRequestConfiguration().toBuilder()
    // Indicate that ad requests should have unspecified age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.UNSPECIFIED)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

RequestConfiguration 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 Altersangabe migrieren

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

In der folgenden Tabelle sind die TFCD- und TFUA-Einstellungen und die entsprechenden Altersangaben aufgeführt:

Interaktionen zwischen Altersangabe und TFCD und TFUA

Wenn Sie die Einstellung für die Altersangabe und die TFCD- oder TFUA-Einstellungen festlegen, wendet Google die konservativste Behandlung an.

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 eine Einstellung namens "Tag zur Klassifizierung als Inhalte für Kinder". Wenn Sie dieses Tag festlegen, bestätigen Sie, dass diese Benachrichtigung korrekt ist und Sie berechtigt sind, im Namen des Inhabers der App 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, ergreifen wir Maßnahmen, um interessenbezogene Werbung und Remarketing-Anzeigen für diese Anzeigenanfrage zu deaktivieren.

Sie können die Einstellung „Für Kinder“ über setTagForChildDirectedTreatment() anwenden:

• Rufen Sie setTagForChildDirectedTreatment mit TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE auf, um anzugeben, dass Ihre Inhalte im Hinblick auf COPPA als auf Kinder ausgerichtet 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 im Hinblick auf COPPA _nicht_ als auf Kinder ausgerichtet 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 im Hinblick auf COPPA behandelt werden sollen.

Im folgenden Beispiel wird angegeben, dass Ihre Inhalte im Hinblick auf COPPA als auf Kinder ausgerichtet behandelt werden sollen:

val requestConfiguration = RequestConfiguration
  .Builder()
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

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 für die Verarbeitung für Nutzer im Europäischen Wirtschaftsraum (EWR) kennzeichnen, die das gültige Mindestalter noch nicht erreicht haben. 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 in Europa, die das gültige Mindestalter noch nicht erreicht haben) 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 Nutzer im Europäischen Wirtschaftsraum (EWR) verarbeitet werden soll, die das gültige Mindestalter noch nicht erreicht haben. 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 Nutzer im Europäischen Wirtschaftsraum (EWR) verarbeitet werden soll, die das gültige Mindestalter noch nicht erreicht haben.

• Rufen Sie setTagForUnderAgeOfConsent() mit TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED auf, um anzugeben, dass Sie nicht festgelegt haben, ob die Anzeigenanfrage für Nutzer im Europäischen Wirtschaftsraum (EWR) verarbeitet werden soll, die das gültige Mindestalter noch nicht erreicht haben.

Im folgenden Beispiel wird angegeben, dass TFUA in Ihre Anzeigenanfragen aufgenommen werden soll:

val requestConfiguration = RequestConfiguration
  .Builder()
  .setTagForUnderAgeOfConsent(RequestConfiguration.TagForUnderAgeOfConsent.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

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 Kinder“ und setTagForUnderAgeOfConsent() sollten nicht gleichzeitig auf true gesetzt werden. Sollte dieser Fall auftreten, hat die Einstellung „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 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 Kennzeichnungen für digitale Inhalteund 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 einer Kennzeichnung für digitale Inhalte entsprechen müssen, die nicht höher als G ist:

val requestConfiguration = RequestConfiguration
  .Builder()
  .setMaxAdContentRating(RequestConfiguration.MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setMaxAdContentRating(MaxAdContentRating.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 (PPT) API ist ein optionales Tool, mit dem Apps angeben können, ob personalisierte Anzeigen für alle Anzeigenanfragen mit der setPublisherPrivacyPersonalizationState() Methode deaktiviert werden sollen. Wenn Sie diese Funktion verwenden, wird der Parameter „Publisher Privacy Treatment“ (PPT) für den Rest der Sitzung in alle zukünftigen Anzeigenanfragen aufgenommen.

Standardmäßig werden für Anzeigenanfragen an Google personalisierte Anzeigen ausgeliefert. Mit dem folgenden Code werden personalisierte Anzeigen für alle Anzeigenanfragen deaktiviert:

val requestConfiguration = RequestConfiguration
  .Builder()
  .setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

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.

Mit dem folgenden Code-Snippet wird ein zusätzlicher Parameterschlüssel collapsible mit dem Wert bottom an Google gesendet:

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)

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

Benutzerdefiniertes Targeting

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:

// Example: Pass custom targeting "age=25".
val newRequest = AdRequest.Builder("AD_UNIT_ID")
  .putCustomTargeting("age", "25")
  .build()

// Example: Pass custom targeting "age=25".
AdRequest newRequest = new AdRequest.Builder("AD_UNIT_ID")
  .putCustomTargeting("age", "25")
  .build();

Sie können mehrere Werte für einen Schlüssel als Liste von Strings übergeben. Beispielsweise, um auf Personen im Alter von 20 bis 29 Jahren auszurichten und nicht nur auf 25-Jährige.

.putCustomTargeting("age", listOf("24", "25", "26"))

.putCustomTargeting("age", Arrays.asList("24", "25", "26"));

Kategorieausschlüsse

Sie können einer Anfrage einen Kategorieausschluss auf Slot-Ebene hinzufügen, indem Sie die addCategoryExclusion() Methode verwenden:

// Example: Exclude "automobile" and "boat" categories.
val newRequest = AdRequest.Builder("AD_UNIT_ID")
  .addCategoryExclusion("automobile")
  .addCategoryExclusion("boat")
  .build()

// Example: Exclude "automobile" and "boat" categories.
AdRequest newRequest = new AdRequest.Builder("AD_UNIT_ID")
    .addCategoryExclusion("automobile")
    .addCategoryExclusion("boat")
    .build();

Im Beispiel für Kategorieausschlüsse in Ad Manager finden Sie eine Implementierung von Kategorieausschlüssen in der Android API Demo App.

Vom Publisher bereitgestellte Kennungen

Sie können eine vom Publisher bereitgestellte Kennung (Publisher Provided Identifier, PPID) für das Frequency Capping, die Zielgruppensegmentierung und das Targeting auf Zielgruppen, die sequenzielle Anzeigenrotation und andere Funktionen zur zielgruppenbasierten Anzeigenauslieferung auf beliebigen Geräten festlegen.

Hier ist ein Beispiel für das Festlegen der PPID:

val adRequest = AdRequest.Builder("AD_UNIT_ID")
  .setPublisherProvidedId("AB123456789")
  .build()

AdRequest adRequest = new AdRequest.Builder("AD_UNIT_ID")
    .setPublisherProvidedId("AB123456789")
    .build();

Im Beispiel für PPIDs in Ad Manager finden Sie eine Implementierung von vom Publisher bereitgestellten Kennungen (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 verwenden, um die programmatische Monetarisierung zu verbessern. Dazu geben Sie Ihre Zielgruppeneigenschaften an Bieter in allen Transaktionstypen mithilfe von Standardtaxonomien weiter, ohne Nutzerkennungen freizugeben. Zu Ihren Zielgruppen eigenschaften können Verhaltens- und interessenbezogene Daten (IAB-Taxonomie für Zielgruppen 1.1) und Kontext daten (IAB-Taxonomie für Inhalte 2.2) gehören.

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 = AdRequest.Builder("AD_UNIT_ID")
  .setGoogleExtrasBundle(extras)
  .build()

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", arrayListOf(6,284));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6));

AdRequest request = new AdRequest.Builder("AD_UNIT_ID")
  .setGoogleExtrasBundle(extras)
  .build();

Inhalts-URL

Wenn Sie eine Inhalts-URL für auf Inhalte ausgerichtete Anzeigen und die Markensicherheit angeben möchten, fügen Sie Folgendes hinzu:

val builder = AdRequest.Builder("AD_UNIT_ID")
builder.setContentUrl("https://www.example.com")
val request = builder.build()

AdRequest.Builder builder = new AdRequest.Builder("AD_UNIT_ID")
builder.setContentUrl("https://www.example.com");
AdRequest request = builder.build();

Markensicherheit (Beta)

Anwendungen, die dynamische Inhalte für unterschiedliche Zielgruppen anzeigen, können eine kurze Liste von URLs angeben:

val urls = mutableListOf("https://www.mycontenturl1.com", "https://www.mycontenturl2.com",
                         "https://www.mycontenturl3.com", "https://www.mycontenturl4.com")
val requestWithContent = AdRequest.Builder("AD_UNIT_ID")
  .setNeighboringContentUrls(urls)
  .build()

ArrayList<String> urls = new ArrayList<String>();
urls.add("https://www.mycontenturl1.com");
urls.add("https://www.mycontenturl2.com");
urls.add("https://www.mycontenturl3.com");
urls.add("https://www.mycontenturl4.com");
AdRequest requestWithContent = new AdRequest.Builder("AD_UNIT_ID")
    .setNeighboringContentUrls(urls)
    .build();

.setNeighboringContentUrls() unterscheidet sich von .setContentUrl() dadurch, dass es nur für die Markensicherheit verwendet wird.