Kierowanie


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

Wymagania wstępne

RequestConfiguration

RequestConfiguration to struktura, która zbiera informacje o kierowaniu, aby można je było stosować 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

Na potrzeby ustawy o ochronie prywatności dzieci w internecie (COPPA) istnieje ustawienie „Oznacz jako skierowane do dzieci”. Ustawiając ten tag, potwierdzasz, że to zgłoszenie 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 wskażesz, że chcesz, aby Twoje treści były traktowane jako skierowane do dzieci, podejmiemy działania, aby wyłączyć w tym żądaniu 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 wyliczeniowych:

  • Przypisz wartość RequestConfiguration::tag_for_child_directed_treatment do parametru RequestConfiguration::kChildDirectedTreatmentTrue, aby wskazać, że chcesz, aby Twoje treści były traktowane jako skierowane do dzieci zgodnie z ustawą COPPA.
  • Przypisz wartość 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 na potrzeby ustawy COPPA.
  • Przypisz wartość RequestConfiguration::tag_for_child_directed_treatment do parametru RequestConfiguration::kChildDirectedTreatmentUnspecified, jeśli nie chcesz w żądaniach reklam określać, jak mają być traktowane Twoje treści w świetle ustawy COPPA.

Poniższy przykład wskazuje, że na potrzeby ustawy COPPA chcesz, aby Twoje treści były traktowane jako skierowane do dzieci:

  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.

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 samodzielnego wyrażania 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 klasie RequestConfiguration znajduje się element do konfigurowania parametru TFUA: tag_for_under_age_of_consent, który można skonfigurować za pomocą tych wartości wyliczeniowych:

  • Przypisz wartość RequestConfiguration::tag_for_under_age_of_consent do parametru RequestConfiguration::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.
  • Przypisz wartość RequestConfiguration::tag_for_under_age_of_consent do parametru RequestConfiguration::kUnderAgeOfConsentFalse, aby wskazać, że żądanie reklamy nie 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.
  • Przypisz wartość RequestConfiguration::tag_for_under_age_of_consent do parametru RequestConfiguration::kUnderAgeOfConsentUnspecified, aby wskazać, że nie określono, czy żą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.

Poniższy przykład pokazuje, że chcesz, aby parametr TFUA był uwzględniany w żądaniach reklamy:

  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 zgody na przetwarzanie danych” nie powinny mieć jednocześnie wartości „true”. Jeśli tak jest, ustawienie dotyczące kierowania na dzieci ma pierwszeństwo.

Filtrowanie treści reklam

Aplikacje mogą ustawić maksymalną ocenę treści reklam w swoich żądaniach reklamy za pomocą parametru 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 wartości tego parametru są oparte na klasyfikacjach etykiet treści cyfrowych i muszą być jedną z tych wartości wyliczeniowych:

  • RequestConfiguration::kMaxAdContentRatingG
  • RequestConfiguration::kMaxAdContentRatingPG
  • RequestConfiguration::kMaxAdContentRatingT
  • RequestConfiguration::kMaxAdContentRatingMA

Poniższy kod konfiguruje strukturę RequestConfiguration, aby określić, że zwracane treści reklamowe powinny odpowiadać oznaczeniu etykiety treści cyfrowych nie wyższemu 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

Podczas wysyłania żądania reklamy aplikacje mogą przekazywać adres URL treści, które wyświetlają. Dzięki temu kierowanie na słowa kluczowe może dopasować reklamę do treści.

Jeśli np. aplikacja wysyła żądanie reklamy podczas wyświetlania treści z domeny 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();