Wenn Sie sich mit anderen Nutzern über unsere Produkte austauschen und Feedback geben möchten, treten Sie dem offiziellen Ad Manager-Discord-Kanal auf dem Server der Google Advertising and Measurement Community bei.

Diese Seite wurde von der Cloud Translation API übersetzt.

Ausrichtung

Plattform auswählen:Android iOS Unity Flutter

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.

API-Demo herunterladen

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, müssen Sie die Anfragekonfiguration festlegen, bevor Sie das Google 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 mit TAG_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 mit TAG_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 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.

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() 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 (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 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 für 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, 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 mit einem Label für digitalen Content entsprechen, das 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);

Weitere Informationen zum Festlegen der höchsten Altersfreigabe für einzelne Anzeigenanfragen

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

Benutzerdefinierte Ausrichtung

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:

Kotlin

// Example: Pass custom targeting "age=25".
val newRequest = AdManagerAdRequest.Builder()
  .addCustomTargeting("age", "25")
  .build()

Java

// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest = new AdManagerAdRequest.Builder()
    .addCustomTargeting("age", "25")
    .build();

Sie können mehrere Werte für einen Schlüssel als Liste von Strings übergeben. So können Sie beispielsweise Personen im mittleren Zwanzigeralter ansprechen und nicht nur 25-Jährige.

.addCustomTargeting("age", Arrays.asList("24", "25", "26"))

Ein Beispiel für die Implementierung von benutzerdefiniertem Targeting in der Android API Demo-App finden Sie unter Ad Manager Custom Targeting.

Kategorieausschlüsse

Sie können einer Anfrage eine Ausschlussstufe für Kategorien auf Slot-Ebene hinzufügen, indem Sie die Methode addCategoryExclusion() verwenden:

Kotlin

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

Java

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

Ein Beispiel für die Implementierung von Kategorieausschlüssen in der Android API Demo-App finden Sie unter Ad Manager Category Exclusions example.

Vom Publisher bereitgestellte Kennungen

Sie können eine vom Publisher bereitgestellte Kennung (Publisher Provided Identifier, PPID) für Frequency Capping, Zielgruppensegmentierung und ‑targeting, sequenzielle Anzeigenrotation und andere zielgruppenbasierte Einstellungen der Anzeigenauslieferung auf verschiedenen Geräten festlegen.

Hier ein Beispiel für das Festlegen der PPID:

Kotlin

val adRequest = AdManagerAdRequest.Builder()
  .setPublisherProvidedId("AB123456789")
  .build()

Java

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

Beispiel für Ad Manager-PPID für eine Implementierung von Publisher Provided Identifiers (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 vom Publisher bereitgestellten Signalen können Sie Ihre Nutzerdaten zur Verbesserung der programmatischen Monetarisierung verwenden, indem Sie Ihre Zielgruppenmerkmale mithilfe von Standardtaxonomien an Bieter in allen Transaktionstypen weitergeben, ohne Nutzerkennzeichnungen freizugeben. Zu Ihren Zielgruppenmerkmalen können verhaltens- und interessenbezogene Daten (IAB-Taxonomie für Zielgruppen 1.1) und kontextbezogene Daten (IAB-Taxonomie für Inhalte 2.2) gehören.

Kotlin

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 = AdManagerAdRequest.Builder()
  .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
  .build()

Java

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

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
  .addNetworkExtrasBundle(AdMobAdapter.class, extras)
  .build();

Inhalts-URL

Wenn Sie eine Content-URL für inhaltsbezogene Anzeigen und Markensicherheit angeben möchten, fügen Sie Folgendes hinzu:

Kotlin

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

Java

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

Markensicherheit (Beta)

Anwendungen, in denen dynamische Inhalte für unterschiedliche Zielgruppen angezeigt werden, können eine kurze Liste von URLs angeben:

Kotlin

val urls = mutableListOf("https://www.mycontenturl1.com", "https://www.mycontenturl2.com",
                         "https://www.mycontenturl3.com", "https://www.mycontenturl4.com")

val requestWithContent = AdManagerAdRequest.Builder()
  .setNeighboringContentUrls(urls)
  .build()

Java

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

AdManagerAdRequest requestWithContent = new AdManagerAdRequest.Builder()
    .setNeighboringContentUrls(urls)
    .build();

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

Ausrichtung Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Voraussetzungen

RequestConfiguration

Kotlin

Java

Einstellung „Für Kinder“

Kotlin

Java

Nutzer, die das Mindestalter für Google-Konten noch nicht erreicht haben

Kotlin

Java

Anzeigeninhalte filtern

Kotlin

Java

Publisher Privacy Treatment (Beta)

Kotlin

Java

Anzeigenanfrage

Netzwerk-Extras hinzufügen

Kotlin

Java

Benutzerdefinierte Ausrichtung

Kotlin

Java

Kategorieausschlüsse

Kotlin

Java

Vom Publisher bereitgestellte Kennungen

Kotlin

Java

Vom Publisher bereitgestellte Signale

Kotlin

Java

Inhalts-URL

Kotlin

Java

Markensicherheit (Beta)

Kotlin

Java

Ausrichtung