Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Kierowanie

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

Wymagania wstępne

Wykonaj czynności opisane w sekcji Pierwsze kroki.

`RequestConfiguration`

RequestConfiguration to struktura, która zbiera informacje o kierowaniu, które mają być stosowane 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 (Children's Online Privacy Protection Act, COPPA) istnieje ustawienie o nazwie „tagowanie jako skierowane do dzieci”. Ustawiając ten tag, potwierdzasz, że to powiadomienie jest poprawne i że posiadasz 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ło Twoje treści jako skierowane do dzieci, podejmiemy działania, aby wyłączyć reklamy oparte na zainteresowaniach i reklamy remarketingowe w przypadku tego żądania reklamy.

Ustawienie można skonfigurować, przypisując element tag_for_child_directed_treatment struktury RequestConfiguration do jednej z tych wartości typu wyliczeniowego:

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

Poniższy przykład pokazuje, jak oznaczyć treści 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, potwierdzasz, że to powiadomienie jest poprawne i że posiadasz 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 świadomego wyrażenia zgody

Możesz oznaczyć swoje żądania reklamy, aby zostały objęte ograniczonym przetwarzaniem danych w przypadku użytkowników z Europejskiego Obszaru Gospodarczego (EOG), 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ę z wytycznymi 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 działalność wydawców

Gdy używasz tej funkcji, w żądaniu reklamy znajdzie się parametr TFUA (tagowanie treści dla osób, które nie osiągnęły wieku świadomego wyrażenia zgody w Europie). 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 pomiaru skuteczności reklam lub serwerów reklamowych firm zewnętrznych.

Podobnie jak w przypadku ustawień dotyczących treści skierowanych do dzieci, w RequestConfiguration znajduje się element do konfigurowania parametru TFUA: tag_for_under_age_of_consent, który można skonfigurować za pomocą tych wartości typu wyliczeniowego:

Przypisz do parametru RequestConfiguration::tag_for_under_age_of_consent wartość RequestConfiguration::kUnderAgeOfConsentTrue, aby wskazać, że żądanie reklamy ma być traktowane jako skierowane do użytkowników z Europejskiego Obszaru Gospodarczego (EOG), którzy nie osiągnęli wieku świadomego wyrażenia zgody.
Przypisz do parametru RequestConfiguration::tag_for_under_age_of_consent wartość RequestConfiguration::kUnderAgeOfConsentFalse, aby wskazać, że żądanie reklamy nie ma być traktowane jako skierowane do użytkowników z Europejskiego Obszaru Gospodarczego (EOG), którzy nie osiągnęli wieku świadomego wyrażenia zgody.
Przypisz RequestConfiguration::tag_for_under_age_of_consent do RequestConfiguration::kUnderAgeOfConsentUnspecified, aby wskazać, że nie określono, czy żądanie reklamy ma być traktowane jako skierowane do użytkowników z Europejskiego Obszaru Gospodarczego (EOG), którzy nie osiągnęli wieku świadomego wyrażenia zgody.

Poniższy przykład pokazuje, że chcesz uwzględnić TFUA 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 umożliwiające włączenie ustawienia „Skierowane do dzieci” i „Użytkownicy poniżej wieku świadomego wyrażenia zgody” nie powinny mieć jednocześnie wartości „true”. Jeśli tak będzie, pierwszeństwo ma ustawienie „skierowane do dzieci”.

Filtrowanie treści reklam

Aplikacje mogą ustawiać maksymalną ocenę treści reklam w przypadku żądań reklamy za pomocą RequestConfiguration::max_ad_content_rating field. Reklamy AdMob zwracane po skonfigurowaniu tej opcji mają ocenę treści na tym poziomie lub niższym. Możliwe wartości są oparte na klasyfikacjach etykiet treści cyfrowych i muszą być jedną z tych wartości typu wyliczeniowego:

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ą zostać wysł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 aplikacja żąda 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();