PartnerCost

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

Расходы на партнёра — это любые расходы, связанные с проведением кампании, за исключением расходов на покупку показов (которые называются медиастоимостью) и использование данных о сторонних сегментах аудитории (плата за данные). Примерами расходов на партнёра могут служить сборы за использование DV360, стороннего рекламного сервера или стороннего сервиса проверки показов рекламы.

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

  // Union field fee_value can be only one of the following:
  "feeAmount": string,
  "feePercentageMillis": string
  // End of list of possible types for union field fee_value.
}
Поля
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 .
  • Вывод только для других типов.
Поле объединения fee_value . Применяется, если cost_type не равен PARTNER_COST_TYPE_DV360_FEE . Для PARTNER_COST_TYPE_DV360_FEE поле будет равно 0 при чтении, и будет применена автоматическая комиссия. fee_value может быть только одним из следующих:
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 Плата взимается за использование сервиса 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. Счёт выставляет партнёр.
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 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_ADLINGO_FEE

Плата взимается за использование AdLingo. Оплата производится через DV360.

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

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

Неприменимо, если 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 Счет за партнерские услуги выставляется партнером.