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 เมื่ออ่าน และระบบจะเรียกเก็บค่าธรรมเนียมโดยอัตโนมัติ ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าฟิลด์อย่างน้อย 1 รายการในการตอบกลับ
feeAmount

string (int64 format)

จำนวนค่าธรรมเนียม CPM ในหน่วยไมโครของสกุลเงินของผู้ลงโฆษณา

ใช้ได้เมื่อ 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

ประเภทของต้นทุนพาร์ทเนอร์ที่เป็นไปได้

Enum
PARTNER_COST_TYPE_UNSPECIFIED ไม่ได้ระบุค่าประเภทหรือไม่รู้จักในเวอร์ชันนี้
PARTNER_COST_TYPE_ADLOOX ระบบจะเรียกเก็บค่าใช้จ่ายสำหรับการใช้ Scope3 (เดิมชื่อ Adloox) เรียกเก็บเงินโดยพาร์ทเนอร์
PARTNER_COST_TYPE_ADLOOX_PREBID ระบบจะเรียกเก็บค่าใช้จ่ายสำหรับการใช้ Scope3 (เดิมชื่อ Adloox) Pre-Bid เรียกเก็บเงินผ่าน 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 เรียกเก็บเงินโดยพาร์ทเนอร์
PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE_PREBID ระบบจะเรียกเก็บค่าใช้จ่ายสำหรับการใช้ Pre-Bid ของ Integral Ad Science เรียกเก็บเงินผ่าน DV360
PARTNER_COST_TYPE_MEDIA_COST_DATA ระบบจะเรียกเก็บเงินสำหรับการใช้ข้อมูลต้นทุนสื่อ เรียกเก็บเงินโดยพาร์ทเนอร์
PARTNER_COST_TYPE_MOAT_VIDEO ระบบจะเรียกเก็บค่าใช้จ่ายสำหรับการใช้ MOAT Video เรียกเก็บเงินโดยพาร์ทเนอร์
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

ประเภทค่าธรรมเนียมที่เป็นไปได้ของต้นทุนพาร์ทเนอร์

Enum
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

ประเภทใบแจ้งหนี้ที่เป็นไปได้ของต้นทุนพาร์ทเนอร์

Enum
PARTNER_COST_INVOICE_TYPE_UNSPECIFIED ไม่ได้ระบุค่าประเภทหรือไม่รู้จักในเวอร์ชันนี้
PARTNER_COST_INVOICE_TYPE_DV360 ระบบจะเรียกเก็บเงินต้นทุนพาร์ทเนอร์ผ่าน DV360
PARTNER_COST_INVOICE_TYPE_PARTNER พาร์ทเนอร์จะเป็นผู้เรียกเก็บเงินค่าใช้จ่ายพาร์ทเนอร์