Таргетинг

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

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

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

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

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

RequestConfiguration

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

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

Котлин 

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

Java 

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

Чтобы гарантировать применение изменений конфигурации запроса ко всем запросам рекламы, настройте конфигурацию запроса перед инициализацией Google 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)
RequestConfigurationSnippets.kt

Java 

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

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

Java 

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

Не следует одновременно устанавливать значение 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)
RequestConfigurationSnippets.kt

Java 

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

Java 

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

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

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

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

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

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

Java 

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

Настраиваемый таргетинг

Вы можете передавать пользовательские пары ключ-значение для таргетирования кампаний Google Ad Manager (позиций). В следующем примере в запросе объявления передается пользовательская пара ключ-значение:

Котлин 

// Example: Pass custom targeting "age=25".
val newRequest = AdManagerAdRequest.Builder().addCustomTargeting("age", "25").build()
AdRequestSnippets.kt

Java 

// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest =
    new AdManagerAdRequest.Builder().addCustomTargeting("age", "25").build();
AdRequestSnippets.java

В качестве ключа можно передать несколько значений в виде списка строк. Например, чтобы нацелиться на людей в возрасте около двадцати пяти лет, а не только на 25-летних.

Котлин 

.addCustomTargeting("age", listOf("24", "25", "26"))
AdRequestSnippets.kt

Java 

.addCustomTargeting("age", Arrays.asList("24", "25", "26"))
AdRequestSnippets.java

Ознакомьтесь с примером пользовательского таргетинга в Ad Manager, чтобы увидеть реализацию пользовательского таргетинга в демонстрационном приложении Android API.

Исключения из категорий

Добавить уровень исключения категорий на уровне слота к запросу можно с помощью метода addCategoryExclusion() :

Котлин 

// Example: Exclude "automobile" and "boat" categories.
val newRequest =
  AdManagerAdRequest.Builder()
    .addCategoryExclusion("automobile")
    .addCategoryExclusion("boat")
    .build()
AdRequestSnippets.kt

Java 

// Example: Exclude "automobile" and "boat" categories.
AdManagerAdRequest newRequest =
    new AdManagerAdRequest.Builder()
        .addCategoryExclusion("automobile")
        .addCategoryExclusion("boat")
        .build();
AdRequestSnippets.java

Для демонстрации возможности исключения категорий из рекламных кампаний в демонстрационном приложении Android API ознакомьтесь с примером использования исключений по категориям в Ad Manager .

Идентификаторы, предоставленные издателем

Вы можете установить идентификатор, предоставляемый издателем (PPID), для использования в ограничении частоты показа, сегментации и таргетинге аудитории, последовательной ротации объявлений и других элементах управления показом рекламы на основе аудитории на разных устройствах.

Вот пример установки PPID:

Котлин 

val adRequest = AdManagerAdRequest.Builder().setPublisherProvidedId("AB123456789").build()
AdRequestSnippets.kt

Java 

AdManagerAdRequest adRequest =
    new AdManagerAdRequest.Builder().setPublisherProvidedId("AB123456789").build();
AdRequestSnippets.java

Ознакомьтесь с примером использования идентификаторов, предоставляемых издателем (PPID), в демонстрационном приложении Android API в Ad Manager .

Сигналы, предоставленные издателем

Вы можете отправлять данные об аудитории и контекстные данные в виде сигналов, предоставляемых издателем (PPS), в запросах на показ рекламы. С помощью PPS вы можете использовать данные о пользователях для улучшения программной монетизации, передавая характеристики вашей аудитории участникам торгов во всех типах транзакций , используя стандартные таксономии, без необходимости делиться идентификаторами пользователей. Характеристики вашей аудитории могут включать поведенческие данные и данные об интересах ( IAB Audience Taxonomy 1.1 ), а также контекстные данные ( IAB Content Taxonomy 2.2 ).

Котлин 

val extras = Bundle()
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6, 284))
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4, 5, 6))

val request =
  AdManagerAdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()
AdRequestSnippets.kt

Java 

Bundle extras = new Bundle();
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", new ArrayList<>(Arrays.asList(6, 284)));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", new ArrayList<>(Arrays.asList(4, 5, 6)));

AdManagerAdRequest request =
    new AdManagerAdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();
AdRequestSnippets.java

URL содержимого

Для указания URL-адреса контента в целях целевой рекламы и обеспечения безопасности бренда добавьте следующее:

Котлин 

val builder = AdManagerAdRequest.Builder()
builder.setContentUrl("https://www.example.com")
val request = builder.build()
AdRequestSnippets.kt

Java 

AdManagerAdRequest.Builder builder = new AdManagerAdRequest.Builder();
builder.setContentUrl("https://www.example.com");
AdManagerAdRequest request = builder.build();
AdRequestSnippets.java

Безопасность бренда (бета-версия)

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

Котлин 

val urls =
  mutableListOf(
    "https://www.mycontenturl1.com",
    "https://www.mycontenturl2.com",
    "https://www.mycontenturl3.com",
    "https://www.mycontenturl4.com",
  )

val requestWithContent = AdManagerAdRequest.Builder().setNeighboringContentUrls(urls).build()
AdRequestSnippets.kt

Java 

List<String> urls =
    Arrays.asList(
        "https://www.mycontenturl1.com",
        "https://www.mycontenturl2.com",
        "https://www.mycontenturl3.com",
        "https://www.mycontenturl4.com");

AdManagerAdRequest requestWithContent =
    new AdManagerAdRequest.Builder().setNeighboringContentUrls(urls).build();
AdRequestSnippets.java

.setNeighboringContentUrls() отличается от .setContentUrl() тем, что используется исключительно для защиты бренда.