Таргетинг

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

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

Предпосылки

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

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

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

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

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

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

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

Детская среда

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

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

Вы можете применить настройку, ориентированную на детей, с помощью 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);

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

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

Теги, включающие параметр «Управление дочерним элементом» и setTagForUnderAgeOfConsent() не должны одновременно иметь значение true . Если да, то настройка, ориентированная на детей, имеет приоритет.

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

Чтобы соответствовать Политике 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);

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

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

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

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

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);

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

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

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

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

Следующий фрагмент кода устанавливает дополнительный ключ параметра 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);