Таргетинг

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

Чтобы посмотреть, как работает таргетинг объявлений, скачайте демо-приложение iOS API на языке Swift или Objective-C.

Скачать демоверсию API

Требования

Прежде чем продолжить, настройте Google Mobile Ads SDK.

GADRequestConfiguration

GADRequestConfiguration – это объект, который собирает информацию о таргетинге, чтобы применять ее глобально через общий экземпляр GADMobileAds. Доступ к нему можно получить с помощью следующего кода:

let requestConfiguration = MobileAds.shared.requestConfiguration

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

Чтобы изменения в конфигурации запроса применялись ко всем запросам объявлений, задайте конфигурацию запроса перед инициализацией Google Mobile Ads SDK.

Как настроить обработку с учетом возраста

Чтобы вам было проще соблюдать действующие законы в отношении конфиденциальности детей и подростков, в Google Mobile Ads SDK предусмотрена настройка возрастных ограничений. Настройка обработки данных с учетом возраста позволяет указать, должен ли сервис "Google Mobile Ads SDK" применять специальные меры защиты при показе рекламы детям, подросткам или пользователям неизвестного возраста.

Вы можете задать возрастные ограничения с помощью свойства ageRestrictedTreatment в GADRequestConfiguration.

В примере ниже показано, как указать, что запросы объявлений должны обрабатываться с учетом возрастных ограничений для детей.

// Indicates that ad requests should have child age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .child
RequestConfigurationSnippets.swift

// Indicates that ad requests should have child age treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment =
    GADAgeRestrictedTreatmentChild;
RequestConfigurationSnippets.m

Если эта настройка включена, Google Mobile Ads SDK добавляет в запросы объявлений параметр tfat. Чтобы определить, какие настройки учета возраста подходят для ваших пользователей, проконсультируйтесь с юристом. Подробнее о том, как добавить в запрос объявления тег учета возраста…

Как перейти с тегов TFCD и TFUA на тег учета возраста

Настройка учета возраста заменяет собой устаревшие свойства tagForChildDirectedTreatment (TFCD) и tagForUnderAgeOfConsent (TFUA).

В таблице ниже приведены настройки tagForChildDirectedTreatment и tagForUnderAgeOfConsent и их эквиваленты для возрастных ограничений.

Как тег учета возраста взаимодействует с тегами TFCD и TFUA

Если вы зададите настройки учета возраста вместе с тегами TFCD или TFUA, Google применит наиболее строгие из этих настроек.

Передача настроек учета возраста при медиации

Если вы настроили обработку данных с учетом возраста с помощью Google Mobile Ads SDK, адаптеры медиации будут передавать сигнал об этом в сторонние SDK, используемые для медиации.

В таблице ниже перечислены версии адаптеров медиации, которые поддерживают передачу сигнала об ограничении по возрасту в сторонний SDK, используемый для медиации.

Настройка контента, предназначенного для детей

В соответствии с законом США "О защите личных сведений детей в интернете" (COPPA) в Менеджере рекламы предусмотрена настройка tagForChildDirectedTreatment.

Разработчик приложений может указать в запросе объявления, что контент приложения предназначен для детей. Если вы укажете, что ваш контент предназначен для детей, Google отключит рекламу на основе интересов и ремаркетинговые объявления для этого запроса объявления. Доступны следующие варианты:

• Установите для параметра tagForChildDirectedTreatment значение true, чтобы указать, что ваш контент предназначен для детей в соответствии с законом COPPA. Это предотвращает передачу рекламного идентификатора IDFA.
• Задайте для параметра tagForChildDirectedTreatment значение false, чтобы указать, что ваш контент не предназначен для детей в соответствии с законом COPPA.
• Если вы не хотите указывать, как ваш контент должен обрабатываться в соответствии с законом COPPA, не задавайте параметр tagForChildDirectedTreatment.

В следующем примере показано, как указать, что контент предназначен для детей в соответствии с законом COPPA:

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

Устанавливая этот тег, вы подтверждаете, что уведомление является точным и вы уполномочены действовать от имени владельца приложения. Вы понимаете, что злоупотребление этой настройкой может привести к блокировке вашего аккаунта Google.

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

В запросе объявления можно указать, что оно предназначено для пользователей из Европейской экономической зоны (ЕЭЗ), не достигших минимального возраста. Эта функция помогает соблюдать требования Генерального регламента ЕС о защите персональных данных (GDPR). Обратите внимание, что GDPR может налагать на вас и другие юридические обязательства. Изучите рекомендации Европейского союза и проконсультируйтесь с юристом. Напоминаем, что соблюдать законы обязаны сами издатели, а инструменты Google лишь помогают в этом. Подробнее о том, как GDPR влияет на деятельность издателей…

При использовании этой функции в запрос объявления будет включен параметр TFUA (тег ресурса для лиц, не достигших минимального возраста). Этот параметр отключает персонализированную рекламу, в том числе ремаркетинг, для этого конкретного запроса объявления. Он также отключает запросы сторонним поставщикам рекламных технологий, например пикселям оценки эффективности рекламы и сторонним серверам объявлений.

Эту настройку можно использовать со всеми версиями Google Mobile Ads SDK, задав свойство tagForUnderAgeOfConsent для объекта GADMobileAds.requestConfiguration и передав true.

• Задайте для параметра tagForUnderAgeOfConsent значение true, чтобы указать, что запросы объявлений должны обрабатываться в соответствии с требованиями для пользователей, не достигших минимального возраста. Это также предотвращает передачу рекламного идентификатора IDFA.
• Если параметр tagForUnderAgeOfConsent не задан, это означает, что вы не хотите, чтобы запросы объявлений обрабатывались в соответствии с требованиями для пользователей, не достигших минимального возраста.

В примере ниже показано, как добавить тег TFUA в запрос объявления:

MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

Не рекомендуем задавать значение true для тегов, которые позволяют помечать контент как предназначенный для детей, и тега tagForUnderAgeOfConsent одновременно, иначе приоритет будет иметь настройка контента, предназначенного для детей.

Фильтрация контента объявлений

В приложениях можно установить максимальные возрастные ограничения для рекламного контента на уровне запроса объявления с помощью свойства maxAdContentRating класса GADRequestConfiguration. Эта настройка применяется ко всем последующим запросам объявлений в рамках текущего сеанса. Возможные значения этого свойства основаны на классификации ярлыков цифрового контента и должны быть одной из следующих констант:

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

В приведенном ниже коде все запросы объявлений настроены так, чтобы в ответ на них возвращалось содержание объявления, соответствующее цифровому ярлыку контента не выше GADMaxAdContentRatingGeneral.

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

Условия конфиденциальности издателя (бета)

Publisher Privacy Treatment (PPT) API – это необязательный инструмент, который позволяет приложениям указывать, нужно ли отключать персонализацию рекламы для всех запросов объявлений, с помощью свойства publisherPrivacyPersonalizationState объекта GADRequestConfiguration. При использовании этой функции параметр PPT (вариант обеспечения конфиденциальности, выбранный издателем) добавляется во все последующие запросы объявлений до конца сеанса.

По умолчанию в ответ на запросы объявлений Google предлагает персонализированную рекламу. Следующий код отключает персонализацию рекламы для всех запросов объявлений:

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

GAMRequest

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

Добавьте дополнительную информацию от сети

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

В следующем фрагменте кода для Google задается дополнительный ключ параметра collapsible со значением bottom:

let request = Request()
let extras = Extras()
extras.additionalParameters = ["collapsible": "bottom"]
request.register(extras)
adLoader?.load(request)

GADRequest *request = [GADRequest request];
GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{@"collapsible": @"bottom"};
[request registerAdNetworkExtras:extras];
[self.adLoader loadRequest:request];

URL контента

При запросе объявления приложения могут передавать URL контента, который они показывают. Это позволяет использовать таргетинг по ключевым словам для сопоставления объявления с контентом.

Например, если приложение запрашивает объявление при показе контента с сайта https://www.example.com, вы можете передать этот URL, чтобы настроить таргетинг на релевантные ключевые слова:

let request = AdManagerRequest()
request.contentURL = "https://www.example.com"

GAMRequest *request = [GAMRequest request];
request.contentURL = @"https://www.example.com";

Таргетинг со специальными настройками

После того как вы настроите пары "ключ-значение" в интерфейсе Менеджера рекламы, задайте таргетинг со специальными настройками с помощью пар "ключ-значение" в запросе объявления. Позиции с таргетингом на эти пары ключ-значение могут выполнить показ по такому запросу объявления. Чтобы настроить таргетинг на несколько значений одного ключа, введите значения в виде строки, разделенной запятыми.

let request = AdManagerRequest()
request.customTargeting = ["gender" : "male", "section" : "health,fitness"];

GAMRequest *request = [GAMRequest request];
request.customTargeting = @{@"gender" : @"male", @"section" : @"health,fitness"};

Безопасность бренда (бета)

Приложения, в которых показывается динамический контент, предназначенный для разных аудиторий, могут передавать краткий список URL с помощью свойства neighboringContentURLs. URL соседнего контента отличаются от свойства contentURL тем, что используются только для обеспечения безопасности бренда.

Предположим, что в вашем приложении есть фид, в котором показывается контент с четырех URL и реклама. Вы можете запрашивать объявления с возрастными ограничениями, аналогичными ограничениям для этих URL, передавая их следующим образом:

let request = AdManagerRequest()
request.neighboringContentURLs =
    ["https://www.example1.com", "https://www.example2.com",
    "https://www.example3.com", "https://www.example4.com"]

GAMRequest *request = [GAMRequest request];
request.neighboringContentURLs =
    @[@"https://www.example1.com", @"https://www.example2.com",
    @"https://www.example3.com", @"https://www.example4.com"];

Идентификаторы, назначаемые издателем

Вы можете задать идентификатор, назначаемый издателем (PPID), который будет использоваться для ограничения частоты показов, сегментирования аудитории, таргетинга, последовательной ротации объявлений и других методов управления рекламой на разных устройствах.

Идентификатор PPID задается с помощью метода GAMRequest:

let request = AdManagerRequest()
request.publisherProvidedID = "AB123456789"

GAMRequest *request = [GAMRequest request];
request.publisherProvidedID = @"AB123456789";

Пример реализации идентификаторов, назначаемых издателем (PPID), в демонстрационном приложении iOS API Demo:

Swift Objective-C

Сигналы, предоставленные издателями

В запросах объявлений можно отправлять контекстные данные и данные об аудитории в виде сигналов, предоставленных издателем (PPS). С помощью PPS вы можете использовать пользовательские данные для повышения дохода от алгоритмических продаж, передавая характеристики аудитории участникам аукциона во всех типах транзакций с использованием стандартных таксономий, при этом не нужно предоставлять идентификаторы пользователей. Характеристики аудитории могут включать данные о поведении и интересах (классификация аудиторий IAB 1.1) и контекстные данные (классификация контента IAB 2.2).

let extras = Extras()
extras.additionalParameters = [
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    "IAB_AUDIENCE_1_1": [6, 284],
    // Set the content to sedan, station wagon and SUV automotive values.
    "IAB_CONTENT_2_2": [4, 5, 6]
]

let request = AdManagerRequest()
request.register(extras)

GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    @"IAB_AUDIENCE_1_1":@[@6, @284],
    // Set the content to sedan, station wagon and SUV automotive values.
    @"IAB_CONTENT_2_2":@[@4,@5,@6]
};

GAMRequest *request = [GAMRequest request];
[request registerAdNetworkExtras:extras];

Часто задаваемые вопросы

Какие настройки таргетинга используются при автоматическом обновлении объявления?

При обновлении объявления для таргетинга снова используется ранее указанный объект GAMRequest. Чтобы задать новые настройки таргетинга, вызовите loadRequest для GAMBannerView с новым объектом GAMRequest.

Как передавать дополнительные параметры таргетинга в сети медиации?

О том, как передавать параметры таргетинга в сети медиации, читайте в статье Медиация.