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

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

Protos

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

Open Beta Protos

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