Таргетинг


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

Требования

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::kChildDirectedTreatmentTrue значение RequestConfiguration::tag_for_child_directed_treatment, чтобы указать, что ваш контент предназначен для детей и должен обрабатываться в соответствии с законом 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();