Kierowanie

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

Pobierz wersję demonstracyjną interfejsu API

Warunek wstępny

Zanim przejdziesz dalej, skonfiguruj Google Mobile Ads SDK (Legacy).

RequestConfiguration

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

Aby zaktualizować konfigurację żądania, uzyskaj narzędzie do tworzenia z dotychczasowej konfiguracji, wprowadź wybrane zmiany i ustaw je w ten sposób:

val requestConfiguration = MobileAds.getRequestConfiguration()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

Aby mieć pewność, że wszystkie żądania reklamy uwzględniają zmiany w konfiguracji żądania, ustaw konfigurację żądania przed zainicjowaniemGoogle Mobile Ads SDK (Legacy).

Ustawianie ograniczeń wiekowych

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

Możesz ustawić traktowanie ze względu na wiek za pomocą metody setAgeRestrictedTreatment() w interfejsie RequestConfiguration.Builder API.

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

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    // Indicate that ad requests should have child age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        // 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 nieokreślonych, zastąp ustawienie CHILD jednym z tych ustawień:

• TEEN
• UNSPECIFIED

Gdy używasz tego ustawienia, Google Mobile Ads SDK (Legacy) 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 z aplikacji pod kątem przetwarzania z ograniczeniami wiekowymi.

Migracja z tagów TFCD i TFUA na traktowanie z uwzględnieniem wieku

Ustawienie dotyczące traktowania z uwzględnieniem wieku 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:

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

Jeśli wybierzesz ustawienie dotyczące ograniczeń wiekowych oraz ustawienia TFCD lub TFUA, Google zastosuje najbardziej zachowawcze ograniczenie.

Przekazywanie informacji o traktowaniu treści z uwzględnieniem wieku w zapośredniczeniu AdMob

Jeśli skonfigurujesz traktowanie z uwzględnieniem wieku za pomocą Google Mobile Ads SDK (Legacy), adaptery zapośredniczenia przekazują sygnał traktowania z uwzględnieniem wieku do zapośredniczonych pakietów SDK innych firm.

W tabeli poniżej znajdziesz listę wersji adapterów zapośredniczenia, które obsługują przekazywanie sygnału o ograniczeniach wiekowych do zapośredniczonego pakietu SDK zewnętrznego źródła reklam:

Ustawienie dotyczące treści skierowanych do dzieci

Na potrzeby ustawy o ochronie prywatności dzieci w internecie (COPPA) istnieje ustawienie o nazwie „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 dotyczące treści skierowanych 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 Androida (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 w żądaniach reklamy nie chcesz wskazywać, jak mają być traktowane Twoje treści w odniesieniu do ustawy COPPA.

W przykładzie poniżej wskazano, że treści mają być traktowane jako skierowane do dzieci w świetle ustawy COPPA:

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

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

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

Możesz oznaczyć swoje żądania reklamy, aby zostały objęte ograniczonym przetwarzaniem danych w przypadku 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). RODO może nakładać na Ciebie także inne obowiązki prawne. Zapoznaj się z wytycznymi Unii Europejskiej i skonsultuj się ze swoim prawnikiem. 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 wydawców

Gdy używasz tej funkcji, w żądaniu reklamy znajdzie się parametr Tagowanie treści dla osób, które nie osiągnęły wieku świadomego wyrażenia zgody w Europie (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 skierowanych do dzieci, istnieje metoda ustawiania parametru TFUA w RequestConfiguration.Builder: 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 skierowane do użytkowników z Europejskiego Obszaru Gospodarczego (EOG), którzy nie osiągnęli wieku świadomego wyrażenia 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 skierowane do 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:

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

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

Tagi umożliwiające włączenie ustawienia dotyczącego treści skierowanych do dzieci i setTagForUnderAgeOfConsent() nie powinny mieć jednocześnie wartości true. Jeśli tak jest, ustawienie dotyczące skierowania 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 oferty w reklamie, wszystkie reklamy i powiązane z nimi oferty wyświetlane w Twojej aplikacji muszą być odpowiednie do oceny treści aplikacji, 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 w przypadku żą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:

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

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

Więcej informacji:

• Określanie maksymalnej oceny treści dla każdego żądania reklamy

• Ustawianie maksymalnej oceny treści reklam w aplikacji lub na koncie

Publisher Privacy Treatment (beta)

Interfejs Publisher Privacy Treatment (PPT) API 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 znajduje się 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:

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setPublisherPrivacyPersonalizationState(
      RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED
    )
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

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

Żądanie reklamy

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

Dodawanie dodatkowych informacji o sieci

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

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

val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest =
  AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()
adView.loadAd(adRequest)
AdRequestSnippets.kt

Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
AdRequest adRequest =
    new AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();
adView.loadAd(adRequest);
AdRequestSnippets.java