Kierowanie

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

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

Wymagania wstępne

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 uzyskaj bieżącą konfigurację, wykonaj niezbędne 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

Na potrzeby ustawy o ochronie prywatności dzieci w internecie (COPPA) dostępne jest ustawienie „tagowanie traktowania jako skierowanej do dzieci”. Umieszczając ten tag, poświadczasz, że to powiadomienie jest prawdziwe i że masz upoważnienie do działania w imieniu właściciela aplikacji. Rozumiesz, że naruszenie 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 chcesz, abyśmy traktowali Twoje treści jako skierowane do dzieci, wyłączamy w ich przypadku reklamy te dotyczące reklam opartych na zainteresowaniach i remarketingu.

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

  • Przypisz identyfikator RequestConfiguration::tag_for_child_directed_treatment do RequestConfiguration::kChildDirectedTreatmentTrue, by wskazać, że Twoje treści mają być traktowane jako skierowane do dzieci zgodnie z ustawą COPPA.
  • Aby wskazać, że nie chcesz, aby Twoje treści były traktowane jako skierowane do dzieci zgodnie z ustawą COPPA, ustaw wartość RequestConfiguration::tag_for_child_directed_treatment na RequestConfiguration::kChildDirectedTreatmentFalse.
  • Przypisz identyfikator RequestConfiguration::tag_for_child_directed_treatment do RequestConfiguration::kChildDirectedTreatmentUnspecified, jeśli nie chcesz, by Twoje treści były traktowane w związku z ustawą COPPA w żądaniach reklam.

Z przykładu poniżej wynika, ż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);

Umieszczając ten tag, poświadczasz, że to powiadomienie jest prawdziwe i że masz upoważnienie do działania w imieniu właściciela aplikacji. Rozumiesz, że naruszenie tego ustawienia może spowodować zamknięcie Twojego konta Google.

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 ś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 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żywasz tej funkcji, w żądaniu reklamy znajdzie się tag Użytkownicy, 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ń 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 żądaniu RequestConfiguration znajduje się element, który pozwala skonfigurować parametr TFUA: tag_for_under_age_of_consent, który można skonfigurować z tymi wartościami:

  • Przypisz identyfikator RequestConfiguration::tag_for_under_age_of_consent do RequestConfiguration::kUnderAgeOfConsentTrue, by wskazać, że chcesz, by żądanie reklamy było traktowane w przypadku użytkowników z Europejskiego Obszaru Gospodarczego (EOG), którzy nie osiągnęli wieku świadomego wyrażenia zgody.
  • Przypisz identyfikator RequestConfiguration::tag_for_under_age_of_consent do RequestConfiguration::kUnderAgeOfConsentFalse, aby wskazać, że żądanie reklamy nie ma być traktowane w przypadku użytkowników z Europejskiego Obszaru Gospodarczego (EOG), którzy nie osiągnęli wieku świadomego wyrażenia zgody.
  • Przypisz identyfikator RequestConfiguration::tag_for_under_age_of_consent do RequestConfiguration::kUnderAgeOfConsentUnspecified, aby wskazać, że nie chcesz, by żądanie reklamy było traktowane jako dotyczące użytkowników z Europejskiego Obszaru Gospodarczego (EOG), którzy nie osiągnęli wieku świadomego wyrażenia zgody.

Ten przykład wskazuje, że chcesz uwzględniać TFUA w żądaniach reklam:

  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 pozwalające włączyć ustawienie skierowane do dzieci oraz użytkownikom poniżej wieku świadomego wyrażenia zgody nie powinny być jednocześnie ustawione na wartość prawda. Jeśli tak, pierwszeństwo ma ustawienie skierowane do dzieci.

Filtrowanie treści reklamy

Aplikacje mogą ustawiać maksymalną ocenę treści reklam w przypadku swoich żądań reklamy w aplikacji RequestConfiguration::max_ad_content_rating field. Reklamy AdMob zwracane przy takiej konfiguracji mają ocenę treści równą lub niższą. Możliwe wartości są oparte na klasyfikacji etykiet treści cyfrowych. Musi to być jedna z tych wartości:

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

Ten kod konfiguruje strukturę RequestConfiguration, zgodnie z którą zwracana treść reklamy powinna mieć oznaczenie etykiety treści cyfrowych nie większe 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ć wysłane wraz z żądaniem reklamy.

URL treści

Wysyłając żądanie reklamy, aplikacje mogą przekazać adres URL wyświetlanych treści. Dzięki temu kierowanie na słowa kluczowe dopasuje reklamę do treści.

Jeśli na przykład aplikacja wysyła żądanie reklamy podczas wyświetlania treści z witryny https://www.example.com, możesz przekazać ten adres URL, aby ustawić kierowanie 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();