เวิร์กโฟลว์ API

สร้างดีล

1. ดูว่า LIST ผลิตภัณฑ์ได้สร้างผลิตภัณฑ์แล้วหรือยังโดยใช้ตัวกรอง external_deal_id External_deal_id ต้องไม่ซ้ำกันในผลิตภัณฑ์ทั้งหมด

   GET https://dv360seller.googleapis.com/v1beta1/{parent=exchanges/*/orders/*}/products?filter=externalDealId="{external_deal_id}"
   

2. สร้างคำสั่งซื้อ DV3 จะสร้างชื่อขึ้น และเราขอแนะนำให้คุณจัดเก็บรหัสนี้ไว้ที่ใดที่หนึ่งในระบบเพื่อใช้ดึงข้อมูลในอนาคต

3. สร้างผลิตภัณฑ์ภายใต้คำสั่งซื้อ DV3 จะสร้างชื่อผลิตภัณฑ์ และเราขอแนะนำให้คุณจัดเก็บรหัสนี้ไว้ที่ใดที่หนึ่งในระบบเพื่อใช้ดึงข้อมูลในอนาคต

   หรือคุณจะใช้ LIST กับ external_deal_id ก็ได้ ฟิลด์ชื่อมีทั้งรหัสคำสั่งซื้อและรหัสผลิตภัณฑ์ คุณจึงระบุรายการหลักได้ง่ายด้วยวิธีนี้

ยกเลิกดีล

1. อัปเดตสถานะคำสั่งซื้อเป็น "ยกเลิกแล้ว" รองรับการยกเลิกเฉพาะในกรณีที่ยังไม่ได้ยอมรับคำสั่งซื้อ สถานะ "ยกเลิกแล้ว" เป็นสถานะสุดท้าย เมื่อยกเลิกแล้วจะเปิดใช้งานคำสั่งซื้ออีกครั้งไม่ได้

ดูรายละเอียดของดีล

1. ดูรายละเอียดของคำสั่งซื้อ สถานะจะอัปเดตเมื่อผู้ใช้ยอมรับ เก็บ หรือยกเลิกคำสั่งซื้อ
2. ดูรายละเอียดของผลิตภัณฑ์

รับรายการดีล

1. แสดงคำสั่งซื้อที่มีตัวกรองสถานะเพื่อดูคำสั่งซื้อทั้งหมดที่ยอมรับแล้ว/รอการยอมรับ
2. แสดงผลิตภัณฑ์ที่มีตัวกรอง external_deal_id
3. แสดงผลิตภัณฑ์ทั้งหมดภายในคำสั่งซื้อ

อัปเดตดีล

1. อัปเดตคำสั่งซื้อสำหรับข้อมูลติดต่อของผู้เผยแพร่โฆษณา
   1. ชื่อ ไม่อนุญาตให้อัปเดต(ตั้งค่าใน field_mask ไม่ได้) สถานะจะตั้งค่าเป็น "ยกเลิก" ผ่าน API ได้เท่านั้น
   2. partner_id ไม่อนุญาตให้อัปเดต
2. อัปเดตผลิตภัณฑ์สำหรับการอัปเดตข้อกำหนดของดีลที่เฉพาะเจาะจง
   1. อัปเดต name, externalDealId, transactionType, pricingType, updateTime ไม่ได้
   2. การอัปเดต displayName ไม่ต้องได้รับการยอมรับจากผู้ใช้
   3. Update rateDetails, creativeConfig จะเปลี่ยนสถานะคำสั่งซื้อหลักเป็น "รอการยอมรับ" ระบบจะขอให้ผู้ลงโฆษณา DV3 ยอมรับข้อกำหนดใหม่ในหน้าการเจรจาต่อรอง ไม่ว่าคำสั่งซื้อก่อนหน้านี้จะได้รับการยอมรับหรือไม่ก็ตาม

ดูว่าผู้ใช้ยอมรับดีลหรือไม่

1. รับคำสั่งซื้อหากทราบรหัสคำสั่งซื้อที่เกี่ยวข้อง ตรวจสอบช่องสถานะ
2. หากไม่ได้ติดตามรหัสคำสั่งซื้อ ให้แสดงผลิตภัณฑ์ด้วยตัวกรอง external_deal_id ค้นหาชื่อคำสั่งซื้อจากชื่อผลิตภัณฑ์ แล้วรับคำสั่งซื้อ ตรวจสอบช่องสถานะ

ดูว่าผู้ใช้ได้กำหนดค่าดีลแล้วหรือไม่(สำหรับ PG เท่านั้น)

1. รับแหล่งที่มาของพื้นที่โฆษณา ชื่อคือ "exchanges/{exchangeId}/inventorysources/{external_deal_id}" โปรดตรวจสอบสถานะผู้ซื้อ
   1. ดีลการจอง
      1. BUYER_STATUS_ACTIVE หมายความว่าดีลได้รับการยอมรับและมีการกำหนดค่าแล้ว คาดว่าดีลจะใช้จ่ายในสถานะนี้เมื่อ DV3 ได้รับคำขอราคาเสนอที่ตรงกับข้อกำหนดของดีล ระบบจะสร้างรายการโฆษณาโดยอัตโนมัติในขั้นตอนการกำหนดค่าดีล ดูรายละเอียดเพิ่มเติมได้ที่การกำหนดค่าดีล
      2. BUYER_STATUS_PENDINGหมายความว่ายอมรับคำสั่งซื้อแล้ว แต่ยังไม่ได้กำหนดค่าดีล จะไม่มีการใช้จ่ายในสถานะนี้
      3. BUYER_STATUS_PAUSEDหมายความว่าผู้ลงโฆษณาสั่งหยุดดีลชั่วคราวอย่างชัดเจน จะไม่มีการใช้จ่ายในสถานะนี้
   2. ดีลที่ไม่ใช่การจอง
      1. BUYER_STATUS_ACTIVE หมายความว่ายอมรับข้อตกลงแล้ว คาดว่าดีลจะใช้จ่ายในสถานะนี้เมื่อ DV3 ได้รับคำขอราคาเสนอที่ตรงกับข้อกำหนดของดีล และมีรายการโฆษณาที่ใช้งานอยู่ซึ่งกำหนดเป้าหมายดีลนี้ และคำขอราคาเสนอตรงกับเกณฑ์การกำหนดเป้าหมายของรายการโฆษณา ดูรายละเอียดเพิ่มเติมได้ที่รายการโฆษณา** ไม่มี Seller API สำหรับการค้นหาว่ารายการโฆษณากำหนดเป้าหมายดีลหรือไม่ **
      2. BUYER_STATUS_PENDINGไม่เกี่ยวข้อง
      3. BUYER_STATUS_PAUSEDหมายความว่าผู้ลงโฆษณาสั่งหยุดดีลชั่วคราวอย่างชัดเจน จะไม่มีการใช้จ่ายในสถานะนี้

หยุด/ยกเลิกการหยุดดีลชั่วคราวหลังจากยอมรับ

1. อัปเดตแหล่งที่มาของพื้นที่โฆษณาสถานะผู้ขาย
   1. การหยุดชั่วคราว/ยกเลิกการหยุดชั่วคราวไม่มีผลต่อการแสดงดีล ผู้ขายหยุดดีลชั่วคราวจะแสดงข้อความสตริงแก่ผู้ลงโฆษณาเพื่อแจ้งให้ทราบเท่านั้น ซึ่งจะช่วยให้ผู้ลงโฆษณาแก้ปัญหาดีลที่ไม่มีการใช้จ่ายได้

การเจรจาต่อรองครั้งใหม่ (อัปเดตดีลหลังจากยอมรับ)

การเจรจาต่อรองอีกครั้งหมายถึงการอัปเดตดีลหลังจากที่ผู้ซื้อยอมรับแล้ว ซึ่งจะเป็นประโยชน์อย่างยิ่งต่อทั้งการแลกเปลี่ยนและผู้ซื้อในการผลักดันการเปลี่ยนแปลงใหม่ๆ ไปยังดีลที่ยอมรับ ตัวอย่างเช่น Exchange อาจพบว่าเวลาสิ้นสุดดีลของดีลที่ยอมรับไม่ถูกต้อง และ Exchange สามารถใช้ผลิตภัณฑ์ Update ของ DV3 เพื่อพุชการอัปเดตไปยังผู้ซื้อ DV3 หากดีลยังไม่เริ่ม

การเปลี่ยนแปลงที่อนุญาตและไม่อนุญาต

ดูการเปลี่ยนแปลงที่อนุญาตและไม่อนุญาตในดีลระยะต่างๆ ได้ที่นี่