Как реализовать сегментирование по парам "ключ-значение"

Сегментирование на основе пар "ключ-значение" позволяет определить таргетинг со специальными настройками для сегментирования пользователей с помощью запроса объявления. Подробную информацию о сегментировании на основе пар "ключ-значение", в том числе о том, как добавить пару "ключ-значение" в интерфейсе AdMob, можно найти в статье Как добавить сегментирование "ключ-значение" в группу медиации.

На этой странице рассказывается, как реализовать сегментирование по парам "ключ-значение" при настройке запроса объявления с помощью Google Mobile Ads SDK для Android.

Подготовка

Чтобы настроить сегментирование "ключ-значение" в приложении, сначала добавьте его в группу медиации.

Как прикрепить пары "ключ-значение" к запросу объявления

После того как вы настроите собственные пары "ключ-значение" в интерфейсе AdMob, добавьте их в запрос объявления в приложении.

Чтобы прикрепить пары "ключ-значение" к запросу объявления, вызовите функцию putCustomTargeting() с ключом и значением.

В следующем примере сегментируются пользователи по длительности сеанса в приложении:

Kotlin

val daysInApp = 1
val request = AdRequest.Builder("AD_UNIT_ID")
  .putCustomTargeting("USER_DURATION", if (daysInApp < 3) "NEW" else "MATURE")
  .build()

Java

int daysInApp = 1;
AdRequest request = new AdRequest.Builder("AD_UNIT_ID")
    .putCustomTargeting("USER_DURATION", (daysInApp < 3) ? "NEW" : "MATURE")
    .build();

Как проверить настройки сегментирования по паре "ключ-значение"

Чтобы проверить реализацию на собственных парах "ключ-значение", отправьте запрос объявления и проверьте объект response info. Убедитесь, что значение поля mediation_group_name соответствует названию группы медиации.

В примере ниже показано, как проверить название группы медиации в ответе на запрос объявления:

{
  "Response ID": "r6_DZtitA8Gi2OMPyKeksAI",
  ...
  "Response Extras": {
    "mediation_group_name": "Mediation group for new users"
  }
}