Google gửi một SegmentRequest dựa trên các yêu cầu quảng cáo phù hợp với khoảng không quảng cáo được nhắm đến cho chế độ tích hợp Sắp xếp theo thời gian thực. Đối tượng SegmentRequest cung cấp tín hiệu theo bối cảnh hoặc tín hiệu an toàn mà bạn có thể dùng để xác định phân khúc nào của bạn áp dụng cho khoảng không quảng cáo đã cho trong SegmentResponse.
Tính năng tuyển chọn theo thời gian thực hỗ trợ các đối tượng SegmentRequest và SegmentResponse được gửi ở định dạng JSON.
Hướng dẫn này là tài liệu tham khảo về giao thức Sắp xếp theo thời gian thực, có thể giúp bạn xây dựng quy trình tích hợp.
SegmentRequest
| Thuộc tính | Loại | Mô tả |
|---|---|---|
site |
Trang web | Chỉ hỗ trợ đối tác tuyển chọn theo bối cảnh. Thông tin mô tả về trang web. Trường |
app |
Ứng dụng | Chỉ hỗ trợ đối tác tuyển chọn theo bối cảnh. Thông tin mô tả về ứng dụng. Trường |
pub |
Nhà xuất bản | Chỉ hỗ trợ đối tác tuyển chọn theo bối cảnh. Thông tin mô tả về nhà xuất bản. |
user |
Người dùng | Một giá trị mô tả về người dùng duyệt xem nội dung của nhà xuất bản đã bắt đầu yêu cầu phân đoạn. |
device |
Thiết bị | Chỉ hỗ trợ đối tác tuyển chọn theo bối cảnh. Một giá trị mô tả về thiết bị của người dùng. |
segment_ |
chuỗi | Giá trị nhận dạng duy nhất dùng để xác định yêu cầu phân đoạn độc lập với tất cả các yêu cầu phân đoạn khác. |
Trang web
| Thuộc tính | Loại | Mô tả |
|---|---|---|
page |
chuỗi | Chỉ hỗ trợ đối tác tuyển chọn theo bối cảnh. URL của trang hiển thị lượt hiển thị. |
Ứng dụng
| Thuộc tính | Loại | Mô tả |
|---|---|---|
bundle |
chuỗi | Chỉ hỗ trợ đối tác tuyển chọn theo bối cảnh. Giá trị nhận dạng ứng dụng dành riêng cho nền tảng, được thiết kế để chỉ có một ứng dụng. Trên Android, trường |
Nhà xuất bản
| Thuộc tính | Loại | Mô tả |
|---|---|---|
id |
chuỗi | Chỉ hỗ trợ đối tác tuyển chọn theo bối cảnh. Mã nhà xuất bản do hậu tố mã nhà xuất bản của mã thuộc tính web xác định. Ví dụ: một nhà xuất bản có mã thuộc tính web là |
Người dùng
| Thuộc tính | Loại | Mô tả |
|---|---|---|
consent |
chuỗi | Một chuỗi về sự đồng ý theo Khuôn khổ về tính minh bạch và sự đồng ý (TCF) phiên bản 2 của IAB được mã hoá base64 an toàn cho web, được tìm nạp từ Nền tảng quản lý sự đồng ý (CMP) của IAB của nhà xuất bản. Trường Hãy xem Danh sách nhà cung cấp toàn cầu của IAB tại vendor-list.consensu.org/v2/vendor-list.json để biết thông tin chi tiết về các nhà cung cấp có trong chuỗi về sự đồng ý. |
eids |
Mảng EID | Chỉ được hỗ trợ cho đối tác tuyển chọn tín hiệu an toàn. Các thực thể mã nhận dạng mở rộng. Trong phần Tuyển chọn, trường |
EID (mã định danh dành cho eSIM)
| Thuộc tính | Loại | Mô tả |
|---|---|---|
source |
chuỗi | Chỉ được hỗ trợ cho đối tác tuyển chọn tín hiệu an toàn. Nguồn hoặc nhà cung cấp công nghệ chịu trách nhiệm về bộ dữ liệu được đưa vào. Được biểu thị dưới dạng một miền cấp cao nhất. |
uids |
Mảng UID | Chỉ được hỗ trợ cho đối tác tuyển chọn tín hiệu an toàn. Mảng các đối tượng UID từ nguồn đã cho. |
UID
| Thuộc tính | Loại | Mô tả |
|---|---|---|
id |
chuỗi | Chỉ được hỗ trợ cho đối tác tuyển chọn tín hiệu an toàn. Giá trị nhận dạng. Trong hoạt động tuyển chọn, trường |
Thiết bị
| Thuộc tính | Loại | Mô tả |
|---|---|---|
geo |
Địa lý | Chỉ hỗ trợ đối tác tuyển chọn theo bối cảnh. Vị trí của thiết bị người dùng. |
Địa lý
| Thuộc tính | Loại | Mô tả |
|---|---|---|
country |
chuỗi | Chỉ hỗ trợ đối tác tuyển chọn theo bối cảnh. Quốc gia sử dụng tiêu chuẩn ISO-3166-1 Alpha-3. |
region |
chuỗi | Chỉ hỗ trợ đối tác tuyển chọn theo bối cảnh. Mã khu vực theo tiêu chuẩn ISO-3166-2; mã tiểu bang gồm 2 chữ cái nếu là Hoa Kỳ. |
metro |
chuỗi | Chỉ hỗ trợ đối tác tuyển chọn theo bối cảnh. Mã vùng đô thị của Google có trong tệp geo-table.csv. |
SegmentResponse
| Thuộc tính | Loại | Mô tả |
|---|---|---|
segment |
Mảng phân đoạn | Một phần mô tả cho phân đoạn. |
Phân đoạn
| Thuộc tính | Loại | Mô tả |
|---|---|---|
segment_id |
chuỗi | Mã nhận dạng của phân khúc. Mã nhận dạng phải khớp với curatorDataSegmentId có trong tên của phân khúc trong tài nguyên curators.dataSegments của Marketplace API. |