Таргетинг

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

Для ознакомления с рабочим примером загрузите демонстрационное приложение Android API.

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

Предпосылки

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

ЗапросКонфигурации

RequestConfiguration собирает целевую информацию, применяемую глобально к каждому запросу рекламы. Доступные теги таргетинга см. в документации RequestConfiguration.Builder .

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

Котлин

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Ява

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

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

Детская направленность

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

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

Вы можете применить настройку, ориентированную на ребенка, с помощью setTagForChildDirectedTreatment() :

• Вызовите setTagForChildDirectedTreatment с TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE чтобы указать, что вы хотите, чтобы ваш контент рассматривался как предназначенный для детей в целях COPPA. Это предотвращает передачу рекламного идентификатора Android (AAID) .

• Вызовите setTagForChildDirectedTreatment с TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE чтобы указать, что вы не хотите, чтобы ваш контент считался предназначенным для детей в целях COPPA.

• Вызовите setTagForChildDirectedTreatment с TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED если вы не хотите указывать, как следует обрабатывать ваш контент с точки зрения COPPA в запросах объявлений.

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

Котлин

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Ява

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

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

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

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

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

Как и в случае с настройками, ориентированными на детей, в RequestConfiguration.Builder есть метод для установки параметра TFUA: setTagForUnderAgeOfConsent() со следующими параметрами.

• Вызовите setTagForUnderAgeOfConsent() с TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE чтобы указать, что вы хотите, чтобы запрос рекламы получил обработку для пользователей в Европейской экономической зоне (ЕЭЗ) младше возраста согласия. Это также предотвращает передачу рекламного идентификатора Android (AAID) .

• Вызовите setTagForUnderAgeOfConsent() с TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE чтобы указать, что вы хотите, чтобы запрос рекламы не обрабатывался для пользователей в Европейской экономической зоне (ЕЭЗ), не достигших возраста согласия.

• Вызовите setTagForUnderAgeOfConsent() с TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED чтобы указать, что вы не указали, следует ли обрабатывать запрос рекламы для пользователей в Европейской экономической зоне (ЕЭЗ), не достигших возраста согласия.

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

Котлин

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Ява

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Теги для включения настройки Child-directed и setTagForUnderAgeOfConsent() не должны одновременно быть установлены в true . Если это так, настройка child-directed имеет приоритет.

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

Чтобы соответствовать Политике Google Play в отношении ненадлежащей рекламы , которая включает в себя связанные с рекламой предложения, все объявления и связанные с ними предложения, показываемые в вашем приложении, должны соответствовать рейтингу контента вашего приложения, даже если сам контент в остальном соответствует политике Google Play.

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

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

• MAX_AD_CONTENT_RATING_G
• MAX_AD_CONTENT_RATING_PG
• MAX_AD_CONTENT_RATING_T
• MAX_AD_CONTENT_RATING_MA

Следующий код настраивает объект RequestConfiguration , чтобы указать, что возвращаемый рекламный контент должен соответствовать обозначению метки цифрового контента не выше G :

Котлин

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Ява

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Узнайте больше о:

• Установка максимального рейтинга контента для каждого рекламного запроса

• Установка максимального рейтинга рекламного контента для приложения или аккаунта

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

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

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

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

Котлин

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Ява

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

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

Запрос объявления

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

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

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

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

Котлин

val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest = AdRequest.Builder()
  .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
  .build()
adLoader.loadAd(adRequest)

Ява

Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
AdRequest adRequest = new AdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter.class, extras)
    .build();
adLoader.loadAd(adRequest);