Xem hoặc tải các tệp hỗ trợ Giao thức RTB.
Giao thức
| Tệp | Nội dung 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 phương thức mã hoá JSON hoặc Protobuf. Cần có proto này nếu bạn sử dụng OpenRTB/Protobuf. Ngoài ra, chúng tôi còn cung cấp 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 của Google. | 2.6 | Ngày 22 tháng 5 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.174 | Ngày 21 tháng 5 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 trong một
lượt hiển thị. |
v.328 | Ngày 21 tháng 5 năm 2024 |
Giao thức thử nghiệm beta công khai
| Tệp | Nội dung 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.179 | Ngày 24 tháng 5 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 trong một
lượt hiển thị. |
v.338 | Ngày 24 tháng 5 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 | Dùng trong trường excluded_product_category của BidRequest. Trường này mô tả những danh mục sản phẩm và dịch vụ không được nhà xuất bản cho phép, chẳng hạn như trường hợp nhà xuất bản không muốn lưu trữ các 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 | 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 nhạy cảm của quảng cáo | 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ữ các quảng cáo liên quan đến
chính trị. |
| Nhà quảng cáo | Dùng trong trường advertiser_id của SnippetStatusItem. Trường này chỉ định nhà quảng cáo đại diện theo mẫu 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 các nhà quảng cáo mà bất kỳ người mua nào đạ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 do người mua khai báo trên các mẫu quảng cáo không được xuất hiện trong excluded_attribute trong BidRequest. |
| Mã trạng thái của chú thích | Mã trạng thái được lệnh gọi phương thức performancereport trả về. |
| Nhãn nội dung | 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 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 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 RTB. |
| Không có lý do đặt giá thầu | Bạn cần cung cấp các giá trị tiêu chuẩn về lý do không có giá thầu 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 | Dùng trong trường supportedCreativeAttribute trong tài nguyên PretargetingConfig được hiển thị trong API REST của người mua. 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 duy nhất. |
| Thuộc tính mẫu quảng cáo không dành cho nhà xuất bản | 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 quy định hạn chế về việc cho phép sử dụng cookie hoặc có cho phép quảng cáo nội dung nghe nhìn và/hoặc quảng cáo dạng văn bản hay không. |
| Ngành dọc của nhà xuất bản | 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ẽ hiển thị. Google tạo trường này bằng cách thu thập dữ liệu trên trang và xác định những ngành dọc sẽ được sử dụng. |
| Nhà cung cấp | 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, 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 |
| Nhà cung cấp dữ liệu | 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 ứ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 dùng để giải mã trường geo_criteria_id của BidRequest. Hãy tham khảo phần Nhắm mục tiêu theo địa lý để biết thêm
thông tin. |
| 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 LGPD,
kèm theo mã nhận dạng, tên dễ đọc, URL quyền riêng tư và danh sách các miền
có thể được chỉ định cho nhà cung cấp. Biện pháp thực thi LGPD được nêu rõ trong
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 giá thầu của Authorized Buyers và trường
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 | Liên kết mã nhận dạng 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ể chỉ định cho nhà cung cấp này.
Hiện tại, nhà cung cấp được sử 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 những trường này, những nhà cung cấp trong danh sách đã nhận được sự đồng ý của người dùng (theo như
nhà xuất bản đã chuyển), đối với người dùng ở các quốc gia thuộc 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ủ đề 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 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.Lần cập nhật gần đây nhất: Ngày 18 tháng 4 năm 2022