Z tego przewodnika dowiesz się, jak przekazać informacje o kierowaniu do pakietu SDK do reklam mobilnych Google.
Aby zobaczyć działający przykład, pobierz aplikację Android API Demo.Pobierz demonstrację interfejsu API
Warunek wstępny
- Zapoznaj się z przewodnikiem dla początkujących.
RequestConfiguration
RequestConfiguration
zbiera informacje o kierowaniu stosowane globalnie do każdego żądania reklamy. Informacje o dostępnych tagach kierowania znajdziesz w dokumentacji RequestConfiguration.Builder
.
Aby zaktualizować konfigurację żądania, pobierz kreatora z dotychczasowej konfiguracji, wprowadź odpowiednie zmiany i ustaw go w ten sposób:
Kotlin
val requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Ustawienie jako skierowane do dzieci
W celu zachowania zgodności z amerykańską ustawą o ochronie prywatności dzieci w internecie (COPPA) istnieje ustawienie „Tagi dla treści skierowanych do dzieci”. Ustawiając ten tag, potwierdzasz, że ta informacja jest prawidłowa i masz upoważnienie do działania w imieniu właściciela aplikacji. Rozumiesz, że niewłaściwe użycie tego ustawienia może skutkować zamknięciem 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 oznaczysz swoje treści jako skierowane do dzieci, wyłączymy w przypadku tego żądania reklamy oparte na zainteresowaniach i reklamy remarketingowe.
Ustawienie dotyczące treści skierowanych do dzieci możesz zastosować za pomocą:
setTagForChildDirectedTreatment()
:
Zadzwoń pod numer
setTagForChildDirectedTreatment
(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. Zapobiega to przesyłaniu identyfikatora wyświetlania reklam na urządzeniach z Androidem (AAID).Zadzwoń pod numer
setTagForChildDirectedTreatment
, aby poinformować, że nie chcesz, aby Twoje treści były traktowane jako skierowane do dzieci na potrzeby ustawy COPPA.Zadzwoń pod numer
setTagForChildDirectedTreatment
, jeśli nie chcesz wskazywać, jak chcesz, aby Twoje treści były traktowane w świetle ustawy COPPA w żądaniach reklam.
Poniższy przykład wskazuje, że Twoje treści mają być traktowane jako skierowane do dzieci zgodnie z ustawą COPPA:
Kotlin
val requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration 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ć swoje żądania reklamy, aby 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 obowiązki prawne. Zapoznaj się ze wskazówkami Unii Europejskiej i skonsultuj się z prawnikiem. 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 wydawców
Jeśli używasz tej funkcji, w żądaniu reklamy znajdzie się parametr TFUA (Dla użytkowników, którzy nie osiągnęli wieku świadomego wyrażenia zgody w Europie). 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 śledzących reklamy lub serwerów reklamowych firm zewnętrznych.
Tak jak w przypadku ustawień dotyczących treści skierowanych do dzieci, w RequestConfiguration.Builder
dostępna jest metoda ustawiania parametru TFUA:setTagForUnderAgeOfConsent()
z następującymi opcjami.
Wywołaj
setTagForUnderAgeOfConsent()
z wartościąTAG_FOR_UNDER_AGE_OF_CONSENT_TRUE
, aby oznaczyć żądanie reklamy jako dotyczące użytkowników z Europejskiego Obszaru Gospodarczego (EOG), którzy nie osiągnęli wieku samodzielnego wyrażania zgody. Zapobiega to też przesyłaniu identyfikatora wyświetlania reklam na urządzeniach z Androidem (AAID).Wywołaj
setTagForUnderAgeOfConsent()
z wartością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 samodzielnego wyrażania zgody.Zadzwoń pod numer
setTagForUnderAgeOfConsent()
, używając adresuTAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED
, aby wskazać, że nie określasz, czy żądanie reklamy powinno być traktowane jako w przypadku użytkowników z Europejskiego Obszaru Gospodarczego, którzy nie osiągnęli wieku świadomego wyrażenia zgody.
Ten przykład wskazuje, że chcesz uwzględnić TFUA w żądaniach reklam:
Kotlin
val requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Tagi włączające ustawienie Skierowane do dzieci i setTagForUnderAgeOfConsent()
nie powinny jednocześnie mieć wartości 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, które dotyczą ofert powiązanych z reklamą, wszystkie reklamy i powiązane z nimi oferty wyświetlane w aplikacji muszą pasować do jej oceny treści, nawet jeśli same w sobie treści są zgodne 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ń reklamy 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 tej dodatkowej sieci zależą od klasyfikacji etykiet treści cyfrowych i muszą być jednym z tych ciągó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 reklamy powinny odpowiadać oznaczeniu treści cyfrowych o etapie nie wyższym niż G
:
Kotlin
val requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration 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żdego żądania reklamy
Ustawianie maksymalnej oceny treści reklam w aplikacji lub na koncie
Zasady traktowania wydawców (beta)
Ochrona prywatności wydawcy
Interfejs API (PPT) to opcjonalne narzędzie, które umożliwia aplikacjom wskazywanie, czy należy wyłączyć personalizację reklam w przypadku wszystkich żądań reklamy, za pomocą metody setPublisherPrivacyPersonalizationState()
.
Gdy używasz tej funkcji, parametr PPT jest uwzględniany we wszystkich przyszłych żądaniach reklamy aż do końca sesji.
Domyślnie żądania reklam wysyłane do Google zawierają reklamy spersonalizowane. Ten kod wyłącza personalizację reklam w przypadku wszystkich żądań reklamy:
Kotlin
val requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Żądanie reklamy
Obiekt AdRequest
zbiera informacje o kierowaniu, które mają być wysyłane wraz z żądaniem reklamy.
W przykładzie kierowania reklam możesz zobaczyć, jak wdrożyć kierowanie w aplikacji demonstracyjnej interfejsu Android API.