Z tego przewodnika dowiesz się, jak przekazywać informacje o kierowaniu w żądaniu reklamy.
Wymagania wstępne
- Wykonaj instrukcje w sekcji Rozpocznij.
RequestConfiguration
RequestConfiguration
to struktura, która gromadzi informacje kierowania, które mają być stosowane globalnie za pomocą funkcji globalnej SetRequestConfiguration()
.
Aby zaktualizować konfigurację żądania, najpierw pobierz bieżącą konfigurację, wprowadź odpowiednie zmiany i ustaw ją w ten sposób:
firebase::gma::RequestConfiguration retrieved_configuration = firebase::gma::GetRequestConfiguration(); // .. apply your changes, then: firebase::gma::SetRequestConfiguration(request_configuration);
Ustawienie dotyczące treści skierowanych 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 to powiadomienie jest prawidłowe i masz upoważnienie do działania w imieniu właściciela aplikacji. Rozumiesz, że nadużycie tego ustawienia może spowodować zamknięcie 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 można skonfigurować, przypisując element tag_for_child_directed_treatment
struktury RequestConfiguration
do jednej z tych wartości wyliczalnych:
- Przypisz wartość
RequestConfiguration::tag_for_child_directed_treatment
do wartościRequestConfiguration::kChildDirectedTreatmentTrue
, aby wskazać, że chcesz, aby Twoje treści były traktowane jako skierowane do dzieci zgodnie z ustawą COPPA. - Przypisz
RequestConfiguration::tag_for_child_directed_treatment
doRequestConfiguration::kChildDirectedTreatmentFalse
, aby wskazać, że nie chcesz, aby Twoje treści były traktowane jako skierowane do dzieci zgodnie z ustawą COPPA. - Przypisz
RequestConfiguration::tag_for_child_directed_treatment
doRequestConfiguration::kChildDirectedTreatmentUnspecified
, jeśli nie chcesz wskazywać, jak Twoje treści mają być traktowane w świetle ustawy COPPA w żądaniach reklamowych.
Ten przykład wskazuje, że chcesz, aby Twoje treści były traktowane jako kierowane do dzieci na potrzeby ustawy COPPA:
firebase::gma::RequestConfiguration request_configuration = firebase::gma::GetRequestConfiguration(); request_configuration.tag_for_child_directed_treatment = firebase::RequestConfiguration::kChildDirectedTreatmentTrue; firebase::gma::SetRequestConfiguration(request_configuration);
Ustawiając ten tag, potwierdzasz, że to powiadomienie jest prawidłowe 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.
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 zobowiązania. Zapoznaj się ze wskazówkami Unii Europejskiej i skonsultuj ze swoim radcą prawnym. 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 działalność wydawców
Jeśli użyjesz tej funkcji, do żądania reklamy dodamy parametr Tag For Users under the Age of Consent in Europe (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 śledzących reklamy lub serwerów reklamowych firm zewnętrznych.
Podobnie jak w przypadku ustawień dotyczących treści skierowanych do dzieci, w polu RequestConfiguration możesz skonfigurować parametr TFUA tag_for_under_age_of_consent
, który może zawierać następujące wartości wyliczane:
- Przypisz wartość
RequestConfiguration::tag_for_under_age_of_consent
do wartościRequestConfiguration::kUnderAgeOfConsentTrue
, aby wskazać, że żądanie reklamy 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. - Aby wskazać, że nie chcesz, aby żądanie reklamy było traktowane jako dotyczące użytkowników z Europejskiego Obszaru Gospodarczego, którzy nie osiągnęli wieku świadomego wyrażenia zgody, przypisz wartość
RequestConfiguration::tag_for_under_age_of_consent
doRequestConfiguration::kUnderAgeOfConsentFalse
. - Przypisz wartość
RequestConfiguration::tag_for_under_age_of_consent
do wartościRequestConfiguration::kUnderAgeOfConsentUnspecified
, aby wskazać, że nie określono, czy żądanie reklamy powinno być traktowane jako dotyczące użytkowników z Europejskiego Obszaru Gospodarczego (EOG), którzy nie osiągnęli wieku samodzielnego wyrażania zgody.
Ten przykład wskazuje, że chcesz uwzględnić TFUA w żądaniach reklam:
firebase::gma::RequestConfiguration request_configuration = firebase::gma::GetRequestConfiguration(); request_configuration.tag_for_under_age_of_consent = firebase::RequestConfiguration::kUnderAgeOfConsentTrue; firebase::gma::SetRequestConfiguration(request_configuration);
Tagi włączające ustawienie „Dla dzieci” i „Użytkownicy poniżej wieku zgody” nie powinny mieć jednocześnie wartości true. Jeśli tak, pierwszeństwo ma ustawienie dotyczące treści skierowanych do dzieci.
Filtrowanie treści reklam
Aplikacje mogą ustawiać maksymalną ocenę treści reklam w żądaniach reklamy za pomocą interfejsu RequestConfiguration::max_ad_content_rating field
. Reklamy AdMob zwracane po skonfigurowaniu tej opcji mają ocenę treści na tym poziomie lub niższą. Możliwe wartości zależą od klasyfikacji etykiet treści cyfrowych i muszą być jedną z tych wartości wyliczanych:
RequestConfiguration::kMaxAdContentRatingG
RequestConfiguration::kMaxAdContentRatingPG
RequestConfiguration::kMaxAdContentRatingT
RequestConfiguration::kMaxAdContentRatingMA
Podany niżej kod konfiguruje strukturę RequestConfiguration
, aby wskazać, że zwrócone treści reklamy powinny odpowiadać etykiecie treści cyfrowych o oznaczeniu nie wyższym niż G:
firebase::gma::RequestConfiguration request_configuration = firebase::gma::GetRequestConfiguration(); request_configuration.max_ad_content_rating = firebase::RequestConfiguration::kMaxAdContentRatingG; firebase::gma::SetRequestConfiguration(request_configuration);
AdRequest
Obiekt AdRequest
zbiera informacje o kierowaniu, które mają być wysyłane z żądaniem reklamy.
URL treści
Aplikacje mogą przekazywać adres URL treści, które wyświetlają, gdy wysyłają żądanie reklamy. Dzięki temu kierowanie na słowa kluczowe może dopasować reklamę do treści.
Jeśli na przykład Twoja aplikacja wysyła żądanie reklamy podczas wyświetlania treści z witryny https://www.example.com
, możesz przekazać ten adres URL, aby kierować reklamy na odpowiednie słowa kluczowe:
// AdRequest with content URL: firebase::admob::AdRequest ad_request(/*content_url=*/"https://www.example.com"); // AdRequest without content URL: firebase::admob::AdRequest ad_request();