Таргетинг

Выберите платформу: Android iOS Unity Flutter

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

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

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

Предварительные требования

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

GADRequestConfiguration

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

Быстрый

let requestConfiguration = MobileAds.shared.requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

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

Установить возраст лечения

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

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

Установленный возраст ребенка для лечения

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

Быстрый

// Indicate that ad requests should have child age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .child

Objective-C

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

Лечение подростков

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

Быстрый

// Indicate that ad requests should have teenage treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .teen

Objective-C

// Indicate that ad requests should have teenage treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment = GADAgeRestrictedTreatmentTeen;

Не устанавливать конкретный возраст для лечения

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

Быстрый

// Indicate that ad requests should have unspecified age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .unspecified

Objective-C

// Indicate that ad requests should have unspecified age treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment = GADAgeRestrictedTreatmentUnspecified;

Переход от лечения TFCD и TFUA к лечению, ориентированному на возраст.

Параметр «Возрастная группа» заменяет устаревшие свойства tagForChildDirectedTreatment (TFCD) и tagForUnderAgeOfConsent (TFUA).

В следующей таблице показаны параметры tagForChildDirectedTreatment и tagForUnderAgeOfConsent , а также их эквиваленты для обработки по возрасту:

TFCD

tagForChildDirectedTreatment	омоложение
tagForChildDirectedTreatment = true	GADAgeRestrictedTreatmentChild
tagForChildDirectedTreatment = false	GADAgeRestrictedTreatmentUnspecified
Значение для tagForChildDirectedTreatment не присвоено	GADAgeRestrictedTreatmentUnspecified
Нет эквивалента	GADAgeRestrictedTreatmentTeen

TFUA

tagForUnderAgeOfConsent	омоложение
tagForUnderAgeOfConsent = true	GADAgeRestrictedTreatmentChild
tagForUnderAgeOfConsent = false	GADAgeRestrictedTreatmentUnspecified
Значение для tagForUnderAgeOfConsent не присвоено	GADAgeRestrictedTreatmentUnspecified
Нет эквивалента	GADAgeRestrictedTreatmentTeen

Понимание взаимодействия возрастных изменений в лечении с TFCD и TFUA

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

Примечание: Пользователи, вошедшие в учетные записи Google, управляемые через Family Link , автоматически получают весь контент, предназначенный для детей, при отправке всех рекламных запросов.

обстановка, ориентированная на ребенка

Предупреждение: свойство tagForChildDirectedTreatment устарело. Вместо него следует установить свойство ageRestrictedTreatment .

В соответствии с Законом о защите конфиденциальности детей в интернете (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.

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

Предупреждение: свойство tagForUnderAgeOfConsent устарело. Вместо него следует установить свойство ageRestrictedTreatment .

Вы можете пометить запросы на рекламу, требующие обработки данных от пользователей из Европейской экономической зоны (ЕЭЗ), не достигших возраста согласия. Эта функция призвана облегчить соблюдение Общего регламента по защите данных (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;

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

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

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

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

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

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

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

Быстрый

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

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

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

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

Быстрый

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

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

GADRequest

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

Добавить дополнительные сетевые функции

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

Следующий фрагмент кода устанавливает дополнительный параметр 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 = Request()
request.contentURL = "https://www.example.com"

Objective-C

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

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

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

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

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

См. раздел «Медиация» , чтобы узнать, как отправлять целевые сообщения в сети медиации.