Z tego przewodnika dowiesz się, jak podać w żądaniu reklamy informacje o kierowaniu.
Wymagania wstępne
- Wykonaj te czynności.
RequestConfiguration
RequestConfiguration
to struktura, która gromadzi informacje o kierowaniu przeznaczone do stosowania globalnie za pomocą funkcji globalnej SetRequestConfiguration()
.
Aby zaktualizować konfigurację żądania, najpierw uzyskaj bieżącą konfigurację, przeprowadź aktualizacje 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 skierowane do dzieci
Zgodnie z ustawą o ochronie prywatności dzieci w internecie (Children's Online Privacy Protection Act, COPPA) dostępne jest ustawienie o nazwie „tag traktowania treści jako skierowanych do dzieci”. Ustawiając ten tag, poświadczasz, że to powiadomienie jest prawidłowe i że masz upoważnienie do działania w imieniu właściciela aplikacji. Przyjmujesz do wiadomości, że nadużywanie 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 wskażesz, że Google ma traktować Twoje treści jako skierowane do dzieci, wyłączymy reklamy oparte na zainteresowaniach i reklamy remarketingowe w przypadku tego żądania reklamy.
To ustawienie można skonfigurować, przypisując element tag_for_child_directed_treatment
struktury RequestConfiguration
do jednej z tych wartości wyliczonych:
- Aby wskazać, że Twoje treści mają być traktowane jako skierowane do dzieci zgodnie z ustawą COPPA, przypisz do niego
RequestConfiguration::tag_for_child_directed_treatment
RequestConfiguration::kChildDirectedTreatmentTrue
. - Wskaż
RequestConfiguration::tag_for_child_directed_treatment
adresowiRequestConfiguration::kChildDirectedTreatmentFalse
, że nie chcesz, aby Twoje treści były traktowane jako skierowane do dzieci zgodnie z ustawą COPPA. - Podaj wartość
RequestConfiguration::tag_for_child_directed_treatment
użytkownikowiRequestConfiguration::kChildDirectedTreatmentUnspecified
, jeśli nie chcesz określać, jak Twoje treści mają być traktowane w odniesieniu do ustawy COPPA w żądaniach reklam.
Ten przykład wskazuje, że chcesz, aby Twoje treści były traktowane jako skierowane do dzieci zgodnie z ustawą 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, poświadczasz, że to powiadomienie jest poprawne i że masz upoważnienie do działania w imieniu właściciela aplikacji. Przyjmujesz do wiadomości, że naruszenie tego ustawienia może spowodować zamknięcie 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, 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 RODO może nakładać na Ciebie także inne obowiązki prawne. Zapoznaj się ze wskazówkami Unii Europejskiej i skonsultuj ze swoim 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
Gdy 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. 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, parametr RequestConfiguration zawiera element TFUA służący do konfigurowania parametru TFUA tag_for_under_age_of_consent
, który można skonfigurować przy użyciu tych wartości wyliczeniowych:
- Aby wskazać, że żądanie reklamy ma być traktowane jako skierowane do użytkowników z Europejskiego Obszaru Gospodarczego, które nie osiągnęły wieku świadomego wyrażenia zgody, przypisz wartość
RequestConfiguration::tag_for_under_age_of_consent
doRequestConfiguration::kUnderAgeOfConsentTrue
. - Aby wskazać, że żądanie reklamy nie jest traktowane jako
RequestConfiguration::tag_for_under_age_of_consent
w przypadku użytkowników z Europejskiego Obszaru Gospodarczego, którzy nie osiągnęli wieku świadomego wyrażenia zgody, przypisz do żądaniaRequestConfiguration::kUnderAgeOfConsentFalse
. - Przypisz właściwość
RequestConfiguration::tag_for_under_age_of_consent
doRequestConfiguration::kUnderAgeOfConsentUnspecified
, aby wskazać, że nie określono, czy żądanie reklamy powinno być traktowane 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 w żądaniach reklamy chcesz uwzględniać 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 poniżej wieku świadomego wyrażenia zgody” nie powinny mieć jednocześnie wartości „prawda”. Jeśli tak, pierwszeństwo ma ustawienie dotyczące treści skierowanych do dzieci.
Filtrowanie treści reklamy
Aplikacje mogą ustawiać maksymalną ocenę treści reklam w żądaniach reklamy na stronie RequestConfiguration::max_ad_content_rating field
. Reklamy AdMob zwracane, gdy to ustawienie jest skonfigurowane, mają ocenę treści na tym poziomie lub niższym. Możliwe wartości są oparte na klasyfikacji etykiet treści cyfrowych i muszą być jedną z tych wartości wyliczeniowych:
RequestConfiguration::kMaxAdContentRatingG
RequestConfiguration::kMaxAdContentRatingPG
RequestConfiguration::kMaxAdContentRatingT
RequestConfiguration::kMaxAdContentRatingMA
Ten kod konfiguruje strukturę RequestConfiguration
, aby określić, że zwrócona treść reklamy powinna być zgodna z oznaczeniem treści cyfrowych nie wyższych 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 są wysyłane w żądaniu reklamy.
URL treści
Gdy aplikacja wysyła żądanie reklamy, może przekazać adres URL treści, które wyświetla. Umożliwi to kierowanie reklam na słowa kluczowe w celu dopasowania reklamy do treści.
Jeśli na przykład aplikacja żąda reklamy i wyświetla treści z witryny https://www.example.com
, możesz przekazać ten adres URL, by 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();