Kierowanie

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

Wymagania wstępne

RequestConfiguration

RequestConfiguration to struktura, która gromadzi informacje o kierowaniu, które mają być stosowane globalnie za pomocą funkcji globalnej SetRequestConfiguration().

Aby zaktualizować konfigurację żądania, najpierw uzyskaj bieżącą konfigurację, przeprowadź dowolne 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 jako skierowane do dzieci

Zgodnie z ustawą o ochronie prywatności dzieci w internecie (Children's Online Privacy Protection Act – COPPA) dostępne jest ustawienie o nazwie „tagowanie jako skierowane do dzieci”. Ustawiając ten tag, potwierdzasz, że to powiadomienie jest prawidłowe i że masz upoważnienie do działania w imieniu właściciela aplikacji. Przyjmujesz do wiadomości, ż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 zdecydujesz, że Google ma traktować treści w tej witrynie jako skierowane do dzieci, wyłączymy w tym żądaniu reklamy oparte na zainteresowaniach i reklamy remarketingowe.

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

  • Przypisz atrybut 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 atrybut 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 zgodnie z ustawą COPPA.
  • Przypisz właściwość RequestConfiguration::tag_for_child_directed_treatment do: RequestConfiguration::kChildDirectedTreatmentUnspecified, jeśli nie chcesz wskazywać, jak chcesz traktować treści w związku z ustawą COPPA w żądaniach reklam.

Ten przykład wskazuje, ż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);

Ustawiając ten tag, potwierdzasz, że to powiadomienie jest poprawne i że masz upoważnienie do działania w imieniu właściciela aplikacji. Przyjmujesz do wiadomości, że nadużywanie tego ustawienia może spowodować zamknięcie 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 ś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 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. Dowiedz się więcej o tym, jak RODO wpływa na działalność wydawców

Gdy używasz tej funkcji, w żądaniu reklamy znajdzie się tag dla użytkowników, którzy nie osiągnęli wieku świadomego wyrażenia zgody (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ń skierowanych do dzieci, element RequestConfiguration umożliwia skonfigurowanie parametru TFUA tag_for_under_age_of_consent, który można skonfigurować za pomocą tych wartości wyliczonych:

  • Przypisz wartość RequestConfiguration::tag_for_under_age_of_consent do RequestConfiguration::kUnderAgeOfConsentTrue, aby wskazać, że chcesz, aby żądanie reklamy było traktowane jako skierowane do użytkowników z Europejskiego Obszaru Gospodarczego (EOG), którzy nie osiągnęli wieku świadomego wyrażenia zgody.
  • Podaj wartość RequestConfiguration::tag_for_under_age_of_consent użytkownikowi RequestConfiguration::kUnderAgeOfConsentFalse, aby wskazać, że chcesz, aby żądanie reklamy nie było traktowane jako skierowane do użytkowników z Europejskiego Obszaru Gospodarczego (EOG), którzy nie osiągnęli wieku świadomego wyrażenia zgody.
  • Przypisz właściwość RequestConfiguration::tag_for_under_age_of_consent do RequestConfiguration::kUnderAgeOfConsentUnspecified, aby wskazać, że nie określisz, czy żądanie reklamy powinno być traktowane jako w przypadku 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 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 Aplikacja skierowana do dzieci i Użytkownicy, 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 skierowane do dzieci.

Filtrowanie treści reklamy

Aplikacje mogą ustawiać maksymalną ocenę treści reklam w odpowiedzi na żądania reklamy na stronie RequestConfiguration::max_ad_content_rating field. Wyświetlane reklamy AdMob mają ocenę treści na poziomie tego lub niższym. Możliwe wartości zależą od klasyfikacji treści cyfrowych i muszą być jedną z tych wartości:

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

Ten kod konfiguruje strukturę RequestConfiguration w celu określenia, że zwracana treść reklamy powinna odpowiadać oznaczeniem 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 są wysyłane w żądaniu reklamy.

URL treści

Po wysłaniu żądania reklamy aplikacje mogą przekazać adres URL wyświetlanej treści. Dzięki temu kierowanie na słowa kluczowe może dopasować reklamę do treści.

Jeśli np. Twoja aplikacja wysyła żądanie reklamy podczas wyświetlania treści z domeny https://www.example.com, możesz przekazać ten adres URL, by 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();