Tìm hiểu quy cách tuyển chọn theo thời gian thực
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Google gửi một SegmentRequest dựa trên các yêu cầu quảng cáo khớp với khoảng không quảng cáo được nhắm đến của bạ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 cho giao thức Tuyển chọn theo thời gian thực, có thể giúp bạn xây dựng quy trình tích hợp.
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 site sẽ được điền sẵn nếu nội dung được quảng cáo hỗ trợ là một trang web chứ không phải là một ứng dụng không phải trình duyệt.
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 app sẽ được điền sẵn nếu nội dung được quảng cáo hỗ trợ là một ứng dụng không phải trình duyệt thay vì một trang web.
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_request_id
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.
H.thị
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. Giá trị nhận dạng duy nhất cho lượt hiển thị này trong bối cảnh của yêu cầu phân đoạn. Giá trị bắt đầu từ 1 và tăng lên đến n cho n lượt hiển thị.
Chỉ hỗ trợ đối tác tuyển chọn theo bối cảnh. Trường này được điền sẵn nếu lượt hiển thị được cung cấp dưới dạng một cơ hội phân phát quảng cáo dạng video.
Đối tượng này được điền sẵn bằng các tiện ích cho đối tượng Imp.
Biểu ngữ
Thuộc tính
Loại
Mô tả
w
int
Chỉ hỗ trợ đối tác tuyển chọn theo bối cảnh. Chiều rộng tính bằng pixel độc lập với thiết bị (DIP).
h
int
Chỉ hỗ trợ đối tác tuyển chọn theo bối cảnh. Chiều cao tính bằng số pixel không phụ thuộc vào thiết bị (DIP).
pos
int
Chỉ hỗ trợ đối tác tuyển chọn theo bối cảnh. Vị trí quảng cáo trên màn hình. Để tìm hiểu thêm về các vị trí đặt quảng cáo có thể có, hãy xem Danh sách: Vị trí đặt quảng cáo trong AdCOM 1.0.
Video
Thuộc tính
Loại
Mô tả
w
int
Chỉ hỗ trợ đối tác tuyển chọn theo bối cảnh. Chiều rộng của trình phát video tính bằng pixel độc lập với thiết bị (DIP).
h
int
Chỉ hỗ trợ đối tác tuyển chọn theo bối cảnh. Chiều cao của trình phát video tính bằng pixel độc lập với thiết bị (DIP).
pos
int
Chỉ hỗ trợ đối tác tuyển chọn theo bối cảnh. Vị trí quảng cáo trên màn hình. Để tìm hiểu thêm về các vị trí đặt quảng cáo có thể có, hãy xem Danh sách: Vị trí đặt quảng cáo trong AdCOM 1.0.
ImpExt
Thuộc tính
Loại
Mô tả
gpid
chuỗi
Chỉ hỗ trợ đối tác tuyển chọn theo bối cảnh. Mô tả mã vị trí toàn cầu. Giá trị nhận dạng riêng biệt, cố định, do nhà xuất bản chỉ định, nhất quán trên các đường dẫn cung cấp cho từng đơn vị quảng cáo trên một trang. Hãy xem bài viết này.
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ị.
mobile
int
Chỉ hỗ trợ đối tác tuyển chọn theo bối cảnh. Cho biết trang web đã được lập trình để tối ưu hoá bố cục khi xem trên thiết bị di động hay chưa, trong đó 0 = không, 1 = có.
Ứ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 bundle là tên gói hoặc tên gói. Trên iOS, đây là một mã nhận dạng dạng số.
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ã tài sản web xác định. Ví dụ: một nhà xuất bản có mã tài sản web là ca-pub-123 sẽ có mã nhận dạng được đặt thành pub-123.
Người dùng
Thuộc tính
Loại
Mô tả
consent
chuỗi
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 Cục Quảng cáo tương tác (IAB) được mã hoá bằng base64 an toàn cho web, được tìm nạp từ Nền tảng quản lý sự đồng ý của IAB (CMP) của nhà xuất bản. Trường consent sẽ được điền sẵn nếu nhà xuất bản đã tích hợp với một CMP cho TCF phiên bản 2 và CMP đó cho biết GDPR áp dụng cho yêu cầu quảng cáo và cung cấp một chuỗi hợp lệ về sự đồ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 ý.
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 tính năng Tuyển chọn, trường eids là dữ liệu do nhà xuất bản cung cấp, chẳng hạn như tín hiệu an toàn.
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 miền cấp cao nhất.
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 id là một tín hiệu an toàn. Để tìm hiểu thêm về tín hiệu an toàn, hãy xem bài viết Chia sẻ tín hiệu an toàn với bên đặt giá thầu và đối tác tuyển chọn của Ad Manager.
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.
devicetype
int
Chỉ hỗ trợ đối tác tuyển chọn theo bối cảnh. Loại thiết bị chung. Để tìm hiểu thêm về các loại thiết bị có thể có, hãy xem Danh sách: Các loại thiết bị trong AdCOM 1.0.
os
chuỗi
Chỉ hỗ trợ đối tác tuyển chọn theo bối cảnh. Hệ điều hành của thiết bị (ví dụ: "iOS").
make
chuỗi
Chỉ hỗ trợ đối tác tuyển chọn theo bối cảnh. Thương hiệu thiết bị (ví dụ: "Apple").
Đị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.
city
chuỗi
Chỉ hỗ trợ đối tác tuyển chọn theo bối cảnh. Thành phố sử dụng Mã địa điểm thương mại và vận tải của Liên Hợp Quốc.
Mã nhận dạng của phân khúc. Mã nhận dạng này 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.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2026-03-31 UTC."],[],[]]
