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, które są stosowane globalnie do każdego żądania reklamy. Dostępne tagi kierowania znajdziesz w dokumentacji RequestConfiguration.Builder.
Utwórz obiekt RequestConfiguration z potrzebnymi tagami kierowania, używając jego kreatora, a następnie ustaw konfigurację, wywołując MobileAds.setRequestConfiguration().
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 AdMob 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 AdMob 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 traktowania treści z uwzględnieniem wieku
Aby ułatwić Ci zachowanie zgodności z obowiązującymi przepisami dotyczącymi prywatności dzieci i nastolatków, GMA Next-Gen SDK udostępnia ustawienie traktowania ze względu na wiek. Ustawienie traktowania ze względu na wiek pozwala określić, czy usługa GMA Next-Gen SDK powinna stosować określone zabezpieczenia dotyczące wyświetlania reklam dzieciom, nastolatkom lub osobom w nieokreślonym wieku.
Możesz ustawić traktowanie treści 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)Java
RequestConfiguration requestConfiguration =
new RequestConfiguration.Builder()
// Indicate that ad requests should have child age treatment.
.setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);Aby wskazać, że treści są skierowane do nastolatków lub że nie określono wieku, zastąp ustawienie CHILD tym:
TEENUNSPECIFIED
Gdy używasz tego ustawienia, GMA Next-Gen SDK uwzględnia w żądaniach reklamy parametr tfat. Skonsultuj się z doradcą prawnym, aby określić ustawienia dotyczące traktowania swoich użytkowników ze względu na wiek 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.
Przejście z TFCD i TFUA na traktowanie treści z uwzględnieniem wieku
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 dotyczące 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 |
Nie przypisano 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 |
Nie przypisano wartości .setTagForUnderAgeOfConsent() |
AgeRestrictedTreatment.UNSPECIFIED |
| Brak odpowiednika | AgeRestrictedTreatment.TEEN |
Interakcje tagu 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.
Przekazywanie ustawień dotyczących wieku za pomocą zapośredniczenia AdMob
Jeśli ustawisz traktowanie z uwzględnieniem wieku za pomocą GMA Next-Gen SDK, adaptery zapośredniczenia będą przekazywać sygnał traktowania z uwzględnieniem wieku do pakietów SDK innych firm, które uczestniczą w zapośredniczeniu.
W tabeli poniżej znajdziesz wersje adaptera zapośredniczenia, które obsługują przekazywanie sygnału dotyczącego traktowania treści jako przeznaczonych dla osób pełnoletnich do pakietu SDK zewnętrznego źródła reklam objętego zapośredniczeniem:
| 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
Na potrzeby amerykańskiej ustawy o ochronie prywatności dzieci w internecie (Children's Online Privacy Protection Act, COPPA) istnieje ustawienie „tagowanie 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 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 „skierowane do dzieci” możesz zastosować w setTagForChildDirectedTreatment():
Wywołaj
setTagForChildDirectedTreatmentzTAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE, aby wskazać, że chcesz, aby Twoje treści były traktowane jako skierowane do dzieci zgodnie z ustawą COPPA. Zapobiega to przesyłaniu identyfikatora wyświetlania reklam na Androida (AAID).Wywołaj
setTagForChildDirectedTreatmentzTAG_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.Jeśli nie chcesz wskazywać w żądaniach reklamy, jak mają być traktowane Twoje treści zgodnie z ustawą COPPA, wywołaj funkcję
setTagForChildDirectedTreatmentz parametremTAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED.
Poniższy przykład pokazuje, jak oznaczyć treści jako skierowane do dzieci zgodnie z ustawą 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);
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 działalność wydawców
Gdy używasz tej funkcji, w żądaniu reklamy znajdzie się parametr TFUA (tagowanie treści dla osób, które nie osiągnęły 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 pomiaru skuteczności reklamy lub serwerów reklamowych firm zewnętrznych.
Podobnie jak w przypadku ustawień dotyczących treści skierowanych do dzieci, w RequestConfiguration.Builder dostępna jest metoda ustawiania parametru TFUA:
setTagForUnderAgeOfConsent(),
z tymi opcjami.
Wywołaj
setTagForUnderAgeOfConsent()zTAG_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 też przesyłaniu identyfikatora wyświetlania reklam na urządzeniach z Androidem (AAID).Wywołaj
setTagForUnderAgeOfConsent()zTAG_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
setTagForUnderAgeOfConsent()z wartościąTAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED, aby wskazać, że nie określono, czy żą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.
Poniższy przykład pokazuje, że chcesz uwzględnić TFUA 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 dotyczącego skierowania do dzieci i setTagForUnderAgeOfConsent() nie powinny mieć jednocześnie wartości true. Jeśli tak będzie, pierwszeństwo ma ustawienie „skierowane 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 aplikacji muszą być odpowiednie do jej oceny treści, nawet jeśli sama treść jest ogólnie 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 tego ustawienia mają ocenę treści na tym poziomie lub niższym. Możliwe wartości tych dodatkowych informacji są oparte na klasyfikacjach oznaczeń treści cyfrowych i muszą być jednym z tych ciągów znaków:
MAX_AD_CONTENT_RATING_GMAX_AD_CONTENT_RATING_PGMAX_AD_CONTENT_RATING_TMAX_AD_CONTENT_RATING_MA
Poniższy kod konfiguruje obiekt RequestConfiguration, aby określić, że zwracane treści reklam powinny odpowiadać etykiecie treści cyfrowych nie wyższej 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);
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ń reklamy, za pomocą metody setPublisherPrivacyPersonalizationState(). Gdy używasz tej funkcji, we wszystkich przyszłych żądaniach reklamy w pozostałej części sesji uwzględniany jest parametr Publisher Privacy Treatment (PPT).
Domyślnie żądania reklam wysyłane do Google powodują wyświetlanie reklam spersonalizowanych. Ten 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);
Zbieranie przybliżonej lokalizacji
GMA Next-Gen SDK może zbierać przybliżoną lokalizację, aby kierować reklamy na podstawie lokalizacji urządzenia. Jeśli użytkownik przyzna uprawnienia dostępu do lokalizacji w Twojej aplikacji, GMA Next-Gen SDK będzie zbierać informacje o przybliżonej lokalizacji.
Od wersji 1.7.0 pakietu GMA Next-Gen SDK zbieranie przybliżonej lokalizacji jest domyślnie włączone. Zbieranie danych o przybliżonej lokalizacji możesz wyłączyć za pomocą metody setCoarseLocationCollectionEnabled().
W tym przykładzie wyłączono zbieranie przybliżonej lokalizacji:
Kotlin
val requestConfiguration =
RequestConfiguration.Builder()
// Disable automatic coarse location collection by the SDK.
.setCoarseLocationCollectionEnabled(false)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)Java
RequestConfiguration requestConfiguration =
new RequestConfiguration.Builder()
// Disable automatic coarse location collection by the SDK.
.setCoarseLocationCollectionEnabled(false)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);Żądanie reklamy
Obiekt AdRequest zbiera informacje o kierowaniu, które mają zostać wysłane z żądaniem reklamy.
Dodawanie dodatkowych informacji wysyłanych z żądaniem reklamy
Dodatkowe informacje wysyłane z żądaniem reklamy to dodatkowe szczegóły wysyłane z żądaniem reklamy, które są specyficzne dla pojedynczego źródła reklam.
Ten fragment kodu ustawia dodatkowy klucz parametru collapsible z wartością bottom dla Google:
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);