Узнайте о специально подобранных пакетах услуг.

Ресурс curators.curatedPackages позволяет программно создавать и управлять пакетами рекламного инвентаря издателей, которые вы формируете от имени медиапланеров.

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

Понимание ключевых понятий

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

Контролируйте доступ к вашим тщательно подобранным пакетам услуг.

Ваши тщательно подобранные пакеты доступны только медиапланерам, которым вы явно предоставили доступ с помощью поля CuratedPackage.accessSettings . Поле accessSettings необходимо заполнить при создании тщательно подобранного пакета.

Вы можете использовать метод mediaPlanners.list для просмотра списка медиапланеров, которые могут быть указаны в поле CuratedPackage.accessSettings.allowlistedMediaPlanners .

Настройте целевой каталог для вашего подобранного пакета.

Поле CuratedPackage.targeting позволяет указать целевую аудиторию для вашего подобранного пакета. Поле targeting заполняется объектом PackageTargeting , который поддерживает такие критерии таргетинга, как тип устройства, формат креатива и географическое местоположение.

Вы также можете указать индивидуальные параметры таргетинга с помощью поля CuratedPackage.targeting.includedDataSegments . Поле includedDataSegments позволяет нацеливать данные на сегменты, которыми управляете вы или другие партнеры по курированию.

Понимание логики наведения на цель

Значения в повторяющихся полях обрабатываются с помощью логического OR , что означает, что показ, соответствующий любому из указанных значений, считается совпадением. Каждое поле обрабатывается с помощью логического AND , что означает, что все указанные поля должны соответствовать данному показу, чтобы подобранный пакет появился в соответствующем запросе на ставку.

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

{
  "includedDeviceTypes": [
    "DEVICE_TYPE_PHONE",
    "DEVICE_TYPE_PERSONAL_COMPUTER"
  ],
  "includedDataSegments": [
    "curators/123456/dataSegments/8765",
    "curators/123456/dataSegments/8172"
  ]
}

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

Тип устройства Идентификаторы сегментов данных Целевая аудитория подобранного пакета?
DEVICE_TYPE_PERSONAL_COMPUTER 8765 , 8172 Да
DEVICE_TYPE_PHONE 8172 , 4321 Да
DEVICE_TYPE_PHONE 9182 Нет
DEVICE_TYPE_CONNECTED_TV 4321 , 9182 Нет

Укажите ценность вашего специально подобранного пакета услуг.

При создании пакета показов необходимо задать размер платы за курирование с помощью поля объединения CuratedPackage.fee , при этом можно указать только один из типов платы, поддерживаемых объектом CuratedPackage , например, поле feeCpm . Общая плата за курирование для данного показа представляет собой сумму платы за пакет показов и платы за любые целевые сегменты данных, применимые к этому показу.

Вы также можете указать ценность показов, на которые ориентирован ваш подобранный пакет, задав значение в поле CuratedPackage.floorPriceCpm , которое может влиять на минимальную цену, указанную участникам торгов в режиме реального времени. Минимальная цена, отправляемая участникам торгов, представляет собой большее значение при сравнении минимальной цены, указанной вами в поле floorPriceCpm , с суммой минимальной цены издателя и общей комиссией за подбор рекламы.

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

Издательский этаж (CPM) Общая плата за курирование (CPM) Подборка пакетных предложений (CPM) Эффективный минимальный уровень (CPM)
7 долларов 2 доллара 10 долларов 10 долларов
4 доллара 1 доллар 4 доллара 5 долларов

Контролируйте подачу вашего тщательно подобранного пакета услуг.

Подборка товаров может находиться в одном из следующих состояний:

  • ACTIVE : Подборка рекламных мест активна. Подписавшиеся медиапланеры могут получать запросы на торги в режиме реального времени, содержащие идентификатор подборки рекламных мест для целевого рекламного пространства.
  • INACTIVE : Подборка рекламных пакетов неактивна. Идентификатор подборки не отображается в запросах на размещение рекламы в режиме реального времени, даже для подписанных медиапланировщиков.

Следующие шаги

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