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 mục tiêu của bạn đến 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 về đối tượng 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 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 riêng biệ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 riêng biệt của 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. Một 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 mỗi đơ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ó được lập trình để tối ưu hoá bố cục khi xem trên thiết bị di động hay không, 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ỉ dành riêng cho ứ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 bằ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ả
id
chuỗi
Mã nhận dạng người dùng Google.
buyeruid
chuỗi
Dữ liệu so khớp được lưu trữ được tải lên bằng Dịch vụ so khớp cookie. Theo mặc định, tham số này được chỉ định trong phương thức mã hoá base64 an toàn cho web mà không có khoảng đệm. Bạn có thể tuỳ ý định cấu hình trường này để được điền sẵn mà không cần mã hoá bằng cách liên hệ với người quản lý tài khoản của mình.
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 IAB được mã hoá theo 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 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 các đối tác tuyển chọn đối tượng. Các thực thể mã nhận dạng mở rộng. Trong Curation, trường eids là dữ liệu mà 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 các đối tác tuyển chọn đối tượng. 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 các đối tác tuyển chọn đối tượng. 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 các đối tác tuyển chọn đối tượng. 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. Hãng sản xuất thiết bị (ví dụ: "Apple").
ifa
chuỗi
Mã nhận dạng cho quảng cáo trên thiết bị chưa mã hoá (chưa băm). Trong giao thức Sắp xếp theo thời gian thực của Google, đây thường là một UUID gồm 36 ký tự, trong đó mã nhận dạng Android là chữ thường và IDFA là chữ hoa. Đối với thiết bị Samsung, đây là các giá trị chữ và số gồm 32 ký tự.
Đị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 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-09-23 UTC."],[],[]]