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)

媒體費用百分比，以千分之一為單位 (百分之 1/1000)。

當 feeType 為 PARTNER_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 出價前的相關費用。透過 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 計算。由合作夥伴收費。
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 夥伴費用會由合作夥伴收費。