Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Kierowanie

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

Wymagania wstępne

Wykonaj wszystkie czynności opisane w artykule Pierwsze kroki.

`RequestConfiguration`

RequestConfiguration to struktura, która zbiera informacje o kierowaniu, aby zastosować je 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 „Tagowanie treści jako skierowanych do dzieci”. Ustawiając ten tag, potwierdzasz, że to powiadomienie jest poprawne i że masz uprawnienia do działania w imieniu właściciela aplikacji. Rozumiesz, że nadużywanie tego ustawienia może być przyczyną zamknięcia 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 Google traktował Twoje treści jako skierowane do dzieci, podejmiemy działania, aby wyłączyć reklamy oparte na zainteresowaniach i reklamy remarketingowe w tym żądaniu reklamy.

To ustawienie można skonfigurować, przypisując do elementu tag_for_child_directed_treatment struktury RequestConfiguration jedną z tych wartości wyliczeniowych:

Przypisz RequestConfiguration::tag_for_child_directed_treatment wartość RequestConfiguration::kChildDirectedTreatmentTrue, aby wskazać, że chcesz, aby Twoje treści były traktowane jako skierowane do dzieci na potrzeby ustawy COPPA.
Przypisz RequestConfiguration::tag_for_child_directed_treatment wartość RequestConfiguration::kChildDirectedTreatmentFalse, aby wskazać, że nie chcesz, aby Twoje treści były traktowane jako skierowane do dzieci na potrzeby ustawy COPPA.
Przypisz RequestConfiguration::tag_for_child_directed_treatment wartość RequestConfiguration::kChildDirectedTreatmentUnspecified, jeśli nie chcesz wskazywać, jak Twoje treści mają być traktowane w żądaniach reklamy w odniesieniu do ustawy COPPA.

Poniższy przykład wskazuje, że chcesz, aby Twoje treści były traktowane jako skierowane 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 poprawne i że masz uprawnienia do działania w imieniu właściciela aplikacji. Rozumiesz, że nadużywanie tego ustawienia może być przyczyną zamknięcia Twojego konta Google.

Użytkownicy, którzy nie osiągnęli wieku samodzielnego wyrażania zgody

Możesz oznaczyć swoje żądania reklamy, by 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. Dodaliśmy tę funkcję, by ułatwić spełnianie wymogów Ogólnego rozporządzenia 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 mają ułatwiać zachowanie zgodności z przepisami, ale nie zwalniają wydawców z obowiązków wynikających z 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 TFUA (Tag For Users under the Age of Consent in Europe – tag stosowany w przypadku użytkowników z Europy, którzy nie osiągnęli wieku samodzielnego wyrażania zgody). Ten parametr wyłącza reklamy spersonalizowane, w tym remarketingowe, we wszystkich żądaniach reklamy. Uniemożliwia też przesyłanie żądań do zewnętrznych dostawców reklam – dotyczy to np. pikseli pomiaru skuteczności reklam lub serwerów reklamowych firm zewnętrznych.

Podobnie jak w przypadku ustawień dotyczących treści skierowanych do dzieci, w strukturze RequestConfiguration znajduje się element do konfigurowania parametru TFUA: tag_for_under_age_of_consent. Można go skonfigurować za pomocą tych wartości wyliczeniowych:

Przypisz RequestConfiguration::tag_for_under_age_of_consent wartość RequestConfiguration::kUnderAgeOfConsentTrue, aby wskazać, że chcesz, aby żądanie reklamy było traktowane jako dotyczące użytkowników z Europejskiego Obszaru Gospodarczego (EOG), którzy nie osiągnęli wieku samodzielnego wyrażania zgody.
Przypisz RequestConfiguration::tag_for_under_age_of_consent wartość RequestConfiguration::kUnderAgeOfConsentFalse, aby wskazać, że nie chcesz, aby żądanie reklamy było traktowane jako dotyczące użytkowników z Europejskiego Obszaru Gospodarczego (EOG), którzy nie osiągnęli wieku samodzielnego wyrażania zgody.
Przypisz RequestConfiguration::tag_for_under_age_of_consent wartość RequestConfiguration::kUnderAgeOfConsentUnspecified, aby wskazać, że nie masz pewności, 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 wskazuje, że chcesz, aby tag TFUA był uwzględniany w Twoich żą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 umożliwiające włączenie ustawienia dotyczącego treści skierowanych do dzieci i użytkowników, którzy nie osiągnęli wieku samodzielnego wyrażania zgody, nie powinny mieć jednocześnie wartości true. Jeśli jednak tak jest, ustawienie dotyczące treści skierowanych do dzieci ma pierwszeństwo.

Filtrowanie treści reklam

Aplikacje mogą ustawić maksymalną ocenę treści reklam w swoich żą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 wartości 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

Ten kod konfiguruje strukturę RequestConfiguration, aby określić, że zwracane treści reklam powinny odpowiadać etykiecie treści cyfrowych nie wyższej 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

Podczas wysyłania żądania reklamy aplikacje mogą przekazywać adres URL wyświetlanych treści. Umożliwia to kierowanie na słowa kluczowe, aby dopasować reklamę do treści.

Jeśli na przykład Twoja aplikacja wysyła żądanie reklamy podczas wyświetlania treści z adresu 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();