Xem hoặc tải các tệp hỗ trợ Giao thức RTB.
Giao thức
| 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 hàng loạt dữ liệu nhắm mục tiêu người dùng lên. | v.24 | Ngày 27 tháng 3 năm 2024 |
| openrtb.proto | Google hỗ trợ giao thức OpenRTB, sử dụng JSON hoặc Protobuf mã hoá. Cần có proto này nếu bạn sử dụng OpenRTB/Protobuf. Điều này cũng bao gồm tài liệu về các trường được hỗ trợ và mối liên kết của các trường đó với giao thức gốc. | 2.6 | Ngày 1 tháng 8 năm 2024 |
| 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.177 | Ngày 6 tháng 8 năm 2024 |
| publisher-settings.proto | Một nhóm các chế độ cài đặt dành riêng cho nhà xuất bản trên mạng của bên đặt giá thầu theo thời gian thực. | v.13 | Ngày 5 tháng 2 năm 2024 |
| realtime-bidding.proto | Giao thức RTB của Authorized Buyers do Google cung cấp. Đây là thông báo mà Google sử dụng
để yêu cầu giá thầu. BidRequest bao gồm vùng quảng cáo từ một
một lần hiển thị. |
v.330 | Ngày 6 tháng 8 năm 2024 |
Giao thức 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 bao gồm một số phần mở rộng, được cung cấp trong một proto riêng. | v.182 | Ngày 6 tháng 8 năm 2024 |
| realtime-bidding.proto | Giao thức RTB của Authorized Buyers do Google cung cấp. Đây là thông báo mà Google sử dụng
để yêu cầu giá thầu. BidRequest bao gồm vùng quảng cáo từ một
một lần hiển thị. |
v.340 | Ngày 6 tháng 8 năm 2024 |
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à
các dịch vụ không được nhà xuất bản 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 ngân hàng trực tuyến. |
| Danh mục bị hạn chế quảng cáo | Được dùng trong trường allowed_restricted_category của
BidRequest và trường restricted_category của
BidResponse. allowed_restricted_category
trường mô tả các danh mục thường bị hạn chế, nhưng được nêu rõ ràng
được nhà xuất bản khai báo là được phép, ví dụ: quảng cáo chứa
nội dung liên quan đến rượu. |
| Danh mục nhạy cảm của quảng cáo | Được dùng trong trường excluded_sensitive_category của
BidRequest và trường category của
BidResponse. 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ữ các quảng cáo có liên quan đến
chính trị. |
| Nhà quảng cáo | Dùng trong trường advertiser_id của SnippetStatusItem. Chiến dịch này
trường chỉ định nhà quảng cáo mà quảng cáo 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 nhà quảng cáo do một người mua bất kỳ đại diện. |
| Thương hiệu | Danh sách thương hiệu được sử dụng trong API Truy cập ứng dụng. |
| Thuộc tính mẫu quảng cáo có thể khai báo của người mua | Dùng cho trường attribute trong BidResponse.
Trường này mô tả các thuộc tính có thể khai báo của người mua trên mẫu quảng cáo phải
không xuất hiện ở excluded_attribute trong
BidRequest. |
| Mã trạng thái của chú thích | Mã trạng thái được 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 của trình so khớp cookie | Được dùng trong trường cookieMatcherStatusRate của Giao thức RTB
báo cáo hiệu suất. Các mã hiện có được mô tả trong phần So khớp cookie
của chúng tôi. |
| Mã trạng thái mẫu quảng cáo | Được dùng trong Đã trả lạicreative_status_code trong thời gian thực
ý kiến phản hồi.
|
| Mã trạng thái so khớp được lưu trữ | Được dùng trong trường hostedMatchStatusRate của Giao thức RTB
báo cáo hiệu suất. |
| Không có lý do đặt giá thầu | Các giá trị lý do không có giá thầu tiêu chuẩn được cung cấp trong trường BidResponse.no_bid_reason trong
Giao thức 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 REST API. 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 không dành cho nhà xuất bản | Đượ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
không được nhà xuất bản cho phép. Ví dụ: họ có thể chỉ định
các hạn chế về việc có cho phép sử dụng cookie hay không hoặc việc có cho phép nội dung nghe nhìn và/hoặc văn bản
quảng cáo được phép. |
| Ngành dọc của nhà xuất bản | Được dùng trong trường detected_vertical của
BidRequest. Trường này chỉ định các ngành dọc (tương tự như
từ khoá) của trang mà quảng cáo sẽ được hiển thị. Google tạo
bằng cách thu thập dữ liệu trang và xác định ngành dọc nào sẽ được sử dụng. |
| Nhà cung cấp | Được dùng trong trường allowed_vendor_type của
BidRequest. Trường này liệt kê các nhà cung cấp Nội dung đa phương tiện, chẳng hạn như
Campaign Monitor và VoiceFive, được phép
đối với 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 bị ngừng cung cấp
Tệp từ điển |
| 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ề pháp nhân đã 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 ứng dụng di động Android có thể nhắm mục tiêu kèm theo 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 được sử dụng để giải mã trường geo_criteria_id của
BidRequest. Tham khảo Nhắm mục tiêu theo địa lý để biết thêm
của bạn. |
| Nhà cung cấp 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 theo Luật chung về việc bảo vệ dữ liệu cá nhân (LGPD),
kèm theo mã nhận dạng, tên mà con người có thể đọc được, URL quyền riêng tư và danh sách miền
có thể được phân bổ cho nhà cung cấp. Thực thi LGPD được biểu thị trên
yêu cầu giá thầu nhất định thông qua BidRequest.adslot.regs_lgpd
trong giao thức giá thầu Authorized Buyers và
BidRequest.regs.ext.lgpd trong giao thức 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 dễ đọc, là quyền riêng tư
URL chính sách của Google và danh sách các miền có thể được gán 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 AdX
giao thức và
BidRequest.User.UserExt.consented_providers_settings cho OpenRTB
giao thức. Trong các trường này, các nhà cung cấp được liệt kê đã được người dùng đồng ý
nhà xuất bả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ừ tài khoản của bạn
của chúng tôi.
Các chủ đề chính sách về đánh giá mẫu quảng cáo
Bạn có thể sử dụng các chủ đề chính sách trong tệp này để lọc mẫu quảng cáo trong khoảng thời gian xem lại trong API Đặt giá thầu theo thời gian thực
Tải xuống các chủ đề chính sách dưới dạng tệp CSV.Lần cập nhật gần đây nhất: Ngày 18 tháng 4 năm 2022