Protos và amp; dữ liệu tham chiếu

Xem hoặc tải những 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 lên hàng loạt dữ liệu nhắm đến người dùng. 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. Proto này là cần thiết nếu bạn sử dụng OpenRTB/Protobuf. Tài liệ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 của Google. 2.6 Ngày 11 tháng 8 năm 2025
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 biệt. v.192 21/7/2025
publisher-settings.proto Một nhóm chế độ cài đặt của 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

Open Beta Protos

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 biệt. v.200 21/7/2025

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ị.
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 do mẫu quảng cáo đại diện đượ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 toàn bộ Ad Exchange và không phản ánh các nhà quảng cáo do bất kỳ người mua nào đại diện.
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 trong BidRequest.
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 của công cụ 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 của mẫu quảng cáo

Được dùng trong

creative_status_code được trả lại trong ý kiến phản hồi theo thời gian thực.
Mã trạng thái trận đấu đượ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.
Lý do không đặt giá thầu Các giá trị lý do không đặt giá thầu tiêu chuẩn sẽ được đưa ra trong trường BidResponse.no_bid_reason trong giao thức giá thầu 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 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ẽ 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 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 mà nhà xuất bản không cho phép. Ví dụ: họ có thể chỉ định các 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 dạng văn bản và/hoặc quảng cáo đa phương tiện hay không.
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 danh mục 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 trang và xác định những danh mục dọc đượ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ê 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 trong tệp từ điển gdn-vendors.txt không còn được dùng nữa.
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 các ứng dụng di động Android có thể nhắm đến 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. 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 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ã nhận dạng, tên dễ đọ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 biểu thị 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 của Authorized Buyers và trường BidRequest.regs.ext.lgpd trong giao thức giá thầu của 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 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ận dạng nhà cung cấp dịch vụ cá nhân hoá quảng cáo trên Maps với một tên dễ đọc, một URL chính sách quyền riêng tư và một 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, những 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 thuộc Khu vực kinh tế Châu Âu.

Cài đặt nhà xuất bản

Yêu cầu người đại diện tài khoản của bạn cung cấp tệp publisher-settings.pb.gz.

Các chủ đề về chính sách đá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 Real-time Bidding API

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