Таргетинг


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

Требования

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.
  • Присвойте параметру RequestConfiguration::tag_for_child_directed_treatment значение RequestConfiguration::kChildDirectedTreatmentUnspecified, если вы не хотите указывать в запросах объявлений, как следует обрабатывать ваш контент в соответствии с законом США "О защите личных сведений детей в интернете" (COPPA).

В следующем примере показано, что вы хотите, чтобы ваш контент считался предназначенным для детей в соответствии с 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::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 настраивается так, чтобы возвращаемый рекламный контент соответствовал ярлыку цифрового контента не выше категории "Для всех":

  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();