Xem hoặc tải các tệp hỗ trợ Giao thức đặt giá thầu theo thời gian thực 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 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 ánh xạ các trường đó với giao thức gốc của Google. | 2.6 | Ngày 20 tháng 1 năm 2026 |
| openrtb-adx.proto | Giao thức OpenRTB của Google có một số tiện ích được cung cấp trong một proto riêng. | v.206 | Ngày 10 tháng 4 năm 2026 |
| publisher-settings.proto | Một nhóm chế độ cài đặt nhà xuất bản dành riêng cho mạng đặt giá thầu theo thời gian thực. | v.14 | Ngày 5 tháng 2 năm 2024 |
Protos thử nghiệm beta công khai
| 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 có một số tiện ích được cung cấp trong một proto riêng. | v.214 | Ngày 10 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ị. |
| hài lòng | Đượ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 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 mẫu 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 mẫu 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 đặt giá thầu theo thời gian thực. Các mã có sẵn được mô tả trong hướng dẫn So khớp cookie. |
| Mã trạng thái mẫu 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 đặt giá thầu theo thời gian thực. |
| Lý do không đặt giá thầu | Giá trị lý do không đặt giá thầu tiêu chuẩn đượ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 mẫu 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 mẫu quảng cáo dự kiến sẽ có trong tất cả mẫu 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 mẫu 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 mẫu quảng cáo mà
không cho phép nhà xuất bản. Ví dụ: họ có thể chỉ định
các quy định 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 văn bản và/hoặc quảng cáo đa phương tiệ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 dạng thức, chẳng hạn như
Campaign Monitor và VoiceFive, được phép sử dụng cho mẫu 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 nhà cung cấp từ 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. 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 | Ánh xạ 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, các 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 truyề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 mẫu 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 mẫu 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.Cập nhật lần gần đây nhất: Ngày 18 tháng 4 năm 2022