เวิร์กโฟลว์ 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 หากดีลยังไม่เริ่ม

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

เราอนุญาตให้เปลี่ยนแปลงทุกช่อง ยกเว้นช่องที่สำคัญต่อการแสดงผลบางช่อง เช่น startTime, endTime, rateDetails, creativeConfig และอื่นๆ เรามีการตรวจสอบความถูกต้องเกี่ยวกับช่องที่สำคัญต่อการแสดงผลเหล่านี้ โดยทั่วไปแล้ว เราอนุญาตให้อัปเดตฟิลด์เหล่านี้ยกเว้น creativeConfig หากเวลาเริ่มต้นของดีลเป็นเวลาอย่างน้อย 1 วันในอนาคต ระบบอนุญาตให้อัปเดตเฉพาะส่วนเพิ่มสำหรับดีลที่กำลังใช้งานอยู่ ซึ่งมีเวลาเริ่มต้นเป็นอดีต แต่เวลาสิ้นสุดเป็นอนาคต ไม่อนุญาตให้เปลี่ยนแปลงดีลที่เสร็จสมบูรณ์แล้วซึ่งมีเวลาสิ้นสุดในอดีต เช่น ไม่อนุญาตให้อัปเดต rateDetails ของดีลที่เสร็จสมบูรณ์ไปเมื่อ 1 ปีที่แล้ว ในกรณีเช่นนี้ การอัปเดตผลิตภัณฑ์ DV3 จะทำให้เกิดข้อผิดพลาดในการตรวจสอบ