Таргетинг

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

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

Загрузить демонстрационную версию API

Предпосылки

Заполните руководство по началу работы .

GADRequestConfiguration

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

Быстрый

let requestConfiguration = MobileAds.shared.requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

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

Детская направленность

В целях соблюдения Закона о защите конфиденциальности детей в Интернете (COPPA) существует параметр, называемый tagForChildDirectedTreatment .

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

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

Следующий пример показывает, что вы хотите, чтобы ваш контент рассматривался как предназначенный для детей в целях COPPA:

Быстрый

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

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

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

The tags to enable the child-directed setting and tagForUnderAgeOfConsent shouldn't both simultaneously be set to true . If they are, the child-directed setting takes precedence.

Ключевой момент: этот параметр tagForUnderAgeOfConsent не пересылается адаптерам медиации для сторонних источников рекламы. Вы несете ответственность за то, чтобы каждая сторонняя рекламная сеть в вашем приложении показывала рекламу, подходящую для пользователей, не достигших возраста согласия, согласно GDPR.

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

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

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

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

Ключевой момент: настройки фильтра рейтинга контента, указанные через SDK, переопределяют любые настройки, настроенные с помощью пользовательского интерфейса Менеджера объявлений.

Быстрый

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

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

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

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

Быстрый

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

Примечание: Для запросов на рекламу с несколькими сигналами конфиденциальности пользователя приоритет будет иметь наиболее ограничительный сигнал. Конкретные примеры см. в документации API обработки конфиденциальности издателя .

GAMЗапрос

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

Добавить сетевые дополнения

Сетевые дополнения — это дополнительные сведения, отправляемые вместе с запросом на рекламу и относящиеся к одному источнику рекламы.

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

Быстрый

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

Objective-C

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"

Objective-C

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

Индивидуальный таргетинг

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

Быстрый

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

Objective-C

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

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

Apps that display dynamic content intended for varying audiences can provide a short list of URLs through the neighboringContentURLs property. Neighboring content URLs differ from the contentURL property in that they are only used for brand safety.

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

Быстрый

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

Objective-C

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

Ключевой момент: SDK использует только первые четыре URL-адреса. Все остальные игнорируются.

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

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

Примечание: эта функция доступна не всем издателям. Подробнее см. в разделе О предоставленных издателем идентификаторах .

Настройка PPID выполняется через GAMRequest :

Быстрый

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

Objective-C

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

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

Swift Objective-C

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

Вы можете отправлять данные об аудитории и контекстные данные в качестве сигналов, предоставляемых издателем (PPS) в запросах на рекламу. С помощью PPS вы можете использовать данные о пользователях для улучшения программной монетизации, сообщая характеристики своей аудитории участникам торгов во всех типах транзакций , используя стандартные таксономии, без необходимости делиться идентификаторами пользователей. Характеристики вашей аудитории могут включать поведенческие и основанные на интересах данные ( IAB Audience Taxonomy 1.1 ) и контекстные данные ( IAB Content Taxonomy 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)

Objective-C

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

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

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

On ad refresh, the previously specified GAMRequest object is used for targeting again. To set new targeting, explicitly call loadRequest on GAMBannerView with a new GAMRequest object.

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

См. раздел Посредничество , чтобы узнать, как отправлять таргетинг в посреднические сети.