Таргетинг

В этом руководстве объясняется, как предоставить информацию о таргетинге в запросе объявления. В качестве рабочего примера загрузите демонстрационное приложение Android API.

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

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

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

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

RequestConfiguration – это объект, который собирает информацию о таргетинге, которая будет применяться глобально с помощью статического метода MobileAds .

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

Джава

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

Котлин

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

Настройка, ориентированная на детей

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

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

Этот параметр можно использовать со всеми версиями SDK сервисов Google Play через RequestConfiguration.Builder.setTagForChildDirectedTreatment(int) :

• Вызовите 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:

Джава

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

Котлин

var 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 в ваши запросы объявлений:

Джава

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

Котлин

var 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 :

Джава

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

Котлин

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

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

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

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

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

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

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

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

Джава

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

Котлин

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

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

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

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

Пользовательский таргетинг

Вы можете передать специальные пары «ключ-значение» для таргетинга кампаний Google Ad Manager (позиций) через AdManagerAdRequest.Builder.addCustomTargeting() :

Джава

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

Котлин

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

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

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

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

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

Вы можете добавить в запрос уровень исключения категории на уровне рекламного места, используя метод addCategoryExclusion() , предоставляемый AdManagerAdRequest.Builder :

Джава

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

Котлин

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

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

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

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

Примечание. Эта функция доступна не всем издателям. Подробную информацию см. в разделе «Об идентификаторах, предоставленных издателем» .

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

Джава

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

Котлин

var adRequest = AdManagerAdRequest.Builder()
  .setPublisherProvidedId("AB123456789")
  .build()

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

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

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

Джава

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", arrayListOf(6,284));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6));

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

Котлин

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 = AdRequest.Builder()
  .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
  .build()

URL-адрес контента

Чтобы предоставить URL-адрес контента для объявлений с таргетингом на контент и безопасности бренда, вы можете вызвать setContentUrl() при создании AdManagerAdRequest :

Джава

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

Котлин

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

Безопасность бренда (бета)

Примечание. URL-адрес с несколькими контентами находится на стадии закрытого бета-тестирования для избранной группы издателей.

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

Джава

ArrayList<String> urls = new ArrayList<String>();
urls.add("https://www.mycontenturl1.com");
urls.add("https://www.mycontenturl2.com");
urls.add("https://www.mycontenturl3.com");
urls.add("https://www.mycontenturl4.com");
AdManagerAdRequest requestWithContent = new AdManagerAdRequest.Builder()
    .setNeighboringContentUrls(urls)
    .build();

Котлин

var urls = mutableListOf("https://www.mycontenturl1.com", "https://www.mycontenturl2.com",
                         "https://www.mycontenturl3.com", "https://www.mycontenturl4.com")
var requestWithContent = AdManagerAdRequest.Builder()
  .setNeighboringContentUrls(urls)
  .build()

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

Примечание. setNeighboringContentUrls использует только первые четыре URL-адреса в списке. Остальные игнорируются.