Таргетинг

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

Чтобы посмотреть, как работает таргетинг объявлений, скачайте демо-приложение 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 API – это необязательный инструмент, который позволяет приложениям указывать, нужно ли отключать персонализацию рекламы для всех запросов объявлений. Для этого используется свойство publisherPrivacyPersonalizationState класса GADRequestConfiguration. При использовании этой функции параметр PPT (Publisher Privacy Treatment) добавляется во все последующие запросы объявлений до конца сеанса.

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

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

Сбор данных о приблизительном местоположении

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

Начиная с версии 13.12.0 Google Mobile Ads SDK сбор данных о приблизительном местоположении включен по умолчанию. Сбор данных о приблизительном местоположении можно отключить с помощью свойства coarseLocationCollectionEnabled.

В примере ниже показано, как отключить сбор данных о приблизительном местоположении.

// Disables automatic coarse location collection by the SDK.
MobileAds.shared.requestConfiguration.coarseLocationCollectionEnabled = false
RequestConfigurationSnippets.swift

// Disables automatic coarse location collection by the SDK.
GADMobileAds.sharedInstance.requestConfiguration.coarseLocationCollectionEnabled = NO;
RequestConfigurationSnippets.m

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:

Swift Objective-C

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

В запросах объявлений можно отправлять контекстные данные и данные об аудитории в виде сигналов, предоставленных издателем (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.

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

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