Protos & & ข้อมูลอ้างอิง

ดูหรือดาวน์โหลดไฟล์ที่รองรับโปรโตคอล RTB

โปรโต

ไฟล์ คำอธิบาย เวอร์ชัน อัปเดตครั้งล่าสุด
cookie-bulk-upload.proto ใช้ข้อความนี้เพื่ออัปโหลดข้อมูลการกำหนดเป้าหมายผู้ใช้จำนวนมาก v.24 27 มี.ค. 2024
openrtb.proto Google รองรับโปรโตคอล OpenRTB โดยใช้การเข้ารหัส JSON หรือ Protobuf คุณต้องใช้โปรโตนี้หากใช้ OpenRTB/Protobuf นอกจากนี้ยังมีเอกสารประกอบของช่องที่รองรับและการแมปกับโปรโตคอลเนทีฟของ Google 2.6 2 มิ.ย. 2026
openrtb-adx.proto โปรโตคอล OpenRTB ของ Google มีส่วนขยายบางอย่างที่ระบุไว้ในโปรโตแยกต่างหาก v.207 13 เม.ย. 2026
publisher-settings.proto ชุดการตั้งค่าผู้เผยแพร่โฆษณาที่เฉพาะเจาะจงสำหรับเครือข่ายผู้เสนอราคาแบบเรียลไทม์ v.14 5 ก.พ. 2024

โปรโตเวอร์ชันเบต้าแบบเปิด

ไฟล์ คำอธิบาย เวอร์ชัน อัปเดตครั้งล่าสุด
openrtb-adx.proto โปรโตคอล OpenRTB ของ Google มีส่วนขยายบางอย่างที่ระบุไว้ในโปรโตแยกต่างหาก v.215 13 เม.ย. 2026

ข้อมูลอ้างอิง

พจนานุกรม (คลิกเพื่อดาวน์โหลดไฟล์ .txt)

หมวดหมู่ผลิตภัณฑ์โฆษณา ใช้ในช่อง excluded_product_category ของ BidRequest. ช่องนี้อธิบายหมวดหมู่ของผลิตภัณฑ์และ บริการที่ผู้เผยแพร่โฆษณาไม่อนุญาต เช่น หากผู้เผยแพร่โฆษณา ไม่ต้องการโฮสต์โฆษณาที่เกี่ยวข้องกับการธนาคารออนไลน์
หมวดหมู่โฆษณาที่จำกัด ใช้ในช่อง allowed_restricted_category ของ BidRequest และช่อง restricted_category ของ BidResponse ช่อง allowed_restricted_category อธิบายหมวดหมู่ที่โดยปกติแล้วจะถูกจำกัด แต่ผู้เผยแพร่โฆษณาประกาศอย่างชัดเจนว่าอนุญาต เช่น โฆษณาที่มีเนื้อหาเกี่ยวกับแอลกอฮอล์
หมวดหมู่โฆษณาที่ละเอียดอ่อน ใช้ในช่อง excluded_sensitive_category ของ BidRequest และช่อง category ของ BidResponse ช่อง excluded_sensitive_category อธิบายหมวดหมู่ที่ละเอียดอ่อนซึ่งผู้เผยแพร่โฆษณาไม่อนุญาต เช่น หากผู้เผยแพร่โฆษณาไม่ต้องการโฮสต์โฆษณาที่เกี่ยวข้องกับ การเมือง
ผู้ลงโฆษณา ใช้ในช่อง advertiser_id ของ SnippetStatusItem ช่องนี้ระบุผู้ลงโฆษณาที่แสดงโดยครีเอทีฟโฆษณาที่เชื่อมโยงกับข้อมูลโค้ด รายการนี้แสดงผู้ลงโฆษณาทั่วทั้ง Exchange และไม่ได้แสดงผู้ลงโฆษณาที่แสดงโดยผู้ซื้อรายใดรายหนึ่ง
แบรนด์ รายการแบรนด์ที่ใช้ใน Client Access API
แอตทริบิวต์ครีเอทีฟโฆษณาที่ผู้ซื้อประกาศได้ ใช้สำหรับช่อง attribute ใน BidResponse ช่องนี้อธิบายแอตทริบิวต์ที่ผู้ซื้อประกาศได้ในครีเอทีฟโฆษณา ซึ่งต้อง ไม่ปรากฏใน excluded_attribute ใน BidRequest
รหัสสถานะคำขอราคาเสนอ รหัสสถานะที่แสดงผลโดยการเรียกเมธอด performancereport
ป้ายกำกับเนื้อหา ใช้ในช่อง detected_content_labels ของ BidRequest
รหัสสถานะเครื่องมือจับคู่คุกกี้ ใช้ในช่อง cookieMatcherStatusRate ของรายงานประสิทธิภาพโปรโตคอล RTB รหัสที่ใช้ได้อธิบายไว้ในคู่มือการจับคู่คุกกี้
รหัสสถานะครีเอทีฟโฆษณา

ใช้ใน

creative_status_code ที่แสดงผลใน เรียลไทม์ ความคิดเห็น
รหัสสถานะการจับคู่ที่โฮสต์ ใช้ในช่อง hostedMatchStatusRate ของรายงานประสิทธิภาพโปรโตคอล RTB
เหตุผลที่ไม่เสนอราคา ค่าเหตุผลที่ไม่เสนอราคามาตรฐานที่จะระบุในช่อง BidResponse.no_bid_reason ใน โปรโตคอลการเสนอราคาของ Authorized Buyers
แอตทริบิวต์ครีเอทีฟโฆษณาที่กำหนดเป้าหมายล่วงหน้าได้ ใช้ในช่อง supportedCreativeAttribute ใน ทรัพยากร PretargetingConfig ที่แสดงใน Buyer REST API ช่องนี้อธิบายแอตทริบิวต์ครีเอทีฟโฆษณาที่คาดว่าจะปรากฏในครีเอทีฟโฆษณาทั้งหมดที่สอดคล้องกับการกำหนดค่าการกำหนดเป้าหมายล่วงหน้าเพียงรายการเดียว
แอตทริบิวต์ครีเอทีฟโฆษณาที่ผู้เผยแพร่โฆษณายกเว้นได้ ใช้ในช่อง excluded_attribute ของ BidRequest. ช่องนี้อธิบายประเภทครีเอทีฟโฆษณาที่ ผู้เผยแพร่โฆษณาไม่อนุญาต เช่น ผู้เผยแพร่โฆษณาอาจระบุ ข้อจำกัดว่าอนุญาตให้ใช้คุกกี้หรือไม่ หรืออนุญาตให้ใช้โฆษณาแบบข้อความและ/หรือโฆษณาสื่อ หรือไม่
ผู้ให้บริการ ใช้ในช่อง allowed_vendor_type ของ BidRequest ช่องนี้แสดงรายการผู้ให้บริการสื่อสมบูรณ์ เช่น Campaign Monitor และ VoiceFive ที่ได้รับอนุญาตสำหรับครีเอทีฟโฆษณาที่จะแสดง ตามที่ผู้เผยแพร่โฆษณาระบุ

รวมถึงผู้ให้บริการจากไฟล์พจนานุกรมที่เลิกใช้งานแล้ว gdn-vendors.txt

ผู้ให้บริการข้อมูล ใช้ในช่อง SegmentData.id ของ BidRequest ช่องนี้มีข้อมูลเกี่ยวกับเอนทิตีที่ให้ สัญญาณที่ได้จากผู้เผยแพร่โฆษณา

ตารางอ้างอิง (คลิกเพื่อดาวน์โหลด CSV)

แอปในอุปกรณ์เคลื่อนที่ Android รายการแอปในอุปกรณ์เคลื่อนที่ Android ที่กำหนดเป้าหมายได้พร้อมรหัสแอป รหัสหมวดหมู่ และชื่อแอปที่อ่านได้
ตารางภูมิศาสตร์ ตารางที่ใช้ถอดรหัสช่อง geo_criteria_id ของ BidRequest ดูข้อมูลเพิ่มเติมได้ที่การกำหนดเป้าหมายตามภูมิศาสตร์
ผู้ให้บริการ LGPD รายการผู้ให้บริการการปรับโฆษณาให้เหมาะกับผู้ใช้ที่ได้รับอนุญาตให้แสดงโฆษณาในทราฟฟิก LGPD พร้อมรหัส ชื่อที่อ่านได้ URL ความเป็นส่วนตัว และรายการโดเมน ที่ระบุแหล่งที่มาเป็นผู้ให้บริการได้ การบังคับใช้ LGPD จะระบุไว้ในคำขอราคาเสนอที่กำหนดผ่านช่อง BidRequest.adslot.regs_lgpd ในโปรโตคอลการเสนอราคาของ Authorized Buyers และช่อง BidRequest.regs.ext.lgpd ในโปรโตคอลการเสนอราคา OpenRTB
ผู้ให้บริการเครือข่ายมือถือ รายการผู้ให้บริการเครือข่ายมือถือ
อุปกรณ์เคลื่อนที่ รายการอุปกรณ์เคลื่อนที่
ระบบปฏิบัติการอุปกรณ์เคลื่อนที่ รายการระบบปฏิบัติการอุปกรณ์เคลื่อนที่
ผู้ให้บริการ แมปรหัสผู้ให้บริการการปรับโฆษณาให้เหมาะกับผู้ใช้กับชื่อที่อ่านได้ URL นโยบายความเป็นส่วนตัว และรายการโดเมนที่ระบุแหล่งที่มาเป็นผู้ให้บริการได้ ปัจจุบัน ผู้ให้บริการใช้ในช่อง BidRequest.AdSlot.consented_providers_settings สำหรับโปรโตคอล AdX และ BidRequest.User.UserExt.consented_providers_settings สำหรับโปรโตคอล OpenRTB ในช่องเหล่านี้ ผู้ให้บริการที่ระบุไว้ได้รับความยินยอมจากผู้ใช้ตามที่ ผู้เผยแพร่โฆษณาส่งต่อมาสำหรับผู้ใช้ในประเทศต่างๆ ภายในเขตเศรษฐกิจยุโรป

การตั้งค่าผู้เผยแพร่

ขอไฟล์ publisher-settings.pb.gz จากตัวแทนฝ่ายดูแลลูกค้า

หัวข้อเกี่ยวกับนโยบายการตรวจทานครีเอทีฟโฆษณา

คุณสามารถใช้หัวข้อเกี่ยวกับนโยบายในไฟล์นี้เพื่อกรองครีเอทีฟโฆษณาในระหว่าง การตรวจทานใน Real-time Bidding API

ดาวน์โหลด หัวข้อเกี่ยวกับนโยบายเป็นไฟล์ CSV

อัปเดตล่าสุด: 18 เมษายน 2022