Таргетинг

УСТАРЕЛО: SDK Google Mobile Ads C++ устарел с 17 июня 2024 г., и его не следует использовать в проектах, в которых он еще не используется. Окончание обслуживания (EoM) произойдет 17 июня 2025 г. Обратите внимание, что версии SDK, выпущенные до даты EoM, продолжат функционировать, но после даты EoM не будут выпущены никакие дальнейшие исправления ошибок или изменения.

Вместо SDK Google Mobile Ads C++ рассмотрите возможность использования SDK для iOS и Android от AdMob. За поддержкой обращайтесь на технический форум Google Mobile Ads SDK .

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

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

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

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

Теги, включающие настройку «Дети» и «Пользователи младше возраста согласия», не должны одновременно иметь значение 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();