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)

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

適用於 feeType 為 PARTNER_FEE_TYPE_CPM_FEE 的情況。必須大於或等於 0。

舉例來說，如果廣告客戶的貨幣有 1.5 個標準單位，請將這個欄位設為 1500000。

feePercentageMillis

string (int64 format)

媒體費百分比 (以毫秒為單位)。

適用於 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夥伴費用由合作夥伴收費。