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

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

Protos

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

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

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

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

พจนานุกรม (คลิกเพื่อดาวน์โหลดไฟล์ .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
ป้ายกำกับเนื้อหา	ใช้ในช่อง 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
ผู้ให้บริการเครือข่ายมือถือ	รายชื่อผู้ให้บริการเครือข่ายมือถือ
อุปกรณ์เคลื่อนที่	รายการอุปกรณ์เคลื่อนที่
ระบบปฏิบัติการบนอุปกรณ์เคลื่อนที่	รายการระบบปฏิบัติการบนอุปกรณ์เคลื่อนที่
ผู้ให้บริการ	แมปรหัสผู้ให้บริการการปรับโฆษณาตามโปรไฟล์ของผู้ใช้กับชื่อที่มนุษย์อ่านได้, 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