Xem hoặc tải các tệp hỗ trợ Giao thức RTB xuống.
Protos
| Tệp | Mô tả | Phiên bản | Ngày cập nhật gần đây nhất |
|---|---|---|---|
| cookie-bulk-upload.proto | Sử dụng thông báo này để tải dữ liệu nhắm mục tiêu theo người dùng lên hàng loạt. | v.24 | Ngày 27 tháng 3 năm 2024 |
| openrtb.proto | Google hỗ trợ giao thức OpenRTB, sử dụng phương thức mã hoá JSON hoặc Protobuf mã hoá. Bạn cần có proto này nếu sử dụng OpenRTB/Protobuf. Proto này cũng bao gồm tài liệu về các trường được hỗ trợ và cách liên kết các trường đó với giao thức gốc của Google. | 2.6 | Ngày 2 tháng 6 năm 2026 |
| openrtb-adx.proto | Giao thức OpenRTB của Google bao gồm một số phần mở rộng, được cung cấp trong một proto riêng. | v.207 | Ngày 13 tháng 4 năm 2026 |
| publisher-settings.proto | Một nhóm chế độ cài đặt dành riêng cho nhà xuất bản đối với mạng lưới công cụ đặt giá thầu theo thời gian thực. | v.14 | Ngày 5 tháng 2 năm 2024 |
Proto Open Beta
| Tệp | Mô tả | Phiên bản | Ngày cập nhật gần đây nhất |
|---|---|---|---|
| openrtb-adx.proto | Giao thức OpenRTB của Google bao gồm một số phần mở rộng, được cung cấp trong một proto riêng. | v.215 | Ngày 13 tháng 4 năm 2026 |
Dữ liệu tham chiếu
Từ điển (Nhấp để tải tệp .txt xuống) |
|
|---|---|
| Danh mục sản phẩm quảng cáo | Được dùng trong trường excluded_product_category của
BidRequest. Trường này mô tả các danh mục sản phẩm và
dịch vụ mà nhà xuất bản không cho phép, ví dụ: nếu nhà xuất bản
không muốn lưu trữ quảng cáo liên quan đến dịch vụ ngân hàng trực tuyến. |
| Danh mục quảng cáo bị hạn chế | Được dùng trong trường allowed_restricted_category của
BidRequest và trường restricted_category của
BidResponse. Trường allowed_restricted_category
mô tả các danh mục thường bị hạn chế, nhưng được nhà xuất bản khai báo rõ ràng là được phép, ví dụ: quảng cáo có chứa nội dung liên quan đến đồ uống có cồn. |
| Danh mục quảng cáo nhạy cảm | Được dùng trong trường excluded_sensitive_category của
BidRequest và trường category của
BidResponse. Trường excluded_sensitive_category
mô tả các danh mục nhạy cảm mà nhà xuất bản không cho phép,
ví dụ: nếu nhà xuất bản không muốn lưu trữ quảng cáo liên quan đến
chính trị. |
| Nhà quảng cáo | Được dùng trong trường advertiser_id của SnippetStatusItem. Trường này chỉ định nhà quảng cáo được đại diện bởi mẫu quảng cáo được liên kết với đoạn mã. Danh sách này phản ánh các nhà quảng cáo trên toàn bộ sàn giao dịch và không
phản ánh các nhà quảng cáo được đại diện bởi bất kỳ người mua nào. |
| Thương hiệu | Danh sách thương hiệu, được dùng trong Client Access API. |
| Thuộc tính quảng cáo mà người mua có thể khai báo | Được dùng cho trường attribute trong BidResponse.
Trường này mô tả các thuộc tính mà người mua có thể khai báo trên quảng cáo và không được xuất hiện trong excluded_attribute trongBidRequest |
| Mã trạng thái chú thích | Mã trạng thái do lệnh gọi phương thức performancereport trả về. |
| Nhãn nội dung | Được dùng trong trường detected_content_labels của
BidRequest. |
| Mã trạng thái trình so khớp cookie | Được dùng trong trường cookieMatcherStatusRate của báo cáo hiệu suất Giao thức RTB. Các mã có sẵn được mô tả trong Hướng dẫn về tính năng so khớp cookie. |
| Mã trạng thái quảng cáo | Được dùng trong creative_status_code được trả về trong ý kiến phản hồi
theo thời gian thực.
|
| Mã trạng thái so khớp được lưu trữ | Được dùng trong trường hostedMatchStatusRate của báo cáo hiệu suất Giao thức RTB. |
| Lý do không đặt giá thầu | Các giá trị lý do không đặt giá thầu tiêu chuẩn sẽ được cung cấp trong trường BidResponse.no_bid_reason trong
giao thức đặt giá thầu của Authorized Buyers. |
| Thuộc tính quảng cáo có thể nhắm mục tiêu trước | Được dùng trong trường supportedCreativeAttribute trong tài nguyên PretargetingConfig được hiển thị trong Buyer API REST. Trường này
mô tả các thuộc tính quảng cáo dự kiến sẽ có trong tất cả quảng cáo
tương ứng với một cấu hình nhắm mục tiêu trước. |
| Thuộc tính quảng cáo mà nhà xuất bản có thể loại trừ | Được dùng trong trường excluded_attribute của
BidRequest. Trường này mô tả các loại quảng cáo mà
không cho phép bởi nhà xuất bản. Ví dụ: nhà xuất bản có thể chỉ định
các hạn chế về việc có được phép sử dụng cookie hay không hoặc có được phép sử dụng quảng cáo dạng văn bản và/hoặc quảng cáo dạng văn bản
hay không. |
| Nhà cung cấp | Được dùng trong trường allowed_vendor_type của
BidRequest. Trường này liệt kê những nhà cung cấp Nội dung đa phương tiện phong phú (chẳng hạn như
Campaign Monitor và VoiceFive) được phép sử dụng cho quảng cáo đang được phân phát,
theo chỉ định của nhà xuất bản. Bao gồm cả các nhà cung cấp trong tệp từ điển đã ngừng hoạt động
|
| Nhà cung cấp dữ liệu | Được dùng trong trường SegmentData.id của
BidRequest. Trường này chứa thông tin về thực thể cung cấp
Tín hiệu do nhà xuất bản cung cấp. |
Bảng tham chiếu (Nhấp để tải tệp CSV xuống) |
|
| Ứng dụng dành cho thiết bị di động Android | Danh sách các ứng dụng dành cho thiết bị di động Android có thể nhắm mục tiêu cùng với mã ứng dụng, mã danh mục, và tên ứng dụng mà con người có thể đọc được. |
| Bảng địa lý | Bảng dùng để giải mã trường geo_criteria_id của
BidRequest. Hãy tham khảo bài viết Nhắm mục tiêu theo địa lý để biết thêm
thông tin. |
| Nhà cung cấp tuân thủ LGPD |
Danh sách các nhà cung cấp dịch vụ cá nhân hoá quảng cáo được phép phân phát trên lưu lượng truy cập tuân thủ LGPD,
cùng với mã, tên mà con người có thể đọc được, URL về quyền riêng tư và danh sách các miền
có thể được phân bổ cho nhà cung cấp. Việc thực thi LGPD được chỉ định trên một yêu cầu giá thầu nhất định thông qua trường BidRequest.adslot.regs_lgpd trong giao thức đặt giá thầu của Authorized Buyers và trường BidRequest.regs.ext.lgpd trong giao thức đặt giá thầu OpenRTB.
|
| Nhà mạng di động | Danh sách nhà mạng di động. |
| Thiết bị di động | Danh sách thiết bị di động. |
| Hệ điều hành trên thiết bị di động | Danh sách hệ điều hành trên thiết bị di động. |
| Nhà cung cấp | Liên kết mã nhà cung cấp dịch vụ cá nhân hoá quảng cáo với tên mà con người có thể đọc được, URL chính sách quyền riêng tư
và danh sách các miền có thể được phân bổ cho nhà cung cấp.
Hiện tại, nhà cung cấp được dùng trong trường
BidRequest.AdSlot.consented_providers_settings cho giao thức AdX
và
BidRequest.User.UserExt.consented_providers_settings cho giao thức OpenRTB. Trong các trường này, các nhà cung cấp được liệt kê có sự đồng ý của người dùng do
nhà xuất bản chuyển cho người dùng ở các quốc gia trong Khu vực kinh tế Châu Âu. |
Cài đặt nhà xuất bản
Yêu cầu tệp publisher-settings.pb.gz từ người đại diện tài khoản của bạn.
Các chủ đề về chính sách xem xét quảng cáo
Bạn có thể sử dụng các chủ đề về chính sách trong tệp này để lọc quảng cáo trong quá trình xem xét trong API đặt giá thầu theo thời gian thực
Tải các chủ đề về chính sách xuống dưới dạng tệp CSV.Ngày cập nhật gần đây nhất: 18 tháng 4 năm 2022