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

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

Protos

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

Open Beta Protos

ไฟล์ คำอธิบาย เวอร์ชัน อัปเดตครั้งล่าสุด
openrtb-adx.proto โปรโตคอล OpenRTB ของ Google มีส่วนขยายบางอย่างซึ่งมีให้ใน proto แยกต่างหาก v.220 16 ก.ย. 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
รหัสสถานะ Cookie Matcher ใช้ในฟิลด์ 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
ผู้ให้บริการเครือข่ายมือถือ รายการผู้ให้บริการเครือข่ายมือถือ
อุปกรณ์เคลื่อนที่ รายการอุปกรณ์เคลื่อนที่
ระบบปฏิบัติการบนมือถือ รายการระบบปฏิบัติการบนมือถือ
ผู้ให้บริการ แมปรหัสผู้ให้บริการการปรับโฆษณาตามโปรไฟล์ของผู้ใช้ใน Maps กับชื่อที่อ่านได้ 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