Таргетинг


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

Предпосылки

RequestConfiguration

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

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

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

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

Детская среда

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

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