Xem hoặc tải các tệp hỗ trợ Giao thức RTB.
Protos
| 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 | Hãy 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, bằng cách sử dụng bộ mã hoá JSON hoặc Protobuf. Proto này cần thiết nếu bạn sử dụng OpenRTB/Protobuf. Ngoài ra, tài liệu này còn bao gồm tài liệu về các trường được hỗ trợ và mối liên kết với các trường đó với giao thức gốc của Google. | 2.6 | Ngày 23 tháng 3 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.171 | ngày 17/4/2024 |
| publisher-settings.proto | Một nhóm các chế độ cài đặt của nhà xuất bản dành riêng cho mạng bên đặt giá thầu theo thời gian thực. | v.13 | Ngày 5/2/2024 |
| realtime-bidding.proto | Giao thức RTB của 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ùng quảng cáo từ một
lượt hiển thị. |
v.324 | ngày 17/4/2024 |
Protos 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ố tiện ích, được cung cấp trong một proto riêng. | v.174 | ngày 17/4/2024 |
| realtime-bidding.proto | Giao thức RTB của 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ùng quảng cáo từ một
lượt hiển thị. |
v.331 | ngày 17/4/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ả 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 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 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ị. |
| hài lòng | Dùng trong trường advertiser_id của SnippetStatusItem. Trường
này chỉ định nhà quảng cáo mà mẫu quảng cáo liên kết với
đoạn mã đại diện. 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 mà người mua có thể khai báo trên các mẫu quảng cáo không được xuất hiện trong excluded_attribute của
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 | Dùng trong trường cookieMatcherStatusRate của báo cáo hiệu suất liên quan đến Giao thức RTB. Mã hiện có được mô tả trong hướng dẫn về 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ữ | Dùng trong trường hostedMatchStatusRate của báo cáo hiệu suất liên quan đến Giao thức RTB. |
| Không có lý do đặt giá thầu | Các giá trị tiêu chuẩn cho lý do không đặt giá thầu cần cung cấp trong trường BidResponse.no_bid_reason của
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 của tài nguyên PretargetingConfig hiển thị trong API REST 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ẽ xuất hiện 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 có thể loại trừ 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 có được phép sử dụng cookie hay không 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 ngành dọc nào được sử dụng. |
| Mã mạng người bán | Dùng trong trường seller_network_id của BidRequest. Trường này chỉ định mạng người bán chứa
nhà xuất bản. Nội dung của tệp này được sắp xếp theo thứ tự tăng dần
dựa trên giá trị của mã mạng của người bán. |
| 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 nào, chẳng hạn như
Campaign Monitor và VoiceFive, được phép phân phát mẫu quảng cáo,
theo chỉ định của nhà xuất bản. Bao gồm các nhà cung cấp trong tệp từ điển |
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 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 theo 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 theo 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 về quyền riêng tư và danh sách các miền có thể phân bổ cho nhà cung cấp. Việc thực thi LGPD được nêu rõ đối với 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 | Mã nhà cung cấp dịch vụ cá nhân hoá quảng cáo trên Maps với tên dễ đọc, URL chính sách quyền riêng tư và danh sách miền có thể phân bổ cho nhà cung cấp.
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 các trường này, nhà cung cấp trong danh sách có sự đồng ý của người dùng theo thông tin mà nhà xuất bản đưa ra 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ừ đại diện tài khoản của bạn.
Chủ đề chính sách về 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ủ đề 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