Таргетинг

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

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

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

Предпосылки

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

GADRequestConfiguration

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

let requestConfiguration = MobileAds.shared.requestConfiguration

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

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

Детская среда

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

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

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

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

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

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

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

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

GAMRequest

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

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

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

Следующий фрагмент кода задает дополнительный параметр key 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";

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

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 .

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

Информацию о том, как направлять таргетинг в посреднические сети, см. в разделе Посредничество .