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

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

โพรโตส

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

Protos รุ่นเบต้าแบบเปิด

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