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 费用金额,以广告客户币种的微单位表示。

feeTypePARTNER_FEE_TYPE_CPM_FEE 时,适用此字段。必须大于等于 0。

例如,对于 1.5 标准单位的广告客户货币,请将此字段设置为 1500000。

feePercentageMillis

string (int64 format)

媒体费用百分比,以千分比表示(百分比的 1/1000)。

feeTypePARTNER_FEE_TYPE_MEDIA_FEE 时,适用此字段。必须大于等于 0。

例如:100 表示 0.1%。

PartnerCostType

可能的合作伙伴费用类型。

枚举
PARTNER_COST_TYPE_UNSPECIFIED 此版本中未指定或未知类型值。
PARTNER_COST_TYPE_ADLOOX 您需要为使用 Adloox 付费。由合作伙伴收费。
PARTNER_COST_TYPE_ADLOOX_PREBID 您需要为使用 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 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 出价前费用支付相应费用。通过 DV360 结算。
PARTNER_COST_TYPE_MEDIA_COST_DATA 您需要为使用媒体费用数据支付费用。由合作伙伴收费。
PARTNER_COST_TYPE_MOAT_VIDEO 使用 MOAT 视频会产生费用。由合作伙伴收费。
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 收取。由合作伙伴收费。

PartnerCostFeeType

合作伙伴费用的可能费用类型。

枚举
PARTNER_COST_FEE_TYPE_UNSPECIFIED 此版本中未指定或未知值。
PARTNER_COST_FEE_TYPE_CPM_FEE

合作伙伴费用是固定的 CPM 费用。

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