Xem hoặc tải các tệp hỗ trợ Giao thức RTB.
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 hàng loạt dữ liệu nhắm mục tiêu theo 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. Bạn cần có proto này nếu 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 31 tháng 10 năm 2024 |
| openrtb-adx.proto | Giao thức OpenRTB của Google bao gồm một số tiện ích, được cung cấp trong một proto riêng. | v.180 | Ngày 1 tháng 11 năm 2024 |
| publisher-settings.proto | Một nhóm chế độ cài đặt dành riêng cho nhà xuất bản cho một mạng 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ị trí quảng cáo từ một lượt hiển thị. |
v.331 | Ngày 1 tháng 11 năm 2024 |
Bản dựng 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ố tiện ích, được cung cấp trong một proto riêng. | v.186 | Ngày 1 tháng 11 năm 2024 |
| realtime-bidding.proto | Giao thức RTB Authorized Buyers của Google. Đây là thông báo mà Google sử dụng để yêu cầu giá thầu. BidRequest bao gồm vị trí quảng cáo từ một lượt hiển thị. |
v.342 | Ngày 31 tháng 10 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à 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 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ữ 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 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 nền tảng trao đổi và không phản ánh các nhà quảng cáo do một người mua đại diện. |
| Thương hiệu | Danh sách thương hiệu, được 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 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 trong BidRequest. |
| Mã trạng thái 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 | Đượ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 báo cáo hiệu suất về 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 phản hồi theo thời gian thực.
|
| Mã trạng thái của mố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 về Giao thức RTB. |
| Không có lý do đặ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 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 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. |
| Cá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
không được nhà xuất bản cho phép. Ví dụ: các chính sách này 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 có cho phép quảng cáo dạng văn bản và/hoặc quảng cáo dạng nội dung nghe nhì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ẽ xuất hiện. 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 phân phát mẫu quảng cáo,
theo quy định của nhà xuất bản. Bao gồm các nhà cung cấp trong 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ề 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 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 vị trí địa lý để biết thêm thông tin. |
| Nhà cung cấp tuân thủ LGPD |
Danh sách nhà cung cấp 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ã nhận dạng, tên mà con người có thể đọc được, URL về quyền riêng tư và danh sách miền có thể được phân bổ cho nhà cung cấp đó. Việc thực thi LGPD được chỉ báo 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 giá thầu 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 dành cho thiết bị di động. |
| Nhà cung cấp | Ánh xạ mã nhận dạng nhà cung cấp dịch vụ cá nhân hoá quảng cáo với một 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 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 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 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.
Chủ đề về chính sách trong quy trình xem xét 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ủ đề 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