Таргетинг

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

Чтобы посмотреть, как работает таргетинг объявлений, скачайте демонстрационное приложение 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.
• Не указывайте значение tagForChildDirectedTreatment, если вы не хотите, чтобы контент обрабатывался с учетом требований COPPA.

В следующем примере показано, что вы хотите, чтобы ваш контент считался предназначенным для детей в соответствии с 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;

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

Фильтрация рекламного контента

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

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

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

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

Publisher Privacy Treatment (бета-версия)

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

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

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

GAMRequest

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

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

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

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

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

В демонстрационном приложении для iOS API можно посмотреть, как реализованы идентификаторы, назначаемые издателем (PPID) в Менеджере рекламы:

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.

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

Подробнее о том, как передавать параметры таргетинга сетям медиации…