Таргетинг

Выберите платформу: Android iOS Unity Flutter Android (устаревшая версия)

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

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

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

Требования

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

GADRequestConfiguration

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

Swift

let requestConfiguration = MobileAds.shared.requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

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

Как настроить обработку с учетом возраста

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

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

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

Swift

// Indicates that ad requests should have child age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .child
RequestConfigurationSnippets.swift

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

• .teen
• .unspecified

Objective-C

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

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

• GADAgeRestrictedTreatmentTeen
• GADAgeRestrictedTreatmentUnspecified

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

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

Передача настроек обработки с учетом возраста при медиации AdMob

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

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

Название адаптера медиации	Минимальная поддерживаемая версия
AppLovin	13.6.3.0
BidMachine	3.6.1.1
Bigo	5.2.1.0
Chartboost	9.12.0.1
DTExchange (Fyber)	8.4.7.1
i-mobile	2.3.4.7
InMobi	11.2.0.1
IronSource	9.4.1.0.1
Liftoff Monetize (Vungle)	7.7.2.1
LY Ads (Line Ads)	3.0.1.1
maio	2.2.1.2
Meta (Facebook)	6.21.1.1
Mintegral	8.1.3.1
Moloco	4.6.1.1
MyTarget	5.43.0.0
Pangle	7.9.1.1.1
PubMatic	5.1.0.1
Verve	3.8.1.1

Настройка "Для детей"

Внимание! Свойство tagForChildDirectedTreatment больше не поддерживается. Вместо этого задайте свойство ageRestrictedTreatment.

В соответствии с законом США "О защите личных сведений детей в интернете" (COPPA) в Менеджере рекламы предусмотрена настройка tagForChildDirectedTreatment.

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

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

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

Swift

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.

Swift

MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

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

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

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

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

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

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

Важно! Настройки фильтра возрастных ограничений, заданные в SDK, переопределяют настройки, заданные в интерфейсе AdMob.

Swift

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

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

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

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

Swift

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

Примечание. Если в запросе объявления содержится несколько пользовательских сигналов конфиденциальности, приоритет будет иметь самый строгий из них. Примеры можно найти в документации по Publisher Privacy Treatment API.

GADRequest

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

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

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

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

Swift

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, чтобы настроить таргетинг на релевантные ключевые слова:

Swift

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.

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

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