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

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ại creative_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 gdn-vendors.txt.

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