Таргетинг


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

Требования

RequestConfiguration

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

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

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

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

Настройка "Для детей"

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

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

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

  • Присвойте параметру RequestConfiguration::tag_for_child_directed_treatment значение RequestConfiguration::kChildDirectedTreatmentTrue, чтобы указать, что ваш контент предназначен для детей и должен обрабатываться в соответствии с законом COPPA.
  • Присвойте параметру RequestConfiguration::kChildDirectedTreatmentFalse значение RequestConfiguration::tag_for_child_directed_treatment, чтобы указать, что ваш контент не предназначен для детей в соответствии с законом 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::kUnderAgeOfConsentTrue значение RequestConfiguration::tag_for_under_age_of_consent, чтобы указать, что запрос объявления предназначен для пользователей из Европейской экономической зоны (ЕЭЗ), не достигших минимального возраста.
  • Присвойте параметру RequestConfiguration::tag_for_under_age_of_consent значение RequestConfiguration::kUnderAgeOfConsentFalse, чтобы указать, что запрос объявления не предназначен для пользователей из Европейской экономической зоны (ЕЭЗ), не достигших минимального возраста.
  • Присвойте параметру RequestConfiguration::tag_for_under_age_of_consent значение RequestConfiguration::kUnderAgeOfConsentUnspecified, чтобы указать, что вы не задали, должен ли запрос объявления подходить для пользователей из Европейской экономической зоны (ЕЭЗ), не достигших минимального возраста.

В примере ниже показано, как добавить тег 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();