Z tego przewodnika dowiesz się, jak podać informacje o kierowaniu w żądaniu reklamy.
Wymagania wstępne
- Wykonaj czynności opisane 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 uzyskaj bieżącą konfigurację, wprowadź odpowiednie zmiany i ustaw konfigurację w następujący sposób:
firebase::gma::RequestConfiguration retrieved_configuration = firebase::gma::GetRequestConfiguration(); // .. apply your changes, then: firebase::gma::SetRequestConfiguration(request_configuration);
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”. Ustawienie oświadczasz, że to powiadomienie jest prawdziwe i że masz upoważnienie do działać w imieniu właściciela aplikacji. Rozumiesz, że nadużycie tego ustawienia może doprowadzić do zamknięcia konta Google.
Deweloper aplikacji może wskazać, czy Google ma traktować jako treści skierowanych do dzieci. Jeśli wskażesz, że traktowanie przez Google treści jako skierowanych do dzieci, podejmujemy odpowiednie działania, reklamy oparte na zainteresowaniach i reklamy remarketingowe.
To ustawienie można skonfigurować, przypisując parametr
tag_for_child_directed_treatment
element elementu struct do elementu RequestConfiguration
jedną z tych wartości wyliczanych:
- Przypisz
RequestConfiguration::tag_for_child_directed_treatment
do:RequestConfiguration::kChildDirectedTreatmentTrue
, aby wskazać, że chcesz, traktowanie treści jako skierowanych do dzieci zgodnie z ustawą COPPA. - Przypisz
RequestConfiguration::tag_for_child_directed_treatment
do:RequestConfiguration::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
do:RequestConfiguration::kChildDirectedTreatmentUnspecified
określić, jak Twoje treści mają być traktowane w kontekście ustawy COPPA żądania reklamy.
Ten przykład wskazuje, że chcesz, aby Twoje treści były traktowane jako treści 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 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.
Użytkownicy, którzy nie osiągnęli wieku świadomego wyrażenia zgody
Możesz oznaczyć swoje żądania reklamy, by były traktowane jako skierowane do użytkowników z Europy Obszar Gospodarczy (EOG), który nie osiągnął wieku świadomego wyrażenia zgody. Ta funkcja ma pomagać ułatwiają zachowanie zgodności z Ogólnym rozporządzeniem o ochronie danych (RODO) (RODO). Pamiętaj, że zgodnie z RODO możesz mieć także inne zobowiązania. Zapoznaj się z Wskazówki Unii Europejskiej i konsultacja 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, tag dla użytkowników, którzy nie osiągnęli wieku świadomego wyrażenia zgody w Europie (TFUA) będzie on uwzględniany w żądaniu reklamy. Ten parametr wyłącza spersonalizowanych reklam, w tym remarketingu, w przypadku wszystkich żądań reklamy. Dodatkowo uniemożliwia wysyłanie żądań do zewnętrznych dostawców reklam – dotyczy to np. pikseli śledzących reklamy lub z serwerów reklamowych firm zewnętrznych.
Tak jak w przypadku ustawień dotyczących treści skierowanych do dzieci, w żądaniu RequestConfiguration znajduje się element
konfigurując parametr TFUA: tag_for_under_age_of_consent
, który może być
skonfigurowana z tymi wartościami wyliczanymi:
- Przypisz
RequestConfiguration::tag_for_under_age_of_consent
do:RequestConfiguration::kUnderAgeOfConsentTrue
, aby wskazać, że makro żądania reklamy, aby zostało potraktowane w przypadku użytkowników z Europejskiego Obszaru Gospodarczego nie osiągnęli wieku świadomego wyrażenia zgody. - Przypisz
RequestConfiguration::tag_for_under_age_of_consent
do:RequestConfiguration::kUnderAgeOfConsentFalse
, aby wskazać, że makro żądania reklamy, aby nie były traktowane w przypadku użytkowników z Europejskiego Obszaru Gospodarczego (EOG) nie osiągnęło wieku świadomego wyrażenia zgody. - 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.
Poniższy przykład wskazuje, że w żądaniach reklamy chcesz uwzględnić TFUA:
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 „Skierowane do dzieci” i Użytkownicy, którzy nie osiągnęli wieku świadomego wyrażenia zgody nie powinny mieć jednocześnie wartości Prawda. Jeśli tak, ustawienie dotyczące treści skierowanych do dzieci ma pierwszeństwo.
Filtrowanie treści reklamy
Aplikacje mogą ustawić maksymalną ocenę treści reklam w żądaniach reklamy za pomocą
RequestConfiguration::max_ad_content_rating field
Reklamy AdMob zwracane po skonfigurowaniu tego ustawienia mają ocenę treści na tym poziomie lub niższą. Możliwe
te 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 reklamą
użytkownika.
URL treści
Aplikacja, która wysyła żądanie reklamy, może przekazać adres URL treści, którą wyświetlają. Dzięki temu kierowanie na słowa kluczowe może dopasować reklamę do treści.
Jeśli na przykład aplikacja żąda reklamy podczas wyświetlania treści z
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();