Kierowanie

Z tego przewodnika dowiesz się, jak podać informacje o kierowaniu w żądaniu reklamy.

Wymagania wstępne

RequestConfiguration

RequestConfiguration to struktura, która gromadzi informacje o kierowaniu, które można stosować globalnie za pomocą funkcji globalnej SetRequestConfiguration().

Aby zaktualizować konfigurację żądania, najpierw pobierz bieżącą konfigurację, wprowadź żądane aktualizacje i ustaw ją w następujący sposób:

  firebase::gma::RequestConfiguration retrieved_configuration =
    firebase::gma::GetRequestConfiguration();

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

Ustawienie skierowane do dzieci

Na potrzeby ustawy 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, zaświadczasz, że to powiadomienie jest prawdziwe i że masz upoważnienie do działania w imieniu właściciela aplikacji. Rozumiesz, ż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 chcesz, aby Twoje treści były traktowane jako skierowane do dzieci, wyłączymy reklamy oparte na zainteresowaniach i reklamy remarketingowe w odpowiedzi na to żądanie reklamy.

To ustawienie można skonfigurować, przypisując element tag_for_child_directed_treatment struktury RequestConfiguration do jednej z tych wartości wyliczanych:

  • 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 do RequestConfiguration::kChildDirectedTreatmentTrue.
  • Aby wskazać, że nie chcesz, żeby Twoje treści były traktowane jako skierowane do dzieci zgodnie z ustawą COPPA, przypisz RequestConfiguration::tag_for_child_directed_treatment do RequestConfiguration::kChildDirectedTreatmentFalse.
  • Jeśli nie chcesz określać w żądaniach reklam, jak Twoje treści mają być traktowane zgodnie z ustawą COPPA, przypisz wartość RequestConfiguration::tag_for_child_directed_treatment do RequestConfiguration::kChildDirectedTreatmentUnspecified.

Poniższy przykład wskazuje, że Twoje treści mają być 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, zaświadczasz, że to powiadomienie jest prawdziwe i że masz upoważnienie do działania w imieniu właściciela aplikacji. Rozumiesz, że nadużywanie tego ustawienia może spowodować zamknięcie Twojego konta Google.

.

Możesz oznaczyć swoje żądania reklamy, aby były traktowane jako skierowane do 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 się 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 w Europie). Wyłącza on reklamy spersonalizowane, w tym remarketingowe, w przypadku wszystkich żądań reklam. 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 znajduje się element składowy do konfigurowania parametru TFUA: tag_for_under_age_of_consent, który można skonfigurować za pomocą następujących wartości wyliczanych:

  • Aby wskazać, że żądanie reklamy ma być 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 do RequestConfiguration::kUnderAgeOfConsentTrue.
  • 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 do RequestConfiguration::kUnderAgeOfConsentFalse.
  • Przypisz RequestConfiguration::tag_for_under_age_of_consent do RequestConfiguration::kUnderAgeOfConsentUnspecified, aby wskazać, że nie zostało przez Ciebie określone, 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.

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 treści skierowanych do dzieci oraz użytkowników, którzy nie osiągnęli 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 za pomocą interfejsu RequestConfiguration::max_ad_content_rating field. Reklamy AdMob zwracane po skonfigurowaniu mają ocenę treści na tym poziomie lub niższym. 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

Ten kod konfiguruje strukturę RequestConfiguration, która określa, że zwrócona treść reklamy powinna odpowiadać oznaczeniem etykiety treści cyfrowych 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 wraz z żądaniem reklamy.

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 będzie mogło 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();