Таргетинг

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

This guide explains how to provide targeting information to an ad request.

To see ad targeting in action, download the iOS API Demo app in Swift or Objective-C.

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

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

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

GADRequestConfiguration

GADRequestConfiguration is an object that collects targeting information to be applied globally through the GADMobileAds shared instance. It can be accessed with the following code:

Быстрый

let requestConfiguration = MobileAds.shared.requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

To ensure that all ad requests apply the request configuration changes, set the request configuration before you Initialize Google Mobile Ads SDK .

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

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

You can set age treatment with the ageRestrictedTreatment property on GADRequestConfiguration .

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

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

Быстрый

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

Objective-C

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

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

The following example indicates that ad requests should receive teenage treatment:

Быстрый

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

Objective-C

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

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

The following example indicates that ad requests should receive no specific age treatment:

Быстрый

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

Objective-C

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

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

The age treatment setting replaces the deprecated tagForChildDirectedTreatment (TFCD) and tagForUnderAgeOfConsent (TFUA) properties.

The following table shows the tagForChildDirectedTreatment and tagForUnderAgeOfConsent settings and their age treatment equivalents:

TFCD

tagForChildDirectedTreatment	омоложение
tagForChildDirectedTreatment = true	GADAgeRestrictedTreatmentChild
tagForChildDirectedTreatment = false	GADAgeRestrictedTreatmentUnspecified
No value assigned to tagForChildDirectedTreatment	GADAgeRestrictedTreatmentUnspecified
Нет эквивалента	GADAgeRestrictedTreatmentTeen

TFUA

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

Understand age treatment interactions with TFCD and TFUA

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

Note: Users signed into Google Accounts managed with Family Link automatically have all content treated as child-directed for all ad requests.

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

Warning: The tagForChildDirectedTreatment property is deprecated. Instead, set the ageRestrictedTreatment property.

For purposes of the Children's Online Privacy Protection Act (COPPA) , there is a setting called tagForChildDirectedTreatment .

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

• Установите для tagForChildDirectedTreatment значение true , чтобы указать, что вы хотите, чтобы ваш контент обрабатывался как предназначенный для детей в соответствии с законом COPPA. Это предотвратит передачу рекламного идентификатора IDFA.
• Set tagForChildDirectedTreatment to false to indicate that you don't want your content treated as child-directed for purposes of COPPA.
• Don't set tagForChildDirectedTreatment if you don't want to indicate how you would like your content treated with respect to COPPA.

The following example indicates that you want your content to be treated as child-directed for purposes of COPPA:

Быстрый

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

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

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

Warning: The tagForUnderAgeOfConsent property is deprecated. Instead, set the ageRestrictedTreatment property.

Вы можете пометить запросы на рекламу, требующие обработки данных от пользователей из Европейской экономической зоны (ЕЭЗ), не достигших возраста согласия. Эта функция призвана облегчить соблюдение Общего регламента по защите данных (GDPR) . Обратите внимание, что у вас могут быть и другие юридические обязательства в соответствии с GDPR. Ознакомьтесь с рекомендациями Европейского союза и проконсультируйтесь со своим юристом. Обратите внимание, что инструменты Google предназначены для облегчения соблюдения требований и не освобождают ни одного конкретного издателя от его обязательств в соответствии с законом. Узнайте больше о том, как GDPR влияет на издателей .

При использовании этой функции во все будущие запросы на показ рекламы будет добавляться параметр «Тег для пользователей младше возраста согласия в Европе» (TFUA). Этот параметр отключает персонализированную рекламу, включая ремаркетинг, для данного конкретного запроса. Он также отключает запросы к сторонним поставщикам рекламы, таким как пиксели измерения эффективности рекламы и сторонние рекламные серверы.

The setting can be used with all versions of Google Mobile Ads SDK by setting the tagForUnderAgeOfConsent property on the GADMobileAds.requestConfiguration object and passing in true .

• Установите для tagForUnderAgeOfConsent значение true , чтобы указать, что вы хотите, чтобы запросы на рекламу обрабатывались способом, подходящим для пользователей младше возраста согласия. Это также предотвратит передачу рекламного идентификатора (IDFA).
• Not setting tagForUnderAgeOfConsent indicates that you don't want ad requests to be handled in a manner suitable for users under the age of consent.

The following example indicates that you want TFUA included in your ad request:

Быстрый

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

The following code configures all ad requests to specify that ad content returned should correspond to a Digital Content Label designation no higher than 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) включается во все будущие запросы рекламы до конца сессии.

By default, ad requests to Google are served personalized ads. The following code turns off ads personalization for all ad requests:

Быстрый

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

For example, if your app is requesting an ad while showing content from https://www.example.com , you can pass this URL to target relevant keywords:

Быстрый

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 .

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

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