Таргетинг


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

Предварительные требования

RequestConfiguration

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

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

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

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

обстановка, ориентированная на ребенка

В соответствии с Законом о защите конфиденциальности детей в Интернете (COPPA) существует настройка под названием «тег для обработки данных, предназначенных для детей». Установив этот тег, вы подтверждаете, что данное уведомление является точным и что вы уполномочены действовать от имени владельца приложения. Вы понимаете, что злоупотребление этой настройкой может привести к закрытию вашей учетной записи Google.

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

Этот параметр можно настроить, присвоив члену 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 , указывая, что возвращаемый рекламный контент должен соответствовать обозначению метки цифрового контента не выше 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();