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

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

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

Подготовка

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

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

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

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

  2. Задайте свойство customTargeting запроса объявления для этого объекта.

В примере ниже показано, как сегментировать пользователей по продолжительности сеанса в приложении.

Swift 

let daysInApp = 1

// Step 1: Create the key-value pair dictionary with custom targeting data.
let customTargeting: [String: String] = [
  "USER_DURATION": daysInApp < 3 ? "NEW" : "MATURE"
]

// Step 2: Create an ad request with custom targeting.
let request = GADRequest()
request.customTargeting = customTargeting

Objective-C 

int days_in_app = 1;

// Step 1: Create the key-value pair object with custom targeting data.
NSDictionary *customTargeting = @{
  @"USER_DURATION" : days_in_app < 3 ? @"NEW" : @"MATURE"
};

// Step 2: Create an ad request with custom targeting.
GADRequest *request = [GADRequest request];
request.customTargeting = customTargeting;

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

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

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

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