Таргетинг

Выберите платформу: 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.
• Не указывайте значение tagForChildDirectedTreatment, если вы не хотите, чтобы контент обрабатывался с учетом требований COPPA.

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

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

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