Marketplace API

ภาพรวม

Authorized Buyers Marketplace API คือชุดทรัพยากรที่ผู้ซื้อจะใช้เพื่อจัดการรายการต่อไปนี้แบบเป็นโปรแกรมได้

• การเจรจาต่อรองกับผู้เผยแพร่โฆษณา
• แพ็กเกจการประมูล
• การเข้าถึง UI ของตลาดกลาง Authorized Buyers ของไคลเอ็นต์

คู่มือนี้จะแนะนำ Marketplace API และอธิบายวิธีที่ทรัพยากร Marketplace API จับคู่กับฟีเจอร์ของ Marketplace ใน UI ของ Authorized Buyers

ผู้เสนอราคาและผู้ซื้อ

Marketplace API สอดคล้องกับโครงสร้างของ Real-time Bidding API API ทั้ง 2 รายการใช้ bidders และ buyers เป็นทรัพยากรระดับรากสำหรับการทำงานของผู้เสนอราคาและผู้ซื้อ คุณใช้ผู้เสนอราคาและชื่อผู้ซื้อเดียวกันในเส้นทางทรัพยากรสำหรับ API ของการเสนอราคาแบบเรียลไทม์และ Marketplace ได้

หมายเหตุ: แม้ว่า bidders และ buyers จะเป็นทรัพยากรระดับราก แต่คุณจะเรียกใช้ใน Marketplace API ไม่ได้ ใช้ Real-time Bidding API เพื่อเข้าถึง bidders หรือ buyers ด้วยข้อมูลเข้าสู่ระบบ OAuth 2.0

ลูกค้าและผู้ใช้ของลูกค้า

คุณใช้ Marketplace API เพื่อสร้างและจัดการลูกค้าและผู้ใช้ของลูกค้า และให้สิทธิ์เอเจนซีหรือผู้ลงโฆษณาเข้าถึงแท็บตลาดกลางแบบเป็นโปรแกรมได้ใน UI ของ Authorized Buyers

Client เป็นตัวแทนของลูกค้า เอเจนซี หรือผู้ลงโฆษณาที่เชื่อมโยงกับบัญชี Authorized Buyers ของคุณ

ClientUser แสดงถึงบุคคลที่เฉพาะเจาะจงซึ่งมีสิทธิ์เข้าถึง UI ภายใต้ Client ผู้ใช้ไคลเอ็นต์เข้าถึง Marketplace API ไม่ได้ ผู้ใช้ของลูกค้ามีสิทธิ์เข้าถึงแท็บตลาดกลางของบัญชีอย่างจำกัด สิทธิ์ของผู้ใช้ไคลเอ็นต์จะกำหนดโดย role ที่ระบุไว้ใน Client ระดับบนของลูกค้า

ทรัพยากรอื่นๆ ใน Marketplace API จะอ้างอิงไคลเอ็นต์ตามชื่อที่ระบุในทรัพยากร Clients

หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับลูกค้าและผู้ใช้ของลูกค้าใน UI ของตลาดกลางของ Authorized Buyers โปรดดูบทความต่อไปนี้ในศูนย์ช่วยเหลือ

• สร้างและจัดการลูกค้าและผู้ใช้ของลูกค้า
• ประเภทของสิทธิ์การเข้าถึงของลูกค้า

เจ้าหน้าที่วางแผนโฆษณา

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

หากต้องการดูว่าเจ้าหน้าที่วางแผนโฆษณามีการเจรจาต่อรองดีลที่สรุปผลแล้วหรือไม่ คุณสามารถตรวจสอบว่ามีการป้อนข้อมูลในช่อง mediaPlanner ของดีลหรือไม่ เจ้าหน้าที่วางแผนโฆษณาจะกำหนดรายการรหัสใบอนุญาตที่มีสำหรับ DSP โดยเฉพาะซึ่งมีสิทธิ์ทำธุรกรรมในดีล ซึ่งดูได้ในช่อง eligibleSeatIds ในคำขอราคาเสนอของการเสนอราคาแบบเรียลไทม์ รหัสใบอนุญาตเหล่านี้อาจปรากฏในรายการที่อนุญาตหรือรายการที่บล็อกที่ผู้เผยแพร่โฆษณากำหนดไว้ ซึ่งจะกำหนดว่าราคาเสนอถูกกรองออกจากการประมูลหรือไม่ ซึ่งจะปรากฏในช่อง BidRequest ต่อไปนี้

• โปรโตคอล OpenRTB
  • BidRequest.wseat
  • BidRequest.bseat
  • BidRequest.imp.pmp.deals.wseat
• โปรโตคอล Google RTB
  • BidRequest.adslot.allowed_seat_ids
  • BidRequest.adslot.blocked_seat_ids
  • BidRequest.adslot.matching_ad_data.direct_deal.allowed_seat_ids

แพ็กเกจการประมูล

คุณใช้ Marketplace API เพื่อสมัครใช้บริการและยกเลิกการสมัครรับอีเมลของผู้ซื้อและลูกค้าจากแพ็กเกจการประมูล รวมถึงดูแพ็กเกจการประมูลที่คุณสมัครใช้ได้

AuctionPackage คล้ายกับกลุ่มการกำหนดเป้าหมายสำหรับพื้นที่โฆษณาในตลาดกลาง เช่น แพ็กเกจการประมูลอาจกำหนดเป้าหมายคอลเล็กชันของ URL และรหัสแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ซึ่งเกี่ยวข้องกับความสนใจทางธุรกิจของผู้ซื้อ

คุณสร้างแพ็กเกจการประมูลใหม่ด้วย Marketplace API ไม่ได้ คุณใช้ UI ของตลาดกลางของ Authorized Buyers เพื่อสร้างแพ็กเกจการประมูลได้ Marketplace API จะไม่รวมข้อมูลการกำหนดเป้าหมายเฉพาะที่เกี่ยวข้องกับแพ็กเกจการประมูล

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

ดูแพ็กเกจการประมูลสำหรับข้อมูลเพิ่มเติม

โปรไฟล์ผู้เผยแพร่โฆษณา

คุณใช้ Marketplace API เพื่อดูโปรไฟล์ของผู้เผยแพร่โฆษณาที่เจรจาต่อรองได้

PublisherProfile หมายถึงผู้เผยแพร่โฆษณาใน Marketplace API แหล่งข้อมูลอื่นๆ ใน Marketplace API จะหมายถึงผู้เผยแพร่โฆษณาที่มีชื่อที่ระบุไว้ใน PublisherProfile

โปรไฟล์ผู้เผยแพร่โฆษณามีข้อมูลคล้ายกับผู้เผยแพร่โฆษณาในแท็บการค้นพบของ UI ในตลาดกลางของ Authorized Buyers

ดูข้อมูลเพิ่มเติมได้ในวิธีค้นหาผู้เผยแพร่โฆษณา

ข้อเสนอและดีล

คุณใช้ Marketplace API เพื่อต่อรองดีลกับผู้เผยแพร่โฆษณาได้ ตัวอย่างวิธีใช้ Marketplace API ในการจัดการดีลมีดังนี้

• ส่งข้อเสนอใหม่
• ต่อรองกับผู้เผยแพร่โฆษณา
• สรุปผลดีล
• แสดงดีลที่สรุปผลแล้ว
• เริ่มเจรจาต่อรองดีลที่สรุปผลแล้วอีกครั้ง

ข้อเสนอแสดงถึงสถานะการเจรจาต่อรองล่าสุดของดีลอย่างน้อย 1 รายการระหว่างผู้ซื้อหรือลูกค้ากับผู้เผยแพร่โฆษณา และคล้ายกับแท็บการเจรจาของ UI ในตลาดกลางของ Authorized Buyers

ดีลแสดงถึงข้อกำหนดล่าสุดของดีลที่เจรจาต่อรองภายใต้ข้อเสนอนั้นๆ และเทียบเท่ากับรายการดีลของ UI ของตลาดกลางของ Authorized Buyers ที่มีป้ายกำกับว่าการเจรจาปัจจุบันสำหรับข้อเสนอนั้นๆ

ดีลที่สรุปผลแล้ว เป็นตัวแทนของดีลที่เสร็จสิ้นขั้นตอนการเจรจาต่อรองและพร้อมแสดง ซึ่งรวมถึงดีลที่แสดงอยู่แล้ว ดีลที่สรุปผลแล้วจะคล้ายกับแท็บดีลของ UI ในตลาดกลางของ Authorized Buyers

ลักษณะการทำงานของทรัพยากร Marketplace API อาจแตกต่างกันไปตามประเภทของดีลที่คุณกำลังเจรจาต่อรอง เช่น ผู้ซื้อไม่สามารถเริ่มต้นการเจรจาสำหรับดีลทุกประเภท ดูข้อมูลเพิ่มเติมเกี่ยวกับการติดตั้งใช้งาน Marketplace API สำหรับการเจรจาได้จากแหล่งข้อมูลต่อไปนี้

• buyers.proposals
• buyers.proposals.deals
• buyers.finalizedDeals

หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการเจรจาต่อรองใน UI ของตลาดกลางของ Authorized Buyers ให้ดูที่หัวข้อต่อไปนี้

• เจรจาดีล
• ขอข้อเสนอสำหรับพื้นที่โฆษณาของผู้เผยแพร่โฆษณา
• จัดการดีลของคุณ