Таргетинг


В этом руководстве рассказывается, как передавать информацию о таргетинге в запросе объявления.

Требования

RequestConfiguration

RequestConfiguration – это структура, которая собирает информацию о таргетинге, чтобы применять ее глобально с помощью глобальной функции SetRequestConfiguration().

Чтобы изменить конфигурацию запроса, сначала получите текущую конфигурацию, внесите нужные изменения и задайте ее следующим образом:

  firebase::gma::RequestConfiguration retrieved_configuration =
    firebase::gma::GetRequestConfiguration();

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

Настройка контента, предназначенного для детей

В соответствии с законом США "О защите личных сведений детей в интернете" (COPPA) в Менеджере рекламы предусмотрен тег ресурса для детей. Устанавливая этот тег, вы подтверждаете, что уведомление содержит точные сведения и вы уполномочены действовать от имени владельца приложения. Вы понимаете, что злоупотребление этой функцией может привести к блокировке вашего аккаунта Google.

Разработчик приложений может указать в запросе объявления, что контент приложения предназначен для детей. Если вы укажете, что ваш контент предназначен для детей, мы отключим рекламу на основе интересов и ремаркетинговые объявления для этого запроса объявления.

Чтобы задать настройку, присвойте элементу tag_for_child_directed_treatment структуры RequestConfiguration одно из следующих перечисляемых значений:

  • Присвойте параметру RequestConfiguration::tag_for_child_directed_treatment значение RequestConfiguration::kChildDirectedTreatmentTrue, чтобы указать, что ваш контент предназначен для детей и должен обрабатываться в соответствии с законом COPPA.
  • Присвойте параметру RequestConfiguration::tag_for_child_directed_treatment значение RequestConfiguration::kChildDirectedTreatmentFalse, чтобы указать, что ваш контент не предназначен для детей в соответствии с законом COPPA.
  • Если вы не хотите указывать в запросах объявлений, как следует обрабатывать ваш контент в соответствии с законом COPPA, присвойте параметру RequestConfiguration::tag_for_child_directed_treatment значение RequestConfiguration::kChildDirectedTreatmentUnspecified.

В примере ниже показано, как указать, что контент предназначен для детей в соответствии с законом COPPA:

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.tag_for_child_directed_treatment =
    firebase::RequestConfiguration::kChildDirectedTreatmentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

Устанавливая этот тег, вы подтверждаете, что уведомление является точным и вы уполномочены действовать от имени владельца приложения. Вы понимаете, что злоупотребление этой настройкой может привести к блокировке вашего аккаунта Google.

Вы можете указать в запросе объявления, что оно предназначено для пользователей из Европейской экономической зоны (ЕЭЗ), не достигших минимального возраста. Эта функция помогает соблюдать требования Генерального регламента ЕС о защите персональных данных (GDPR). Обратите внимание, что у вас могут быть и другие юридические обязательства в соответствии с GDPR. Изучите рекомендации Европейского союза и проконсультируйтесь с юристом. Напоминаем, что соблюдать законы обязаны сами издатели, а инструменты Google лишь помогают в этом. Подробнее о влиянии GDPR на работу издателей…

При использовании этой функции в запрос объявления добавляется параметр TFUA (тег для пользователей, не достигших минимального возраста). Этот параметр отключает функции персонализированной рекламы (в том числе ремаркетинг) для всех запросов объявлений. Он также отключает запросы сторонним поставщикам рекламных технологий, например пикселям оценки эффективности рекламы и сторонним серверам объявлений.

Как и в случае с настройками для контента, предназначенного для детей, в RequestConfiguration есть элемент для настройки параметра TFUA: tag_for_under_age_of_consent. Для него можно задать следующие перечисляемые значения:

  • Присвойте параметру RequestConfiguration::tag_for_under_age_of_consent значение RequestConfiguration::kUnderAgeOfConsentTrue, чтобы указать, что запрос объявления предназначен для пользователей из Европейской экономической зоны (ЕЭЗ), не достигших минимального возраста.
  • Присвойте параметру RequestConfiguration::tag_for_under_age_of_consent значение RequestConfiguration::kUnderAgeOfConsentFalse, чтобы указать, что запрос объявления не предназначен для пользователей из Европейской экономической зоны (ЕЭЗ), не достигших минимального возраста.
  • Присвойте параметру RequestConfiguration::kUnderAgeOfConsentUnspecified значение RequestConfiguration::tag_for_under_age_of_consent, чтобы указать, что вы не задали, должно ли объявление подходить для пользователей из Европейской экономической зоны (ЕЭЗ), не достигших возраста согласия.

В примере ниже показано, как добавить тег TFUA в запросы объявлений.

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.tag_for_under_age_of_consent =
    firebase::RequestConfiguration::kUnderAgeOfConsentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

Не рекомендуем задавать значение true для тегов "Контент для детей" и "Пользователи, не достигшие минимального возраста" одновременно, иначе настройки для контента, предназначенного для детей, будут иметь приоритет.

Фильтрация контента объявлений

В приложениях можно задать максимальные возрастные ограничения для рекламного контента в запросах объявлений с помощью метода RequestConfiguration::max_ad_content_rating field. В этом случае в AdMob будут возвращаться объявления, возрастные ограничения для которых не превышают заданный уровень. Возможные значения основаны на классификации ярлыков цифрового контента и должны быть одним из следующих перечисляемых значений:

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

В следующем коде настраивается структура RequestConfiguration, чтобы указать, что возвращаемый контент объявления должен соответствовать ярлыку цифрового контента не выше G:

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.max_ad_content_rating =
    firebase::RequestConfiguration::kMaxAdContentRatingG;

  firebase::gma::SetRequestConfiguration(request_configuration);

AdRequest

Объект AdRequest собирает информацию о таргетинге, которая будет отправлена вместе с запросом объявления.

URL контента

При запросе объявления приложения могут передавать URL контента, который они показывают. Это позволяет использовать таргетинг по ключевым словам для сопоставления объявления с контентом.

Например, если приложение запрашивает объявление при показе контента с сайта https://www.example.com, вы можете передать этот URL, чтобы настроить таргетинг на релевантные ключевые слова:

  // AdRequest with content URL:
  firebase::admob::AdRequest ad_request(/*content_url=*/"https://www.example.com");

  // AdRequest without content URL:
  firebase::admob::AdRequest ad_request();