PartnerCost

Настройки, определяющие стоимость услуг партнера.

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

JSON-представление 
{
  "costType": enum (PartnerCostType),
  "feeType": enum (PartnerCostFeeType),
  "invoiceType": enum (PartnerCostInvoiceType),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "feeAmount": string,
  "feePercentageMillis": string
  // End of mutually exclusive fields.
}
Поля
costType

enum (PartnerCostType)

Обязательно. Тип стоимости услуг партнеров.
feeType

enum (PartnerCostFeeType)

Обязательно. Тип комиссии для этой стоимости услуг партнеров.
invoiceType

enum (PartnerCostInvoiceType)

Тип счета для этой стоимости услуг партнера.

  • Обязательно, если costType – одно из следующих значений:
    • PARTNER_COST_TYPE_PEER39
    • PARTNER_COST_TYPE_DOUBLE_VERIFY
    • PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE.
  • Для других типов используется только для вывода.
Применимо, если cost_type не равно PARTNER_COST_TYPE_DV360_FEE. Для PARTNER_COST_TYPE_DV360_FEE значение поля будет равно 0, и будет применяться автоматическая комиссия. Ниже приведен список взаимоисключающих полей. В ответе будет задано не более одного из следующих полей:
feeAmount

string (int64 format)

Размер комиссии за тысячу показов в микроединицах валюты рекламодателя.

Применяется, если feeType – PARTNER_FEE_TYPE_CPM_FEE. Значение должно быть больше или равно 0.

Например, если вы хотите указать 1,5 стандартной единицы валюты рекламодателя, введите в этом поле значение 1500000.
feePercentageMillis

string (int64 format)

Процент платы за рекламу в миллипроцентах (1/1000 процента).

Применяется, если feeType – PARTNER_FEE_TYPE_MEDIA_FEE. Значение должно быть больше или равно 0.

Например, 100 соответствует 0,1%.
Конец взаимоисключающих полей.

PartnerCostType

Возможные типы стоимости услуг партнера.

Перечисления
PARTNER_COST_TYPE_UNSPECIFIED Значение типа не указано или неизвестно в этой версии.
PARTNER_COST_TYPE_ADSAFE Плата за использование AdSafe. Счета выставляет партнер.
PARTNER_COST_TYPE_ADXPOSE Плата за использование AdExpose. Счета выставляет партнер.
PARTNER_COST_TYPE_AGGREGATE_KNOWLEDGE Плата за использование Aggregate Knowledge. Счета выставляет партнер.
PARTNER_COST_TYPE_AGENCY_TRADING_DESK Плата за использование агентства – рекламного брокера. Счета выставляет партнер.
PARTNER_COST_TYPE_DV360_FEE Плата за использование DV360. Оплата через DV360.
PARTNER_COST_TYPE_COMSCORE_VCE Плата за использование comScore vCE. Оплата через DV360.
PARTNER_COST_TYPE_DATA_MANAGEMENT_PLATFORM Плата за использование платформы управления данными. Счета выставляет партнер.
PARTNER_COST_TYPE_DEFAULT Тип стоимости по умолчанию. Счета выставляет партнер.
PARTNER_COST_TYPE_DOUBLE_VERIFY Плата за использование DoubleVerify. Счета выставляет партнер.
PARTNER_COST_TYPE_DOUBLE_VERIFY_PREBID Эта плата взимается за использование предварительного аудита DoubleVerify. Оплата через DV360.
PARTNER_COST_TYPE_EVIDON Плата взимается за использование Evidon. Счета выставляет партнер.
PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE_VIDEO Плата за использование Integral Ad Science Video. Счета выставляет партнер.
PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE_PREBID Комиссия за использование предварительного аудита Integral Ad Science. Оплата через DV360.
PARTNER_COST_TYPE_MEDIA_COST_DATA Эта комиссия взимается за использование данных о расходах на рекламу. Счета выставляет партнер.
PARTNER_COST_TYPE_MOAT_VIDEO Плата за использование MOAT Video. Счета выставляет партнер.
PARTNER_COST_TYPE_NIELSEN_DAR Плата за использование Nielsen Digital Ad Ratings. Оплата через DV360.
PARTNER_COST_TYPE_SHOP_LOCAL Плата взимается за использование ShopLocal. Счета выставляет партнер.
PARTNER_COST_TYPE_TERACENT Плата за использование Teracent. Счета выставляет партнер.
PARTNER_COST_TYPE_THIRD_PARTY_AD_SERVER Плата за использование стороннего сервера объявлений. Счета выставляет партнер.
PARTNER_COST_TYPE_TRUST_METRICS Плата взимается за использование TrustMetrics. Счета выставляет партнер.
PARTNER_COST_TYPE_VIZU Плата за использование Vizu. Счета выставляет партнер.
PARTNER_COST_TYPE_CUSTOM_FEE_1 Стоимость взимается как специальная комиссия 1. Счета выставляет партнер.
PARTNER_COST_TYPE_CUSTOM_FEE_2 Стоимость взимается как собственная комиссия 2. Счета выставляет партнер.
PARTNER_COST_TYPE_CUSTOM_FEE_3 Она взимается как собственная комиссия 3. Счета выставляет партнер.
PARTNER_COST_TYPE_CUSTOM_FEE_4 Стоимость взимается как специальная комиссия 4. Счета выставляет партнер.
PARTNER_COST_TYPE_CUSTOM_FEE_5 Она взимается как специальная комиссия 5. Счета выставляет партнер.
PARTNER_COST_TYPE_SCIBIDS_FEE

Плата за использование Scibids. Оплата через DV360.

Этот тип в настоящее время доступен только некоторым клиентам. Другие клиенты, которые попытаются использовать этот тип, получат сообщение об ошибке.
PARTNER_COST_TYPE_PEER39 Плата за использование Peer39. Счета выставляет партнер.
PARTNER_COST_TYPE_PEER39_PREBID Плата за использование предварительного аудита Peer39. Оплата через DV360.

PartnerCostFeeType

Возможные типы комиссий, связанных со стоимостью услуг партнера.

Перечисления
PARTNER_COST_FEE_TYPE_UNSPECIFIED Значение не указано или неизвестно в этой версии.
PARTNER_COST_FEE_TYPE_CPM_FEE

Стоимость услуг партнеров – это фиксированная цена за тысячу показов.

Неприменимо, если стоимость услуг партнеров costType относится к одному из следующих типов:

  • PARTNER_COST_TYPE_MEDIA_COST_DATA
  • PARTNER_COST_TYPE_DV360_FEE.
PARTNER_COST_FEE_TYPE_MEDIA_FEE

Доля партнера рассчитывается как процент от стоимости рекламы.

Неприменимо, если партнер costType – один из следующих:

  • PARTNER_COST_TYPE_SHOP_LOCAL
  • PARTNER_COST_TYPE_TRUST_METRICS
  • PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE_VIDEO
  • PARTNER_COST_TYPE_MOAT_VIDEO.

PartnerCostInvoiceType

Возможные типы счетов для стоимости услуг партнера.

Перечисления
PARTNER_COST_INVOICE_TYPE_UNSPECIFIED Значение типа не указано или неизвестно в этой версии.
PARTNER_COST_INVOICE_TYPE_DV360 Стоимость услуг партнеров оплачивается через DV360.
PARTNER_COST_INVOICE_TYPE_PARTNER Счета за услуги партнеров выставляются партнерами.