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_ADLOOX
    • 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)

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

Применяется, если 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_ADLOOX Плата взимается за использование Scope3 (ранее известного как Adloox). Счет выставляет партнер.
PARTNER_COST_TYPE_ADLOOX_PREBID Стоимость включает использование программы Scope3 (ранее известной как Adloox) Pre-Bid. Выставление счета осуществляется через DV360.
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 Pre-Bid. Оплата производится через 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 Pre-Bid взимается отдельно. Оплата производится через DV360.
PARTNER_COST_TYPE_MEDIA_COST_DATA Плата взимается за использование данных о затратах на рекламу. Счет выставляет партнер.
PARTNER_COST_TYPE_MOAT_VIDEO Плата взимается за использование MOAT Video. Счет выставляет партнер.
PARTNER_COST_TYPE_NIELSEN_DAR Эта плата взимается за использование рейтингов цифровой рекламы Nielsen. Оплата производится через 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.

В настоящее время этот тип доступен только определенным клиентам. Другие клиенты, пытающиеся использовать этот тип, получат ошибку.

PartnerCostFeeType

Возможные виды комиссионных сборов, взимаемых партнером.

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

Партнерские расходы представляют собой фиксированную плату за тысячу показов (CPM).

Не применяется, если тип затрат партнера (partner cost 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 Расходы партнера оплачиваются партнером.