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

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

โพรโตส

ไฟล์ คำอธิบาย เวอร์ชัน อัปเดตครั้งล่าสุด
cookie-bulk-upload.arial ใช้ข้อความนี้เพื่ออัปโหลดข้อมูลการกำหนดเป้าหมายผู้ใช้จำนวนมาก v.24 27 มี.ค. 2024
openrtb.proto Google รองรับโปรโตคอล OpenRTB โดยใช้การเข้ารหัส JSON หรือ Protobuf โปรโตคอลนี้จำเป็นหากคุณใช้ OpenRTB/Protobuf และยังมีเอกสารประกอบเกี่ยวกับช่องที่รองรับและการแมปช่องกับโปรโตคอลเนทีฟของ Google ด้วย 2.6 23 มี.ค. 2024
openrtb-adx.proto โปรโตคอล OpenRTB ของ Google มีส่วนขยายบางรายการ ซึ่งมีให้ในโปรโตคอลที่แยกต่างหาก v.171 17 เม.ย. 2024
publisher-settings.โปรโตคอล ชุดการตั้งค่าของผู้เผยแพร่โฆษณาสำหรับเครือข่ายโปรแกรมเสนอราคาแบบเรียลไทม์โดยเฉพาะ v.13 5 ก.พ. 2024
realtime-bidding.proto โปรโตคอล RTB ของ Authorized Buyers ของ Google นี่คือข้อความที่ Google ใช้ เพื่อขอราคาเสนอ BidRequest ประกอบด้วยช่องโฆษณาจากการแสดงผลครั้งเดียว v.324 17 เม.ย. 2024

โปรโตคอลเบต้าแบบเปิด

ไฟล์ คำอธิบาย เวอร์ชัน อัปเดตครั้งล่าสุด
openrtb-adx.proto โปรโตคอล OpenRTB ของ Google มีส่วนขยายบางรายการ ซึ่งมีให้ในโปรโตคอลที่แยกต่างหาก v.174 17 เม.ย. 2024
realtime-bidding.proto โปรโตคอล RTB ของ Authorized Buyers ของ Google นี่คือข้อความที่ Google ใช้ เพื่อขอราคาเสนอ BidRequest ประกอบด้วยช่องโฆษณาจากการแสดงผลครั้งเดียว v.331 17 เม.ย. 2024

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

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

รวมผู้ให้บริการจากไฟล์พจนานุกรม gdn-vendors.txt ที่หยุดให้บริการ

ตารางอ้างอิง (คลิกเพื่อดาวน์โหลด 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