Таргетинг

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

Предпосылки

• Полное Начало работы .

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.

Примечание. Для приложений, участвующих в программе « Разработано для всей семьи» как предназначенных в первую очередь для детей, и для пользователей, вошедших в учетные записи Google, управляемые с помощью Family Link , весь контент автоматически рассматривается как предназначенный для детей во всех запросах объявлений.

Пользователи, не достигшие возраста согласия

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

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

Фильтрация содержания рекламы

Приложения могут устанавливать максимальный рейтинг рекламного контента для своих рекламных запросов с помощью 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();