Таргетинг

This guide explains how to provide targeting information to the Google Mobile Ads SDK.

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

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

Before you continue, set up Google Mobile Ads SDK (Legacy) .

RequestConfiguration

RequestConfiguration collects targeting information applied globally to every ad request. For available targeting tags, refer to the RequestConfiguration.Builder documentation.

To update the request configuration, obtain a builder from the existing configuration, perform any selected updates, and set it as follows:

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

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

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

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

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

You can set age treatment with the setAgeRestrictedTreatment() method with the RequestConfiguration.Builder API.

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

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

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

To indicate teen or an unspecified age treatment, replace the CHILD setting with the following:

• TEEN
• UNSPECIFIED

При использовании этой настройки Google Mobile Ads SDK (Legacy) включает параметр tfat в запросы на показ рекламы. Проконсультируйтесь с юристом, чтобы определить применимые возрастные ограничения для ваших пользователей в соответствии с вашими юридическими и нормативными обязательствами. Для получения дополнительной информации см. раздел «Пометка запроса на показ рекламы из приложения для возрастных ограничений» .

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

The age treatment setting replaces the deprecated .setTagForChildDirectedTreatment() (TFCD) and .setTagForUnderAgeOfConsent() (TFUA) settings.

The following table shows the TFCD and TFUA settings and their age treatment equivalents:

Understand age treatment interactions with TFCD and TFUA

If you set age treatment setting and TFCD or TFUA settings, Google applies the most conservative treatment.

Лечение старения с помощью AdMob Mediation

Если вы настраиваете обработку возрастных ограничений с помощью Google Mobile Ads SDK (Legacy) , адаптеры медиации пересылают сигнал обработки возрастных ограничений в сторонние SDK, используемые для медиации.

The following table lists the mediation adapter versions that support forwarding the age-restricted treatment signal to the mediated third-party SDK:

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

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

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

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

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

• Call setTagForChildDirectedTreatment with TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE to indicate that you don't want your content treated as child-directed for purposes of COPPA.

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

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

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

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

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

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

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

Like child-directed settings, there is a method in RequestConfiguration.Builder for setting the TFUA parameter: setTagForUnderAgeOfConsent() , with the following options.

• Вызовите 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)
RequestConfigurationSnippets.kt

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

The tags to enable the Child-directed setting and setTagForUnderAgeOfConsent() shouldn't both simultaneously be set to true . If they are, the child-directed setting takes precedence.

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

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

The following code configures an RequestConfiguration object to specify that ad content returned should correspond to a digital content label designation no higher than G :

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

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

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

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

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

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

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

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

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

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

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

Объект 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)
AdRequestSnippets.kt

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