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

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

Protos

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

Open Beta Protos

ไฟล์ คำอธิบาย เวอร์ชัน อัปเดตล่าสุด
openrtb-adx.proto โปรโตคอล OpenRTB ของ Google มีส่วนขยายบางอย่างซึ่งอยู่ใน Proto แยกต่างหาก v.200 21 ก.ค. 2025

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

พจนานุกรม (คลิกเพื่อดาวน์โหลดไฟล์ .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 ฟิลด์นี้อธิบายประเภทของครีเอทีฟโฆษณาที่ ผู้เผยแพร่โฆษณาไม่อนุญาต เช่น อาจระบุข้อจำกัดว่าอนุญาตให้ใช้คุกกี้หรือไม่ หรืออนุญาตให้แสดงโฆษณา สื่อและ/หรือโฆษณาแบบข้อความหรือไม่
ธุรกิจเฉพาะกลุ่มของผู้เผยแพร่โฆษณา ใช้ในฟิลด์ detected_vertical ของ BidRequest ฟิลด์นี้ระบุหมวดหมู่ (คล้ายกับ คีย์เวิร์ด) ของหน้าเว็บที่จะแสดงโฆษณา Google สร้างฟิลด์นี้ โดยการ Crawl หน้าเว็บและพิจารณาว่าใช้หมวดหมู่ใด
ผู้ให้บริการ ใช้ในฟิลด์ 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