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)

以廣告主幣別的微量單位表示的千次曝光出價費用金額。

如果 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 影片的費用。由合作夥伴收費。
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 合作夥伴費用由合作夥伴收取。