Kierowanie

Wybierz platformę: Android iOS Unity Flutter Android (starsza wersja)

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

Aby zobaczyć działający przykład, pobierz aplikację Android API Demo.

Pobierz API Demo

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, pobierz narzędzie do tworzenia z istniejącej konfiguracji, wprowadź wybrane zmiany i ustaw je w ten sposób:

Kotlin

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

Java

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

Aby mieć pewność, że wszystkie żądania reklamy będą stosować zmiany konfiguracji żądania, ustaw konfigurację żądania, zanim zainicjujesz Google Mobile Ads SDK (Legacy).

Ustawianie traktowania treści z uwzględnieniem wieku

Aby ułatwić Ci przestrzeganie obowiązujących przepisów dotyczących prywatności dzieci i nastolatków, Google Mobile Ads SDK (Legacy) udostępnia ustawienie traktowania treści z uwzględnieniem wieku. Ustawienie traktowania treści z uwzględnieniem wieku pozwala określić, czy Google Mobile Ads SDK (Legacy) ma stosować określone zabezpieczenia wyświetlania reklam w przypadku dzieci, nastolatków lub użytkowników w nieokreślonym wieku.

Traktowanie treści z uwzględnieniem wieku możesz ustawić 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:

Kotlin

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

Java

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 użytkowników w nieokreślonym wieku, zastąp ustawienie CHILD jednym z tych ustawień:

• TEEN
• UNSPECIFIED

Gdy używasz tego ustawienia, Google Mobile Ads SDK (Legacy) dodaje do żądań reklamy parametr tfat. Skonsultuj się z prawnikiem, aby określić 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 TFCD i TFUA do traktowania treści z uwzględnieniem wieku

Ustawienie traktowania treści 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 ustawieniach traktowania treści z uwzględnieniem wieku:

TFCD

TFCD	Traktowanie treści z uwzględnieniem wieku
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	Traktowanie treści z uwzględnieniem wieku
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

Informacje o interakcjach traktowania treści z uwzględnieniem wieku z TFCD i TFUA

Jeśli ustawisz ustawienie dotyczące traktowania ze względu na wiek oraz ustawienia TFCD lub TFUA, Google zastosuje najbardziej zachowawcze traktowanie.

Uwaga: w przypadku aplikacji w programie Dla całej rodziny które są przeznaczone głównie dla dzieci oraz użytkowników zalogowanych na kontach Google zarządzanych za pomocą Family Link wszystkie treści są automatycznie traktowane jako skierowane do dzieci we wszystkich żądaniach reklamy.

Przekazywanie traktowania treści z uwzględnieniem wieku za pomocą zapośredniczenia AdMob

Jeśli ustawisz traktowanie treści z uwzględnieniem wieku za pomocą Google Mobile Ads SDK (Legacy), adaptery zapośredniczenia przekazują sygnał traktowania treści z uwzględnieniem wieku do pakietów SDK firm zewnętrznych, które biorą udział w zapośredniczeniu.

W tabeli poniżej znajdziesz wersje adapterów zapośredniczenia, które obsługują przekazywanie sygnału traktowania treści z ograniczeniami wiekowymi do pakietu SDK firmy zewnętrznej biorącego udział w zapośredniczeniu:

Nazwa adaptera zapośredniczenia	Najwcześniejsza obsługiwana wersja
AppLovin	13.6.3.0
BidMachine	3.7.1.1
Bigo	5.9.0.1
Chartboost	9.12.1.1
DTExchange (Fyber)	8.4.5.1
i-mobile	2.3.2.4
InMobi	11.3.0.1
IronSource	9.4.3.0
Liftoff Monetize (Vungle)	7.7.4.2
LY (Line)	3.1.1.1
maio	2.0.9.0
Meta (Facebook)	6.21.0.4
Mintegral	17.1.61.1
Moloco	4.10.0.0
MyTarget	5.47.1.1
Pangle	8.1.0.3.1
PubMatic	5.1.2.2
Verve	3.9.0.0

Ustawienie dotyczące treści skierowanych do dzieci

Ostrzeżenie: Metoda setTagForChildDirectedTreatment() została wycofana. Zamiast niej, użyj metody setAgeRestrictedTreatment().

Na potrzeby amerykańskiej ustawy o ochronie prywatności dzieci w internecie (COPPA), istnieje ustawienie „Tagowanie treści jako skierowanych 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 Google traktowało Twoje treści jako skierowane do dzieci, podejmiemy działania, aby wyłączyć reklamy oparte na zainteresowaniach i reklamy remarketingowe w przypadku tego żądania reklamy.

Ustawienie dotyczące treści skierowanych do dzieci możesz zastosować za pomocą setTagForChildDirectedTreatment():

• Wywołaj metodę setTagForChildDirectedTreatment z parametrem TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE, aby wskazać, że chcesz, aby Twoje treści były traktowane jako skierowane do dzieci na potrzeby ustawy COPPA. Uniemożliwia to przesyłanie identyfikatora reklamowego Androida (AAID).

• Wywołaj metodę 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 metodę setTagForChildDirectedTreatment z parametrem TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED, jeśli nie chcesz wskazywać, jak mają być traktowane Twoje treści w żądaniach reklamy w odniesieniu do ustawy 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 =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

Java

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

Uwaga: w przypadku aplikacji w programie Dla całej rodziny które są przeznaczone głównie dla dzieci oraz użytkowników zalogowanych na kontach Google zarządzanych za pomocą Family Link wszystkie treści są automatycznie traktowane jako skierowane do dzieci we wszystkich żądaniach reklamy.

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

Ostrzeżenie: metoda setTagForUnderAgeOfConsent() została wycofana. Zamiast niej użyj metody set the setAgeRestrictedTreatment() method.

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. Dodaliśmy tę funkcję, by ułatwić spełnianie wymogów Ogólnego rozporządzenia o ochronie danych (RODO). Zgodnie z RODO możesz mieć także inne zobowiązania. Zapoznaj się ze wskazówkami Unii Europejskiej i skonsultuj ze swoim radcą prawnym. 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 TFUA (Tag For Users under the Age of Consent in Europe – tag stosowany w przypadku użytkowników z Europy, którzy nie osiągnęli wieku świadomego wyrażenia zgody). Ten parametr wyłącza reklamy spersonalizowane, w tym remarketingowe, w przypadku wszystkich żądań reklamy. Uniemożliwia również przesyłanie żądań do zewnętrznych dostawców reklam – dotyczy to np. pikseli śledzących reklamy lub serwerów reklamowych firm zewnętrznych.

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

• Wywołaj metodę setTagForUnderAgeOfConsent() z parametrem TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE, aby wskazać, że chcesz, aby żądanie reklamy było traktowane jako dotyczące użytkowników z Europejskiego Obszaru Gospodarczego (EOG), którzy nie osiągnęli wieku świadomego wyrażenia zgody. Uniemożliwia to też przesyłanie identyfikatora reklamowego Androida (AAID).

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

• Wywołaj metodę setTagForUnderAgeOfConsent() z parametrem TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED, aby wskazać, że nie masz pewności, 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żania zgody.

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

Kotlin

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

Java

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

Tagi umożliwiające ustawienie dotyczące treści skierowanych do dzieci i setTagForUnderAgeOfConsent() nie powinny mieć jednocześnie wartości true. Jeśli tak jest, pierwszeństwo ma ustawienie dotyczące treści skierowanych do dzieci.

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 Twojej 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ą ustawić maksymalną ocenę treści reklam w przypadku swoich żądań reklamy za pomocą setMaxAdContentRating metody. Reklamy AdMob zwracane po skonfigurowaniu tej opcji mają ocenę treści na tym poziomie lub niższą. Dostępne wartości tego dodatkowego parametru sieci są oparte na klasyfikacjach oznaczeń 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 reklam powinny odpowiadać oznaczeniu treści cyfrowych nie wyższemu niż G:

Kotlin

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

Java

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

Więcej informacji:

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

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

Uwaga: ustawienia filtra oceny treści określone za pomocą Google Mobile Ads SDK (Legacy) zastępują wszystkie ustawienia skonfigurowane w interfejsie AdMob.

Publisher Privacy Treatment API (beta)

Publisher Privacy Treatment (PPT) API to opcjonalne narzędzie, które umożliwia aplikacjom określenie, czy wyłączyć personalizację reklam w przypadku wszystkich żądań reklamy za pomocą metody setPublisherPrivacyPersonalizationState(). Gdy używasz tej funkcji, do wszystkich przyszłych żądań reklamy w pozostałej części sesji dodawany 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 =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setPublisherPrivacyPersonalizationState(
      RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED
    )
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

Java

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

Uwaga: w przypadku żądań reklamy z wieloma sygnałami ochrony prywatności użytkowników pierwszeństwo ma sygnał najbardziej restrykcyjny. Konkretne przykłady znajdziesz w dokumentacji Publisher Privacy Treatment API.

Żądanie reklamy

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

Dodawanie dodatkowych informacji wysyłanych z żądaniem reklamy

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

Poniższy fragment kodu ustawia w Google dodatkowy parametr sieci o kluczu collapsible i wartości bottom:

Kotlin

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

Java

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