PartnerCost

Chế độ cài đặt kiểm soát chi phí của đối tác.

Chi phí đối tác là mọi loại chi phí liên quan đến việc chạy chiến dịch, ngoài chi phí mua lượt hiển thị (gọi là chi phí truyền thông) và sử dụng dữ liệu phân khúc đối tượng của bên thứ ba (phí dữ liệu). Một số ví dụ về chi phí đối tác bao gồm phí sử dụng DV360, máy chủ quảng cáo của bên thứ ba hoặc dịch vụ xác minh phân phát quảng cáo của bên thứ ba.

Biểu diễn dưới dạng 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.
}
Trường
costType

enum (PartnerCostType)

Bắt buộc. Loại chi phí đối tác.
feeType

enum (PartnerCostFeeType)

Bắt buộc. Loại phí cho chi phí đối tác này.
invoiceType

enum (PartnerCostInvoiceType)

Loại hoá đơn cho chi phí đối tác này.

  • Bắt buộc khi costType là một trong những giá trị sau:
    • PARTNER_COST_TYPE_PEER39
    • PARTNER_COST_TYPE_DOUBLE_VERIFY
    • PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE.
  • Chỉ có đầu ra cho các loại khác.
Áp dụng khi cost_type không phải là PARTNER_COST_TYPE_DV360_FEE. Đối với PARTNER_COST_TYPE_DV360_FEE, trường này sẽ là 0 khi đọc và một khoản phí tự động sẽ được áp dụng. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
feeAmount

string (int64 format)

Số tiền phí CPM tính theo đơn vị micro của đơn vị tiền tệ của nhà quảng cáo.

Áp dụng khi feeType là PARTNER_FEE_TYPE_CPM_FEE. Phải lớn hơn hoặc bằng 0.

Ví dụ: đối với 1, 5 đơn vị tiêu chuẩn của đơn vị tiền tệ của nhà quảng cáo, hãy đặt trường này thành 1500000.
feePercentageMillis

string (int64 format)

Tỷ lệ phần trăm phí truyền thông tính bằng mili (1/1000 của một phần trăm).

Áp dụng khi feeType là PARTNER_FEE_TYPE_MEDIA_FEE. Phải lớn hơn hoặc bằng 0.

Ví dụ: 100 đại diện cho 0,1%.
Kết thúc các trường loại trừ lẫn nhau.

PartnerCostType

Các loại chi phí có thể có của đối tác.

Enum
PARTNER_COST_TYPE_UNSPECIFIED Giá trị loại không được chỉ định hoặc không xác định trong phiên bản này.
PARTNER_COST_TYPE_ADSAFE Chi phí được tính cho việc sử dụng AdSafe. Do đối tác lập hoá đơn.
PARTNER_COST_TYPE_ADXPOSE Chi phí được tính cho việc sử dụng AdExpose. Do đối tác lập hoá đơn.
PARTNER_COST_TYPE_AGGREGATE_KNOWLEDGE Chi phí được tính cho việc sử dụng Aggregate Knowledge. Do đối tác lập hoá đơn.
PARTNER_COST_TYPE_AGENCY_TRADING_DESK Chi phí được tính cho việc sử dụng Bộ phận chuyên trách giao dịch của đại lý. Do đối tác lập hoá đơn.
PARTNER_COST_TYPE_DV360_FEE Chi phí được tính cho việc sử dụng DV360. Được tính phí thông qua DV360.
PARTNER_COST_TYPE_COMSCORE_VCE Chi phí được tính cho việc sử dụng comScore vCE. Được tính phí thông qua DV360.
PARTNER_COST_TYPE_DATA_MANAGEMENT_PLATFORM Chi phí được tính cho việc sử dụng Nền tảng quản lý dữ liệu. Do đối tác lập hoá đơn.
PARTNER_COST_TYPE_DEFAULT Loại chi phí mặc định. Do đối tác lập hoá đơn.
PARTNER_COST_TYPE_DOUBLE_VERIFY Chi phí được tính cho việc sử dụng DoubleVerify. Do đối tác lập hoá đơn.
PARTNER_COST_TYPE_DOUBLE_VERIFY_PREBID Chi phí này được tính cho việc sử dụng tính năng Đặt giá thầu trước của DoubleVerify. Được tính phí thông qua DV360.
PARTNER_COST_TYPE_EVIDON Chi phí này được tính cho việc sử dụng Evidon. Do đối tác lập hoá đơn.
PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE_VIDEO Chi phí được tính cho việc sử dụng Integral Ad Science Video. Do đối tác lập hoá đơn.
PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE_PREBID Phí sử dụng tính năng Đặt giá thầu trước của Integral Ad Science. Được tính phí thông qua DV360.
PARTNER_COST_TYPE_MEDIA_COST_DATA Chi phí này được tính khi sử dụng dữ liệu chi phí truyền thông. Do đối tác lập hoá đơn.
PARTNER_COST_TYPE_MOAT_VIDEO Chi phí được tính cho việc sử dụng MOAT Video. Do đối tác lập hoá đơn.
PARTNER_COST_TYPE_NIELSEN_DAR Chi phí này được tính cho việc sử dụng Điểm xếp hạng quảng cáo kỹ thuật số của Nielsen. Được tính phí thông qua DV360.
PARTNER_COST_TYPE_SHOP_LOCAL Chi phí được tính khi sử dụng ShopLocal. Do đối tác lập hoá đơn.
PARTNER_COST_TYPE_TERACENT Chi phí được tính cho việc sử dụng Teracent. Do đối tác lập hoá đơn.
PARTNER_COST_TYPE_THIRD_PARTY_AD_SERVER Chi phí này được tính khi sử dụng máy chủ quảng cáo của bên thứ ba. Do đối tác lập hoá đơn.
PARTNER_COST_TYPE_TRUST_METRICS Chi phí này được tính cho việc sử dụng TrustMetrics. Do đối tác lập hoá đơn.
PARTNER_COST_TYPE_VIZU Chi phí được tính cho việc sử dụng Vizu. Do đối tác lập hoá đơn.
PARTNER_COST_TYPE_CUSTOM_FEE_1 Chi phí này được tính là phí tuỳ chỉnh 1. Do đối tác lập hoá đơn.
PARTNER_COST_TYPE_CUSTOM_FEE_2 Chi phí này được tính là phí tuỳ chỉnh 2. Do đối tác lập hoá đơn.
PARTNER_COST_TYPE_CUSTOM_FEE_3 Chi phí này được tính là phí tuỳ chỉnh 3. Do đối tác lập hoá đơn.
PARTNER_COST_TYPE_CUSTOM_FEE_4 Chi phí này được tính là phí tuỳ chỉnh 4. Do đối tác lập hoá đơn.
PARTNER_COST_TYPE_CUSTOM_FEE_5 Chi phí này được tính là phí tuỳ chỉnh 5. Do đối tác lập hoá đơn.
PARTNER_COST_TYPE_SCIBIDS_FEE

Chi phí sử dụng Scibids. Được tính phí thông qua DV360.

Loại này hiện chỉ dành cho một số khách hàng. Những khách hàng khác cố gắng sử dụng loại này sẽ nhận được thông báo lỗi.
PARTNER_COST_TYPE_PEER39 Chi phí được tính cho việc sử dụng Peer39. Do đối tác lập hoá đơn.
PARTNER_COST_TYPE_PEER39_PREBID Chi phí này được tính cho việc sử dụng tính năng Đặt giá thầu trước của Peer39. Được tính phí thông qua DV360.

PartnerCostFeeType

Các loại phí có thể có của chi phí đối tác.

Enum
PARTNER_COST_FEE_TYPE_UNSPECIFIED Giá trị không được chỉ định hoặc không xác định trong phiên bản này.
PARTNER_COST_FEE_TYPE_CPM_FEE

Chi phí đối tác là một khoản phí CPM cố định.

Không áp dụng khi chi phí đối tác costType là một trong những giá trị sau:

  • PARTNER_COST_TYPE_MEDIA_COST_DATA
  • PARTNER_COST_TYPE_DV360_FEE.
PARTNER_COST_FEE_TYPE_MEDIA_FEE

Chi phí đối tác là một khoản phụ phí theo tỷ lệ phần trăm dựa trên chi phí truyền thông.

Không áp dụng khi đối tác costType là một trong những đối tác sau:

  • PARTNER_COST_TYPE_SHOP_LOCAL
  • PARTNER_COST_TYPE_TRUST_METRICS
  • PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE_VIDEO
  • PARTNER_COST_TYPE_MOAT_VIDEO.

PartnerCostInvoiceType

Các loại hoá đơn có thể có của chi phí đối tác.

Enum
PARTNER_COST_INVOICE_TYPE_UNSPECIFIED Giá trị loại không được chỉ định hoặc không xác định trong phiên bản này.
PARTNER_COST_INVOICE_TYPE_DV360 Chi phí đối tác được tính phí thông qua DV360.
PARTNER_COST_INVOICE_TYPE_PARTNER Chi phí đối tác do đối tác lập hoá đơn.