Google 會根據與指定廣告空間相符的廣告請求，將 SegmentRequest 傳送至您的即時精選整合服務。SegmentRequest 物件會提供情境信號或安全信號，您可用於識別 SegmentResponse 中適用於指定廣告空間的區隔。即時精選內容支援以 JSON 格式傳送的 SegmentRequest 和 SegmentResponse 物件。
本指南是即時精選通訊協定的參考資料，可協助您建構整合項目。
SegmentRequest
| 屬性 | 類型 | 說明 |
|---|---|---|
site |
地點 | 僅支援情境式精選合作夥伴。 網站的描述符。如果廣告支援的內容是網站，而非非瀏覽器應用程式，系統就會填入 |
app |
應用程式 | 僅支援情境式精選合作夥伴。 應用程式的描述符。如果廣告支援的內容是應用程式 (而非網站)，系統會填入 |
pub |
發布商 | 僅支援情境式精選合作夥伴。 發布者的描述符。 |
user |
使用者 | 瀏覽發布商內容的使用者描述元，用於發起區隔要求。 |
device |
裝置 | 僅支援情境式精選合作夥伴。 使用者裝置的描述符。 |
segment_ |
字串 | 用於識別區隔要求的專屬 ID，與所有其他區隔要求無關。 |
網站
| 屬性 | 類型 | 說明 |
|---|---|---|
page |
字串 | 僅支援情境式精選合作夥伴。 顯示曝光的網頁網址。 |
應用程式
| 屬性 | 類型 | 說明 |
|---|---|---|
bundle |
字串 | 僅支援情境式精選合作夥伴。 平台專屬的應用程式 ID，應為應用程式專屬。在 Android 上， |
發布商
| 屬性 | 類型 | 說明 |
|---|---|---|
id |
字串 | 僅支援情境式精選合作夥伴。 發布商 ID，由網站資源代碼的發布商代碼後置字元定義。舉例來說，如果發布商的網站資源代碼為 |
使用者
| 屬性 | 類型 | 說明 |
|---|---|---|
consent |
字串 | 從發布商的 IAB 同意聲明管理平台 (CMP) 擷取的網頁安全型 Base64 編碼 IAB 資訊公開和同意聲明架構 (TCF) 第 2 版同意聲明字串。 如果發布商已整合 CMP 以使用資訊公開和同意聲明架構第 2 版，且該 CMP 指出廣告請求適用 GDPR 並提供有效的同意聲明字串，系統就會填入 如要進一步瞭解同意聲明字串中列出的供應商，請參閱 IAB 全球供應商清單：vendor-list.consensu.org/v2/vendor-list.json。 |
eids |
EID 陣列 | 僅適用於安全信號收錄合作夥伴。 擴充 ID 執行個體。 在「精選」中， |
EID
| 屬性 | 類型 | 說明 |
|---|---|---|
source |
字串 | 僅適用於安全信號收錄合作夥伴。 負責提供這組資料的來源或技術供應商。以頂層網域表示。 |
uids |
UID 陣列 | 僅適用於安全信號收錄合作夥伴。 指定來源的 UID 物件陣列。 |
UID
| 屬性 | 類型 | 說明 |
|---|---|---|
id |
字串 | 僅適用於安全信號收錄合作夥伴。 ID。 在精選內容中， |
裝置
| 屬性 | 類型 | 說明 |
|---|---|---|
geo |
地理區域 | 僅支援情境式精選合作夥伴。 使用者裝置的位置。 |
地理區域
| 屬性 | 類型 | 說明 |
|---|---|---|
country |
字串 | 僅支援情境式精選合作夥伴。 國家/地區，採用 ISO-3166-1 Alpha-3 標準。 |
region |
字串 | 僅支援情境式精選合作夥伴。 使用 ISO-3166-2 標準的區域代碼；如果是美國，請使用雙字母的州代碼。 |
metro |
字串 | 僅支援情境式精選合作夥伴。 在 geo-table.csv 檔案中找到 Google 地鐵代碼。 |
SegmentResponse
| 屬性 | 類型 | 說明 |
|---|---|---|
segment |
區隔 陣列 | 區隔的描述元。 |
區隔
| 屬性 | 類型 | 說明 |
|---|---|---|
segment_id |
字串 | 區隔的 ID。這個 ID 應與 Marketplace API curators.dataSegments 資源中區隔名稱的 curatorDataSegmentId 相符。 |