Kierowanie

Z tego przewodnika dowiesz się, jak przekazywać informacje o kierowaniu do pakietu SDK do reklam mobilnych Google.

Warunek wstępny

Zanim przejdziesz dalej, skonfiguruj GMA Next-Gen SDK.

RequestConfiguration

RequestConfiguration zbiera informacje o kierowaniu stosowane globalnie do każdego żądania reklamy. Dostępne tagi kierowania znajdziesz w RequestConfiguration.Builder dokumentacji.

Utwórz obiekt RequestConfiguration z potrzebnymi tagami kierowania za pomocą jego konstruktora, a następnie skonfiguruj go, wywołując MobileAds.setRequestConfiguration().

Ważne: wywołanie MobileAds.setRequestConfiguration() zastępuje każdą istniejącą konfigurację.

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

Aby zastosować tagi kierowania z pierwszego żądania reklamy, podaj konfigurację żądania podczas inicjowania pakietu SDK:

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

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

Ustawianie ograniczeń wiekowych

Aby pomóc Ci zachować zgodność z obowiązującymi przepisami dotyczącymi prywatności dzieci i nastolatków, GMA Next-Gen SDK udostępnia ustawienie dotyczące traktowania ze względu na wiek. Ustawienie dotyczące traktowania ze względu na wiek pozwala określić, czy GMA Next-Gen SDK ma stosować specjalne zabezpieczenia dotyczące wyświetlania reklam dzieciom, nastolatkom lub użytkownikom w nieokreślonym wieku.

Możesz ustawić traktowanie z uwzględnieniem wieku za pomocą metody setAgeRestrictedTreatment() w interfejsie API RequestConfiguration.Builder.

Poniższy przykład wskazuje, że żądania reklamy powinny być traktowane jako treści skierowane do dzieci:

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

Aby wskazać traktowanie treści jako skierowanych do nastolatków lub osób w nieokreślonym wieku, zastąp ustawienie CHILD tymi wartościami:

• TEEN
• UNSPECIFIED

Gdy używasz tego ustawienia, GMA Next-Gen SDK uwzględnia w żądaniach reklamy parametr tfat. Skonsultuj się z prawnikiem, aby określić odpowiednie ustawienia dotyczące traktowania użytkowników z uwzględnieniem wieku zgodnie z obowiązującymi Cię wymogami prawnymi i regulacyjnymi. Więcej informacji znajdziesz w artykule Tagowanie żądania reklamy jako wymagającego traktowania z uwzględnieniem wieku.

Migracja z tagów TFCD i TFUA na tagowanie treści pod kątem wieku odbiorców

Ustawienie dotyczące traktowania ze względu na wiek zastępuje wycofane ustawienia .setTagForChildDirectedTreatment() (TFCD) i .setTagForUnderAgeOfConsent()(TFUA).

W tabeli poniżej znajdziesz ustawienia TFCD i TFUA oraz ich odpowiedniki w zakresie traktowania treści z uwzględnieniem wieku:

TFCD

TFCD	Ograniczenia wiekowe
TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE	AgeRestrictedTreatment.CHILD
TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE	AgeRestrictedTreatment.UNSPECIFIED
TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED	AgeRestrictedTreatment.UNSPECIFIED
Brak przypisanej wartości .setTagForChildDirectedTreatment()	AgeRestrictedTreatment.UNSPECIFIED
Brak odpowiednika	AgeRestrictedTreatment.TEEN

TFUA

TFUA	Ograniczenia wiekowe
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
Brak przypisanej wartości .setTagForUnderAgeOfConsent()	AgeRestrictedTreatment.UNSPECIFIED
Brak odpowiednika	AgeRestrictedTreatment.TEEN

Interakcje traktowania treści ze względu na wiek z tagami TFCD i TFUA

Jeśli skonfigurujesz ustawienie dotyczące traktowania z uwzględnieniem wieku oraz ustawienia TFCD lub TFUA, Google zastosuje najbardziej zachowawcze traktowanie.

Uwaga: w przypadku aplikacji w programie Dla całej rodziny, które są skierowane do dzieci, oraz użytkowników zalogowanych na konta Google zarządzane przez Family Link wszystkie treści są automatycznie traktowane jako skierowane do dzieci w przypadku wszystkich żądań reklamy.

Ustawienie dotyczące treści skierowanych do dzieci

Ostrzeżenie: metoda setTagForChildDirectedTreatment() nie jest już używana. Zamiast tego ustaw metodę setAgeRestrictedTreatment()

.

Na potrzeby ustawy o ochronie prywatności dzieci w internecie (COPPA) istnieje ustawienie „Oznacz jako skierowane do dzieci”. Ustawiając ten tag, potwierdzasz, że to powiadomienie jest poprawne i że posiadasz uprawnienia do działania w imieniu właściciela aplikacji. Rozumiesz, że nadużywanie tego ustawienia może być przyczyną zamknięcia Twojego konta Google.

Deweloper aplikacji może wskazać w żądaniu reklamy, czy Google ma traktować treści w tej aplikacji jako skierowane do dzieci. Jeśli wskażesz, że chcesz, aby Twoje treści były traktowane jako skierowane do dzieci, wyłączymy w tym żądaniu reklamy oparte na zainteresowaniach i reklamy remarketingowe.

Ustawienie „skierowane do dzieci” możesz zastosować w ten sposób:setTagForChildDirectedTreatment()

• Wywołaj funkcję setTagForChildDirectedTreatment z parametrem TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE, aby wskazać, że Twoje treści mają być traktowane jako skierowane do dzieci na potrzeby ustawy COPPA. Zapobiega to przesyłaniu identyfikatora wyświetlania reklam na urządzeniach z Androidem (AAID).

• Wywołaj funkcję setTagForChildDirectedTreatment z parametrem TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE, aby wskazać, że nie chcesz, aby Twoje treści były traktowane jako skierowane do dzieci na potrzeby ustawy COPPA.

• Wywołaj funkcję setTagForChildDirectedTreatment z parametrem TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED, jeśli nie chcesz wskazywać, w jaki sposób Twoje treści mają być traktowane w żądaniach reklam zgodnie z ustawą COPPA.

Poniższy przykład wskazuje, że chcesz, aby Twoje treści były traktowane jako skierowane do dzieci na potrzeby ustawy COPPA:

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

Uwaga: w przypadku aplikacji w programie Dla całej rodziny, które są skierowane do dzieci, oraz użytkowników zalogowanych na konta Google zarządzane przez Family Link wszystkie treści są automatycznie traktowane jako skierowane do dzieci w przypadku wszystkich żądań reklamy.

Użytkownicy, którzy nie osiągnęli wieku świadomego wyrażenia zgody

Ostrzeżenie: metoda setTagForUnderAgeOfConsent() nie jest już używana. Zamiast tego ustaw metodę setAgeRestrictedTreatment()

.

Możesz oznaczyć swoje żądania reklamy, by były traktowane jako dotyczące użytkowników z Europejskiego Obszaru Gospodarczego (EOG), którzy nie osiągnęli wieku świadomego wyrażenia zgody. Ta funkcja ma na celu ułatwienie zachowania zgodności z Ogólnym rozporządzeniem o ochronie danych (RODO). Pamiętaj, że zgodnie z RODO możesz mieć także inne zobowiązania. Zapoznaj się ze wskazówkami Unii Europejskiej i skonsultuj się ze swoim radcą prawnym. Pamiętaj, że narzędzia Google pomagają w przestrzeganiu przepisów, ale nie zwalniają żadnego wydawcy z jego zobowiązań wobec prawa. Więcej informacji o tym, jak RODO wpływa na działalność wydawców

Jeśli użyjesz tej funkcji, do żądania reklamy dodamy parametr Tag For Users under the Age of Consent in Europe (TFUA). Wyłącza on reklamy spersonalizowane, w tym remarketingowe, w przypadku wszystkich żądań reklamy. Uniemożliwia też przesyłanie żądań do zewnętrznych dostawców reklam – dotyczy to np. pikseli pomiaru skuteczności reklam lub serwerów reklamowych firm zewnętrznych.

Podobnie jak w przypadku ustawień dotyczących treści dla dzieci istnieje metoda RequestConfiguration.Builder ustawiania parametru TFUA: setTagForUnderAgeOfConsent(), z tymi opcjami:

• Wywołaj funkcję setTagForUnderAgeOfConsent() z parametrem TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE, aby wskazać, że żądanie reklamy ma być traktowane jako skierowane do użytkowników z Europejskiego Obszaru Gospodarczego (EOG), którzy nie osiągnęli wieku świadomego wyrażenia zgody. Zapobiega to również przesyłaniu identyfikatora wyświetlania reklam na urządzeniach z Androidem (AAID).

• Wywołaj funkcję setTagForUnderAgeOfConsent() z parametrem TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE, aby wskazać, że żądanie reklamy nie ma być traktowane jako dotyczące użytkowników z Europejskiego Obszaru Gospodarczego (EOG), którzy nie osiągnęli wieku świadomego wyrażania zgody.

• Wywołaj funkcję setTagForUnderAgeOfConsent() z parametrem TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED, aby wskazać, że nie określono, czy żądanie reklamy powinno być traktowane jako dotyczące użytkowników z Europejskiego Obszaru Gospodarczego (EOG), którzy nie osiągnęli wieku świadomego wyrażenia zgody.

Poniższy przykład pokazuje, że chcesz, aby parametr TFUA był uwzględniany w żądaniach reklamy:

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

Tagi umożliwiające włączenie ustawienia „Skierowane do dzieci” i setTagForUnderAgeOfConsent() nie powinny mieć jednocześnie wartości true. Jeśli tak jest, ustawienie dotyczące aplikacji skierowanych do dzieci ma pierwszeństwo.

Filtrowanie treści reklam

Aby zachować zgodność z zasadami Google Play dotyczącymi nieodpowiednich reklam, które obejmują powiązane z reklamą oferty, wszystkie reklamy i powiązane z nimi oferty wyświetlane w Twojej aplikacji muszą być odpowiednie do jej oceny treści, nawet jeśli sama treść jest pod innymi względami zgodna z zasadami Google Play.

Narzędzia takie jak maksymalna ocena treści reklam pozwalają lepiej kontrolować zawartość reklam wyświetlanych użytkownikom. Aby zachować zgodność z zasadami platformy, możesz ustawić maksymalną ocenę treści.

Aplikacje mogą ustawiać maksymalną ocenę treści reklam dla swoich żądań reklam za pomocą metody setMaxAdContentRating. Reklamy AdMob zwracane po skonfigurowaniu tej opcji mają ocenę treści na tym poziomie lub niższą. Możliwe wartości tego dodatku do sieci zależą od klasyfikacji etykiet treści cyfrowych i muszą być jednym z tych ciągów znaków:

• MAX_AD_CONTENT_RATING_G
• MAX_AD_CONTENT_RATING_PG
• MAX_AD_CONTENT_RATING_T
• MAX_AD_CONTENT_RATING_MA

Poniższy kod konfiguruje obiekt RequestConfiguration, aby określić, że zwracane treści reklamowe powinny odpowiadać oznaczeniu etykiety treści cyfrowych nie wyższemu niż G:

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

Dowiedz się więcej o określaniu maksymalnej oceny treści dla każdego żądania reklamy.

Uwaga: ustawienia filtra oceny treści określone za pomocą GMA Next-Gen SDKzastępują wszystkie ustawienia skonfigurowane w interfejsie Ad Managera.

Publisher Privacy Treatment API (beta)

Interfejs Publisher Privacy Treatment (PPT) to opcjonalne narzędzie, które umożliwia aplikacjom wskazywanie, czy wyłączyć personalizację reklam w przypadku wszystkich żądań reklam za pomocą metody setPublisherPrivacyPersonalizationState(). Gdy używasz tej funkcji, w żądaniach reklam wysyłanych w dalszej części sesji uwzględniany jest parametr Publisher Privacy Treatment (PPT).

Domyślnie żądania reklam wysyłane do Google powodują wyświetlanie reklam spersonalizowanych. Poniższy kod wyłącza personalizację reklam w przypadku wszystkich żądań reklamy:

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

Uwaga: w przypadku żądań reklamy z wieloma sygnałami dotyczącymi prywatności użytkownika pierwszeństwo ma sygnał o najbardziej restrykcyjnych ustawieniach. Konkretne przykłady znajdziesz w dokumentacji interfejsu Publisher Privacy Treatment API.

Żądanie reklamy

Obiekt AdRequest zbiera informacje o kierowaniu, które mają być wysyłane z żądaniem reklamy.

Dodawanie dodatkowych informacji o sieci

Dodatkowe informacje o sieci to dodatkowe szczegóły wysyłane z żądaniem reklamy, które są specyficzne dla jednego źródła reklam.

Ten fragment kodu ustawia w Google dodatkowy klucz parametru collapsible o wartości bottom:

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

Kierowanie niestandardowe

Możesz przekazywać niestandardowe pary klucz-wartość, aby kierować kampanie (elementy zamówienia) Google Ad Managera. W tym przykładzie w żądaniu reklamy przekazywana jest niestandardowa para klucz-wartość:

Kotlin

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

Java

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

Możesz przekazać wiele wartości klucza jako listę ciągów znaków. Na przykład możesz kierować reklamy na osoby w wieku około 25 lat, a nie tylko na 25-latków.

Kotlin

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

Java

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

Wykluczenia kategorii

Aby dodać do żądania poziom wykluczenia kategorii na poziomie slotu, użyj metody addCategoryExclusion():

Kotlin

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

Java

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

Przykład implementacji wykluczeń kategorii w aplikacji w wersji demonstracyjnej interfejsu API na Androida znajdziesz w tym artykule.

Identyfikatory podawane przez wydawcę

Możesz ustawić identyfikator podawany przez wydawcę (PPID) do wykorzystania na potrzeby ograniczenia liczby wyświetleń, segmentacji odbiorców, kierowania, sekwencyjnej rotacji reklam i innych funkcji sterujących wyświetlaniem reklam w zależności od odbiorców na różnych urządzeniach.

Uwaga: ta funkcja nie jest dostępna dla wszystkich wydawców. Więcej informacji znajdziesz w artykule Informacje o identyfikatorach podawanych przez wydawców.

Oto przykład ustawiania identyfikatora PPID:

Kotlin

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

Java

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

Zapoznaj się z przykładem identyfikatorów PPID w Ad Managerze, aby zobaczyć implementację identyfikatorów podawanych przez wydawcę (PPID) w aplikacji w wersji demonstracyjnej interfejsu API na Androida.

Sygnały dostarczane przez wydawcę

Dane o odbiorcach i dane kontekstowe możesz wysyłać w żądaniach reklamy jako sygnały dostarczane przez wydawcę. Dzięki sygnałom dostarczanym przez wydawcę możesz używać danych użytkownika do poprawy zarabiania w ramach automatyzacji, przekazując charakterystykę odbiorców licytującym we wszystkich rodzajach transakcji za pomocą standardowych taksonomii bez konieczności udostępniania identyfikatorów użytkowników. Charakterystyka odbiorców może obejmować dane związane z zachowaniem i zainteresowaniami (taksonomia odbiorców IAB w wersji 1.1) oraz dane kontekstowe (taksonomia treści IAB w wersji 2.2).

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("AD_UNIT_ID")
  .setGoogleExtrasBundle(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));

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

URL treści

Aby podać adres URL treści na potrzeby reklam kierowanych na treść i bezpieczeństwa marki, dodaj te informacje:

Kotlin

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

Java

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

Bezpieczeństwo marki (beta)

Uwaga: funkcja Wiele adresów URL zawartości jest dostępna w zamkniętej wersji beta dla ograniczonej grupy wydawców.

Aplikacje wyświetlające dynamiczne treści przeznaczone dla różnych odbiorców mogą podać krótką listę adresów URL:

Kotlin

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

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");
AdRequest requestWithContent = new AdRequest.Builder("AD_UNIT_ID")
    .setNeighboringContentUrls(urls)
    .build();

.setNeighboringContentUrls() różni się od .setContentUrl() tym, że jest używane tylko do bezpieczeństwa marki.

Uwaga: setNeighboringContentUrls używa tylko pierwszych 4 adresów URL na liście. Pozostałe są ignorowane.