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）出价前服务时，系统会收取费用。通过 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 出价前服务而收取的。通过 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 出价前服务收取费用。通过 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 付费。

此类型目前仅面向部分客户提供。其他客户尝试使用此类型时会收到错误消息。

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 合作伙伴费用由合作伙伴收取。