Таргетинг

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

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

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

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

Предварительное условие

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

RequestConfiguration

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

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

Котлин 

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

Java 

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

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

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

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

Вы можете установить возрастные ограничения для лечения с помощью метода setAgeRestrictedTreatment() , используемого в API RequestConfiguration.Builder .

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

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

Java 

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
    // Indicate that ad requests should have child age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Котлин 

val requestConfiguration = MobileAds.getRequestConfiguration().toBuilder()
    // Indicate that ad requests should have child age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

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

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

Java 

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
    // Indicate that ad requests should have teen age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.TEEN)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Котлин 

val requestConfiguration = MobileAds.getRequestConfiguration().toBuilder()
    // Indicate that ad requests should have teen age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.TEEN)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

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

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

Java 

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
    // Indicate that ad requests should have unspecified age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.UNSPECIFIED)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Котлин 

val requestConfiguration = MobileAds.getRequestConfiguration().toBuilder()
    // Indicate that ad requests should have unspecified age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.UNSPECIFIED)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

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

Параметр «Возрастная принадлежность» заменяет устаревшие параметры .setTagForChildDirectedTreatment() (TFCD) и .setTagForUnderAgeOfConsent() (TFUA).

В следующей таблице показаны параметры TFCD и TFUA, а также их эквиваленты для разных возрастных групп:

TFCD

TFCD омоложение
TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE AgeRestrictedTreatment.CHILD
TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE AgeRestrictedTreatment.UNSPECIFIED
TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED AgeRestrictedTreatment.UNSPECIFIED
Значение не присвоено .setTagForChildDirectedTreatment() AgeRestrictedTreatment.UNSPECIFIED
Нет эквивалента AgeRestrictedTreatment.TEEN

TFUA

TFUA омоложение
TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE AgeRestrictedTreatment.CHILD
TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE AgeRestrictedTreatment.UNSPECIFIED
TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED AgeRestrictedTreatment.UNSPECIFIED
Значение не присвоено .setTagForUnderAgeOfConsent() AgeRestrictedTreatment.UNSPECIFIED
Нет эквивалента AgeRestrictedTreatment.TEEN

Понимание взаимодействия возрастных изменений в лечении с TFCD и TFUA

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

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

В соответствии с Законом о защите конфиденциальности детей в Интернете (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)

Java 

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)

Java 

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

Не следует одновременно устанавливать значение true для параметров "Управление по дочерним процессам" и setTagForUnderAgeOfConsent() . В противном случае приоритет имеет параметр "Управление по дочерним процессам".

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

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

Java 

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(
      RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED
    )
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java 

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

Запрос на рекламу

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

Добавить дополнительные сетевые функции

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

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

Котлин 

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

Java 

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