Kierowanie

Z tego przewodnika dowiesz się, jak podać informacje o kierowaniu w żądaniu reklamy. Dla działa przykład, pobierz aplikację w wersji demonstracyjnej interfejsu Android API.

Pobierz wersję demonstracyjną interfejsu API

Warunek wstępny

• Zapoznaj się z przewodnikiem dla początkujących.

RequestConfiguration

RequestConfiguration to obiekt zbierający informacje dotyczące kierowania, które mają być stosowane globalnie przez MobileAds metody statycznej.

Aby zaktualizować konfigurację żądania, uzyskaj kreator z istniejącej konfiguracji, wprowadź odpowiednie aktualizacje i ustaw konfigurację w następujący sposób:

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

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

Ustawienie skierowane do dzieci

Na potrzeby amerykańskiej ustawy o ochronie prywatności dzieci w internecie (Children's Online Privacy Protection Act) (COPPA), jest dostępne ustawienie „tag traktowania treści jako skierowanych do dzieci”. Ustawiając ten tag, potwierdzasz, że to powiadomienie jest prawdziwe a Ty masz uprawnienia do działania w imieniu jej właściciela. Rozumiesz, że naruszenie zasad tego ustawienia może spowodować zamknięcie konta. Twojego konta Google.

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

Tego ustawienia można używać ze wszystkimi wersjami pakietu SDK Usług Google Play do RequestConfiguration.Builder.setTagForChildDirectedTreatment(int):

• Zadzwoń do firmy setTagForChildDirectedTreatment, używając: TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE, aby wskazać, że chcesz, treści traktowane jako skierowane do dzieci zgodnie z ustawą COPPA. Zapobiega to przesłania identyfikatora wyświetlania reklam na urządzeniach z Androidem, (AAID).

• Zadzwoń do firmy setTagForChildDirectedTreatment, używając: TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE, aby wskazać, że nie chcesz, treści traktowane jako skierowane do dzieci zgodnie z ustawą COPPA.

• Zadzwoń do firmy setTagForChildDirectedTreatment, używając: TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED, jeśli nie chcesz wskazywać Twoje treści w żądaniach reklamy zgodnie z ustawą COPPA.

Poniższy przykład wskazuje, że Twoje treści mają być traktowane jako skierowane do dzieci zgodnie z ustawą COPPA:

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

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

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

Możesz oznaczyć żądania reklamy, aby były traktowane jako wobec użytkowników w Europejski Obszar Gospodarczy (EOG), jeśli użytkownik nie osiągnął wieku świadomego wyrażenia zgody. Ta funkcja jest mające na celu ułatwienie zachowania zgodności z ogólnymi Rozporządzenie o ochronie danych (RODO) Pamiętaj, że możesz mieć też inne, zgodne z prawem wynikających z RODO. Zapoznaj się ze wskazówkami Unii Europejskiej i skonsultuj się z z własnym radcą prawnym. Pamiętaj, że narzędzia Google mają na celu ułatwienie przestrzegania przepisów i nie zwalniają żadnego wydawcy z jego zobowiązań wynikających z i w kontekście prawa. Więcej informacji o tym, jak RODO wpływa na wydawców

Jeśli używasz tej funkcji, tag dla użytkowników, którzy nie osiągnęli wieku świadomego wyrażenia zgody w Europie (TFUA) jest uwzględniony w żądaniu reklamy. Ten parametr wyłącza spersonalizowanych reklam, w tym remarketingu, w przypadku wszystkich żądań reklamy. Dodatkowo uniemożliwia wysyłanie żądań do zewnętrznych dostawców reklam – dotyczy to np. pikseli śledzących reklamy lub z serwerów reklamowych firm zewnętrznych.

Podobnie jak w przypadku ustawień dotyczących treści skierowanych do dzieci, można użyć metody RequestConfiguration.Builder na potrzeby ustawienia parametru TFUA: setTagForUnderAgeOfConsent() z poniższymi opcjami.

• Zadzwoń do firmy setTagForUnderAgeOfConsent(), używając numeru TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE aby wskazać, że chcesz, aby żądanie reklamy było traktowane jako w przypadku użytkowników w: użytkowników z Europejskiego Obszaru Gospodarczego, którzy nie osiągnęli wieku świadomego wyrażenia zgody. To także uniemożliwia przesyłanie identyfikatora wyświetlania reklam na urządzeniach z Androidem (AAID).

• Zadzwoń do firmy setTagForUnderAgeOfConsent(), używając numeru TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE wskazuje, że nie chcesz, aby żądanie reklamy nie było traktowane w przypadku użytkowników. na terenie Europejskiego Obszaru Gospodarczego (EOG), że nie osiągnęli wieku świadomego wyrażenia zgody.

• Zadzwoń do firmy setTagForUnderAgeOfConsent(), używając: TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED w celu potwierdzenia, że nie określać, czy żądanie reklamy powinno być traktowane jako w przypadku użytkowników w ciągu Europejski Obszar Gospodarczy (EOG), jeśli użytkownik nie osiągnął wieku świadomego wyrażenia zgody.

Poniższy przykład wskazuje, że w żądaniach reklamy chcesz uwzględnić TFUA:

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

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

Tagi, które włączają ustawienie Skierowane do dzieci i setTagForUnderAgeOfConsent() nie powinny być jednocześnie ustawione na true. Jeśli tak, ustawienie dotyczące treści skierowanych do dzieci ma pierwszeństwo.

Filtrowanie treści reklamy

Aby zachować zgodność z zasadami Google Play dotyczącymi nieodpowiednich reklam obejmujący oferty w reklamie, wszystkie reklamy i powiązane z nimi reklamy oferty wyświetlane w aplikacji muszą być odpowiednie do treści ocena na z aplikacji, nawet jeśli jej treść jest zgodna z zasadami Google. Zasady Google Play.

Narzędzia takie jak maksymalna ocena treści reklam pozwalają lepiej kontrolować: treści reklam wyświetlanych użytkownikom. Możesz ustawić maksymalną ocenę treści na aby pomóc w zachowaniu zgodności z zasadami platformy.

Aplikacje mogą ustawić maksymalną ocenę treści reklam w żądaniach reklamy za pomocą setMaxAdContentRating . Reklamy AdMob zwracane, jeśli są skonfigurowane, mają ocenę treści wynoszącą lub poniżej tego poziomu. Możliwe wartości tej dodatkowej sieci są oparte na: klasyfikacji etykiet treści cyfrowych. Musi być jedną z poniższych ciągi znaków:

• MAX_AD_CONTENT_RATING_G
• MAX_AD_CONTENT_RATING_PG
• MAX_AD_CONTENT_RATING_T
• MAX_AD_CONTENT_RATING_MA

Ten kod konfiguruje obiekt RequestConfiguration tak, zwracana treść reklamy powinna odpowiadać oznaczeniem etykiety treści cyfrowych „nie” więcej niż G:

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

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

Więcej informacji:

• Ustawianie maksymalnej oceny treści dla każdej reklamy prośba

• ustawiać maksymalną ocenę treści reklam w aplikacji lub

Zasady traktowania wydawców (beta)

Traktowanie wydawców z uwzględnieniem prywatności Interfejs API (PPT) to opcjonalne narzędzie, które pozwala aplikacjom włączać i wyłączać reklamy do personalizacji wszystkich żądań reklamy używających Metoda setPublisherPrivacyPersonalizationState(). Gdy używasz tej funkcji, parametr PTT uwzględniany we wszystkich przyszłych żądaniach reklamy do końca sesji.

Domyślnie żądania reklam wysyłane do Google zawierają reklamy spersonalizowane. Poniżej kod wyłącza personalizację reklam w przypadku wszystkich żądań reklamy:

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

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

Żądanie reklamy

Obiekt AdManagerAdRequest zbiera dane o kierowaniu informacje wysyłane wraz z żądaniem reklamy.

Kierowanie niestandardowe

Możesz przekazywać niestandardowe pary klucz-wartość, by kierować kampanie Google Ad Manager (wiersz elementy) do AdManagerAdRequest.Builder.addCustomTargeting():

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

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

Dla jednego klucza możesz przekazać wiele wartości w postaci listy ciągów. Aby na przykład: są kierowane do osób w wieku dwudziestu lat, a nie tylko w wieku 25 lat.

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

Zobacz przykład kierowania niestandardowego w usłudze Ad Manager .

Wykluczenia kategorii

Aby dodać do żądania poziom wykluczenia kategorii na poziomie boksu, użyj addCategoryExclusion() metoda udostępniona przez AdManagerAdRequest.Builder:

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

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

Zobacz przykład wykluczeń kategorii Ad Managera .

Identyfikatory podawane przez wydawcę

Możesz ustawić identyfikator podawany przez wydawcę (PPID) na potrzeby ograniczenia liczby wyświetleń. segmentacja odbiorców i kierowanie, sekwencyjna rotacja reklam itp. funkcje kontroli wyświetlania reklam na różnych urządzeniach z uwzględnieniem odbiorców.

Przykład ustawiania identyfikatora PPID:

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

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

Zobacz przykład identyfikatora PPID w usłudze Ad Manager. gdzie znajdziesz informacje o implementacji identyfikatorów podawanych przez wydawcę (PPID) na urządzeniach z Androidem. Aplikacja w wersji demonstracyjnej interfejsu API.

Sygnały dostarczane przez wydawcę

Możesz wysyłać dane o odbiorcach i dane kontekstowe jako sygnały dostarczane przez wydawcę (PPS) w żądaniach reklamy. Dzięki PSPS możesz używać danych użytkowników do ulepszania w zautomatyzowany sposób zarabiania, przekazując cechy odbiorców licytujący we wszystkich typów transakcji za pomocą funkcji standardowych taksonomii, bez konieczności udostępniania identyfikatorów użytkowników. Twoi odbiorcy mogą obejmować dane związane z zachowaniami i zainteresowaniach (Odbiorcy IAB taksonomia 1.1) i kontekstowe (taksonomia treści IAB 2.2).

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

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

URL treści

Aby podać adres URL treści dla reklam kierowanych na treść i zapewnić bezpieczeństwo marki, możesz zadzwonić setContentUrl() podczas tworzenia AdManagerAdRequest:

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

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

Bezpieczeństwo marki (beta)

Aplikacje, które wyświetlają treści dynamiczne przeznaczone dla różnych odbiorców, możesz podać krótką listę adresów URL za pomocą setNeighboringContentUrls() podczas tworzenia AdManagerAdRequest:

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

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() różni się od .setContentUrl() tym, że jest tylko dla bezpieczeństwa marki.