Ausrichtung

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.

API-Demo herunterladen

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

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

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() 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. Außerdem wird dadurch die Übertragung der Android-Werbe-ID (Android Advertising Identifier, 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 erforderliche Mindestalter noch nicht erreicht haben.

• 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.

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

Hinweis: Filtereinstellungen für die Altersfreigabe, die über das Google Mobile Ads SDK angegeben werden, überschreiben alle Einstellungen, die über die Ad Manager Benutzeroberfläche konfiguriert wurden.

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

Hinweis: Bei Anzeigenanfragen mit mehreren Datenschutzsignalen für Nutzer hat das strengste Signal Vorrang. Konkrete Beispiele findest du in der Dokumentation der Publisher Privacy Treatment API und der Publisher Privacy Treatment API.

Anzeigenanfrage

Im AdManagerAdRequest-Objekt werden Targeting-Informationen erfasst, die mit einer Anzeigenanfrage gesendet werden.

Benutzerdefinierte Ausrichtung

Sie können benutzerdefinierte Schlüssel/Wert-Paare übergeben, um über AdManagerAdRequest.Builder.addCustomTargeting() auf Google Ad Manager-Kampagnen (Werbebuchen) zu targeten:

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 in ihren mittleren 20ern statt nur 25-Jährige ansprechen.

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

Im Beispiel für benutzerdefiniertes Targeting in Ad Manager finden Sie eine Implementierung des benutzerdefinierten Targetings in der Android API-Demo-App.

Kategorieausschlüsse

Sie können einer Anfrage einen Kategorieausschluss auf Anzeigenflächenebene hinzufügen. Verwenden Sie dazu die Methode addCategoryExclusion() von AdManagerAdRequest.Builder:

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

Im Beispiel für Ad Manager-Kategorieausschlüsse 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 (PPID) für die Verwendung beim Frequency Capping, bei der Zielgruppensegmentierung und beim Targeting auf Zielgruppen, bei der sequenziellen Anzeigenrotation und bei anderen Funktionen zur zielgruppenbasierten Anzeigenauslieferung auf beliebigen Geräten festlegen.

Hinweis :Diese Funktion ist nicht für alle Publisher verfügbar. Weitere Informationen finden Sie unter PPIDs (Publisher Provided Identifiers).

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

Im Beispiel für Ad Manager-PPIDs 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 (PPS) in Anzeigenanfragen senden. Mit PPS können Sie Ihre Nutzerdaten nutzen, um die programmatische Monetarisierung zu verbessern. Dazu geben Sie Ihre Zielgruppenmerkmale mithilfe standardisierter Taxonomien an Bieter für alle Transaktionstypen weiter, ohne Nutzer-IDs weitergeben zu müssen. Zu den 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 = AdRequest.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 Anzeigen mit Content-Targeting und Markensicherheit angeben möchten, können Sie beim Erstellen einer AdManagerAdRequest die Funktion setContentUrl() aufrufen:

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)

Hinweis :Die Multi-Content-URL befindet sich in der geschlossenen Betaphase und ist nur für eine ausgewählte Gruppe von Publishern verfügbar.

Bei Anwendungen, die dynamische Inhalte für unterschiedliche Zielgruppen anzeigen, kann beim Erstellen einer AdManagerAdRequest eine kurze Liste von URLs mit der Methode setNeighboringContentUrls() angegeben werden:

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.

Hinweis :In setNeighboringContentUrls werden nur die ersten vier URLs in der Liste verwendet. Die anderen werden ignoriert.