Diese Seite wurde von der Cloud Translation API übersetzt.

Ausrichtung

In diesem Leitfaden wird erläutert, wie Sie in einer Anzeigenanfrage Targeting-Informationen angeben. Für eine funktionierenden Beispiels funktioniert, laden Sie die Android API Demo App herunter.

API-Demo herunterladen

Vorbereitung

Arbeiten Sie den Startleitfaden durch.

RequestConfiguration

RequestConfiguration ist ein Objekt, das Targeting-Informationen erfasst, die global durch MobileAds statische Methode.

Um die Anfragekonfiguration zu aktualisieren, rufen Sie einen Builder aus der vorhandenen -Konfiguration, führen Sie die gewünschten Aktualisierungen durch und legen Sie sie wie folgt fest:

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Einstellung „Für Kinder“

Für die Zwecke des US-Gesetzes zum Schutz der Privatsphäre von Kindern im Internet (Children's Online Privacy Protection Act, COPPA) (COPPA) gibt es die Einstellung „Tag für Inhalte für Kinder“. Durch Festlegen dieses Tags bestätigen Sie, dass diese Benachrichtigung korrekt ist und Sie sind autorisiert, im Namen des Inhabers der App zu handeln. Ihnen ist bewusst, dass ein Missbrauch dieser Einstellung zur Kündigung führen kann Ihres Google-Kontos.

Als App-Entwickler können Sie angeben, ob Google Ihre Content als auf Kinder ausgerichtet kennzeichnen, wenn Sie eine Anzeigenanfrage stellen. Wenn Sie angeben, dass Sie möchten, dass Google Ihre Inhalte als auf Kinder ausgerichtet einstuft, unternehmen wir interessenbezogene Werbung und Remarketing-Anzeigen für diese Anzeigenanfrage deaktivieren.

Die Einstellung kann mit allen Versionen des Google Play Services SDK verwendet werden bis RequestConfiguration.Builder.setTagForChildDirectedTreatment(int):

setTagForChildDirectedTreatment anrufen mit TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE, um anzugeben, dass Ihre Inhalte, die im Sinne der COPPA-Bestimmungen als auf Kinder ausgerichtet behandelt werden. Dadurch wird verhindert, die Übertragung der Android-Werbe-ID (AAID) ermittelt.
setTagForChildDirectedTreatment anrufen mit TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE ein, um anzugeben, dass Ihre Inhalte, die im Sinne der COPPA-Bestimmungen als auf Kinder ausgerichtet behandelt werden.
setTagForChildDirectedTreatment anrufen mit TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED, wenn Sie nicht angeben möchten, wie Ihr Inhalt in Anzeigenanfragen in Bezug auf COPPA behandelt werden soll.

Im folgenden Beispiel sehen Sie, dass Ihre Inhalte als Inhalte, die auf Kinder ausgerichtet sind, im Sinne der COPPA-Bestimmungen:

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForChildDirectedTreatment(RequestConfiguration.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 in der Nutzer, die das Mindestalter für Google-Konten noch nicht erreicht haben, im Europäischen Wirtschaftsraum (EWR). Diese Funktion ist wurde entwickelt, um die Einhaltung der allgemeinen Datenschutz-Grundverordnung (DSGVO). Beachten Sie, dass Sie möglicherweise Verpflichtungen im Rahmen der DSGVO. Lesen Sie die Richtlinien der Europäischen Union und wenden Sie sich an sich an Ihren Rechtsbeistand wenden. Die Tools von Google sollen Ihnen Compliance und entbindet einen bestimmten Verlag nicht von seinen Verpflichtungen gemäß gegen das Gesetz. Weitere Informationen zu den Auswirkungen der DSGVO auf Publisher

Bei Verwendung dieser Funktion: Tag für minderjährige Nutzer in Europa (TFUA) in der Anzeigenanfrage enthalten. Durch diesen Parameter wird Folgendes deaktiviert: personalisierte Anzeigen, einschließlich Remarketing, für alle Anzeigenanfragen. Außerdem deaktiviert Anfragen an Drittanbieter von Anzeigen, z. B. Tracking-Pixel und Ad-Server eines Drittanbieters.

Wie bei Einstellungen für Kinder gibt es eine Methode, RequestConfiguration.Builder zum Festlegen des TFUA-Parameters: setTagForUnderAgeOfConsent() mit den folgenden Optionen.

setTagForUnderAgeOfConsent() mit TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE anrufen um anzugeben, dass die Anzeigenanfrage für Nutzer in Nutzer, die das Mindestalter für Google-Konten noch nicht erreicht haben, im Europäischen Wirtschaftsraum (EWR). Dies gilt auch für die Übertragung der Android-Werbe-ID (AAID) ermittelt.
setTagForUnderAgeOfConsent() mit TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE anrufen Um anzugeben, dass die Anzeigenanfrage nicht für Nutzer behandelt werden soll Nutzer, die das gültige Mindestalter noch nicht erreicht haben, im Europäischen Wirtschaftsraum (EWR).
setTagForUnderAgeOfConsent() anrufen mit TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED, wenn Sie noch keine angegeben ist, ob die Anzeigenanfrage für Nutzer in der Nutzer, die das Mindestalter für Google-Konten noch nicht erreicht haben, im Europäischen Wirtschaftsraum (EWR).

Im folgenden Beispiel wird angegeben, dass TFUA in Ihren Anzeigenanfragen enthalten sein soll:

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Die Tags, mit denen die Einstellung „Auf Kinder ausgerichtet“ aktiviert werden kann und setTagForUnderAgeOfConsent() sollten nicht gleichzeitig auf true festgelegt sein. Andernfalls hat die Einstellung für Kinder Vorrang.

Filtern von Anzeigeninhalten

Um die Google Play-Richtlinie zu unangemessener Werbung einzuhalten die zugehörige Angebote in einer Anzeige, alle Anzeigen und ihre zugehörigen Angebote, die in Ihrer App präsentiert werden, müssen für den Inhalt der App geeignet sein Bewertung von auch wenn der Inhalt an sich anderweitig den Google-Richtlinien entspricht Google Play-Richtlinien.

Mit Tools wie der höchsten Altersfreigabe für Anzeigeninhalte lässt sich besser steuern, welche Anzeigen Inhalt der Anzeigen, die Ihren Nutzern angezeigt werden. Du kannst eine maximale Altersfreigabe festlegen auf um die Einhaltung von Plattformrichtlinien zu verbessern.

In Apps kann für Anzeigenanfragen eine höchste Altersfreigabe für Anzeigeninhalte festgelegt werden mithilfe der setMaxAdContentRating . AdMob-Anzeigen, die zurückgegeben werden, wenn dies konfiguriert ist, haben eine Altersfreigabe von darunter liegen. Die möglichen Werte für diese Netzwerkzuschüsse basieren auf Klassifizierungen für Labels für digitalen Content und muss eines der folgenden sein: Zeichenfolgen:

MAX_AD_CONTENT_RATING_G
MAX_AD_CONTENT_RATING_PG
MAX_AD_CONTENT_RATING_T
MAX_AD_CONTENT_RATING_MA

Mit dem folgenden Code wird ein RequestConfiguration-Objekt konfiguriert, das angibt, dass Die zurückgegebenen Anzeigeninhalte müssen der Kennzeichnung des Labels für digitalen Content entsprechen. höher als G:

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Hier findest du weitere Informationen:

zu überschreiben.

Datenschutz für Publisher (Beta)

Die Datenschutzbestimmungen für Publisher (PPT) API ist ein optionales Tool, mit dem Apps angeben können, ob Anzeigen deaktiviert werden sollen Personalisierung für alle Anzeigenanfragen mithilfe der setPublisherPrivacyPersonalizationState()-Methode. Wenn Sie diese Funktion verwenden, wird ein PPT-Parameter (Publisher Privacy Treatment, PPT) verwendet, für die restliche Sitzung in allen zukünftigen Anzeigenanfragen enthalten sein.

Bei Anzeigenanfragen an Google werden standardmäßig personalisierte Anzeigen ausgeliefert. Die folgenden deaktiviert personalisierte Anzeigen bei allen Anzeigenanfragen:

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Anzeigenanfrage

Vom AdManagerAdRequest-Objekt werden Targeting-Einstellungen erfasst die mit einer Anzeigenanfrage gesendet werden.

Benutzerdefinierte Ausrichtung

Sie können für das Targeting von Google Ad Manager-Kampagnen benutzerdefinierte Schlüssel/Wert-Paare übergeben (Zeile Artikel) bis AdManagerAdRequest.Builder.addCustomTargeting():

Java

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

Kotlin

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

Sie können mehrere Werte für einen Schlüssel als Liste von Strings übergeben. Zum Beispiel Ausrichtung auf Personen Mitte 20 und nicht nur auf 25-Jährige.

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

Sehen Sie sich das Beispiel für benutzerdefiniertes Targeting in Ad Manager an. zur Implementierung der benutzerdefinierten Ausrichtung in der Android API Demo App.

Kategorieausschlüsse

Sie können einer Anfrage eine Kategorie-Ausschlussebene auf Anzeigenflächenebene hinzufügen. Verwenden Sie dazu die Methode addCategoryExclusion() von AdManagerAdRequest.Builder bereitgestellt:

Java

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

Kotlin

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

Sehen Sie sich das Beispiel zu Ad Manager-Kategorieausschlüssen an. zur Implementierung von Kategorieausschlüssen in der Android API Demo App.

Publisher Provided Identifiers

Sie können eine PPID (Publisher Provided Identifier, vom Publisher bereitgestellte Kennung) für das Frequency Capping einrichten, Zielgruppensegmentierung und -ausrichtung, sequenzielle Anzeigenrotation und andere Einstellungen für die zielgruppenbasierte Anzeigenauslieferung auf verschiedenen Geräten.

Hier ein Beispiel für das Festlegen der PPID:

Java

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

Kotlin

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

Sehen Sie sich das Beispiel für eine PPID in Ad Manager an. für die Implementierung von PPIDs (Publisher Provided Identifiers) in der Android-App API Demo App

Vom Publisher bereitgestellte Signale

Sie können Zielgruppen- und Kontextdaten als vom Publisher bereitgestellte Signale (PPS) in Anzeigenanfragen. Mit vom Publisher bereitgestellten Signalen können Sie Ihre Nutzerdaten nutzen, um programmatische Monetarisierung ein, indem Sie Ihre Zielgruppenmerkmale Bieter in allen Transaktionstypen mit Standardtaxonomien verwenden, ohne dass Nutzerkennungen weitergegeben werden müssen. Ihre Zielgruppe Eigenschaften können verhaltens- und interessenbezogene Daten umfassen (IAB Audience Taxonomie 1.1) und kontextbezogen (IAB-Taxonomie für Inhalte 2.2)

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

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

Inhalts-URL

Um eine Content-URL für contentbezogene Anzeigen und Markensicherheit anzugeben, können Sie setContentUrl() bei der Erstellung von AdManagerAdRequest:

Java

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

Kotlin

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

Markensicherheit (Beta)

Anwendungen, die dynamische Inhalte für unterschiedliche Zielgruppen anzeigen, sind eine kurze Liste mit URLs mithilfe des setNeighboringContentUrls() beim Erstellen eines AdManagerAdRequest verwenden:

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

Kotlin

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

.setNeighboringContentUrls() unterscheidet sich von .setContentUrl() insofern, für die Markensicherheit.