瞭解即時精選規格

Google 會根據與指定廣告空間相符的廣告請求，將 SegmentRequest 傳送至您的即時精選整合服務。SegmentRequest 物件會提供脈絡信號或安全信號，您可藉此判斷 SegmentResponse 中有哪些區隔適用於指定廣告空間。即時精選內容支援以 JSON 格式傳送的 SegmentRequest 和 SegmentResponse 物件。

本指南是即時精選通訊協定的參考資料，可協助您建構整合功能。

SegmentRequest

屬性 類型 說明
imp 曝光陣列 僅支援情境式精選合作夥伴。代表所提供的曝光商機。
site 地點 僅支援情境式精選合作夥伴。網站的描述符。如果廣告支援的內容是網站，而非非瀏覽器應用程式，系統就會填入 site 欄位。
app 應用程式 僅支援情境式精選合作夥伴。應用程式的描述符。如果廣告支援的內容是應用程式 (而非網站)，系統會填入 app 欄位。
pub 發布商 僅支援情境式精選合作夥伴。發布者的描述符。
user 使用者 瀏覽發布商內容的使用者描述元，發起了區隔要求。
device 裝置 僅支援情境式精選合作夥伴。使用者裝置的描述符。
segment_request_id 字串 用於獨立識別區隔要求的專屬 ID，與所有其他區隔要求無關。

曝光

屬性 類型 說明
id 字串 僅支援情境式精選合作夥伴。在區隔要求的情境中，這個曝光的專屬 ID。值從 1 開始，並針對 n 次曝光遞增至 n。
banner 橫幅 僅支援情境式精選合作夥伴。如果曝光是做為橫幅廣告商機提供，系統會填入這個欄位。
video 影片 僅支援情境式精選合作夥伴。如果曝光是做為影片廣告商機提供，系統就會填入這個欄位。
ext ImpExt 這個欄位會填入 Imp 物件的擴充功能。

橫幅廣告

屬性 類型 說明
w int 僅支援情境式精選合作夥伴。寬度 (以裝置獨立像素為單位)。
h int 僅支援情境式精選合作夥伴。高度 (以裝置無關像素為單位)。
pos int 僅支援情境式精選合作夥伴。畫面上的廣告位置。如要進一步瞭解可能的刊登位置，請參閱 AdCOM 1.0 中的「清單：刊登位置」。

影片

屬性 類型 說明
w int 僅支援情境式精選合作夥伴。影片播放器的寬度 (以裝置獨立像素為單位)。
h int 僅支援情境式精選合作夥伴。影片播放器的高度 (以裝置獨立像素為單位)。
pos int 僅支援情境式精選合作夥伴。畫面上的廣告位置。如要進一步瞭解可能的刊登位置，請參閱 AdCOM 1.0 中的「清單：刊登位置」。

ImpExt

屬性 類型 說明
gpid 字串 僅支援情境式精選合作夥伴。說明全域刊登位置 ID。發布商指定的專屬持續性 ID，在網頁上每個廣告單元的供應路徑中保持一致。請參閱這篇文章。

網站

屬性 類型 說明
page 字串 僅支援情境式精選合作夥伴。顯示曝光的網頁網址。
mobile int 僅支援情境式精選合作夥伴。指出網站是否已進行程式設計，以便在行動裝置上瀏覽時最佳化版面配置，其中 0 = 否，1 = 是。

應用程式

屬性 類型 說明
bundle 字串 僅支援情境式精選合作夥伴。平台專屬的應用程式 ID，應為應用程式專屬。在 Android 上，bundle 欄位是軟體包或套件名稱。在 iOS 平台上，這通常是數字 ID。

發布商

屬性 類型 說明
id 字串 僅支援情境式精選合作夥伴。發布商 ID，由網站資源代碼的發布商代碼後置字元定義。舉例來說，如果發布商的網站資源代碼為 ca-pub-123，則 ID 會設為 pub-123。

使用者

屬性 類型 說明
consent 字串 從發布商的 IAB 同意聲明管理平台 (CMP) 擷取的網頁安全 base64 編碼 IAB 資訊公開和同意聲明架構 (TCF) 第 2 版同意聲明字串。如果發布商已整合資訊公開和同意聲明架構第 2 版的 CMP，且該 CMP 指出廣告請求適用 GDPR 並提供有效的同意聲明字串，系統就會填入 consent 欄位。如要進一步瞭解同意聲明字串中列出的供應商，請參閱 IAB 全球供應商清單：vendor-list.consensu.org/v2/vendor-list.json。
eids EID 陣列 僅適用於安全信號收錄合作夥伴。擴充 ID 執行個體。在「精選」中，eids 欄位是發布商提供的資料，例如安全信號。

EID

屬性 類型 說明
source 字串 僅適用於安全信號收錄合作夥伴。負責提供所含資料的來源或技術供應商。以頂層網域表示。
uids UID 陣列 僅適用於安全信號收錄合作夥伴。指定來源的 UID 物件陣列。

UID

屬性 類型 說明
id 字串 僅適用於安全信號收錄合作夥伴。ID。在精選內容中，id 欄位是安全信號。如要進一步瞭解安全信號，請參閱 Ad Manager 的「與出價方和收錄合作夥伴共用安全信號」。

裝置

屬性 類型 說明
geo 地理區域 僅支援情境式精選合作夥伴。使用者裝置的位置。
devicetype int 僅支援情境式精選合作夥伴。裝置的一般類型。如要進一步瞭解可能的裝置類型，請參閱 AdCOM 1.0 中的「清單：裝置類型」。
os 字串 僅支援情境式精選合作夥伴。裝置作業系統 (例如「iOS」)。
make 字串 僅支援情境式精選合作夥伴。裝置廠牌 (例如「Apple」)。

地理區域

屬性 類型 說明
country 字串 僅支援情境式精選合作夥伴。使用 ISO-3166-1 Alpha-3 標準的國家/地區。
region 字串 僅支援情境式精選合作夥伴。使用 ISO-3166-2 標準的區域代碼；如果是美國，請使用 2 個字母的州代碼。
metro 字串 僅支援情境式精選合作夥伴。在 geo-table.csv 檔案中找到 Google 都會區代碼。
city 字串 僅支援情境式精選合作夥伴。使用聯合國貿易和運輸地點代碼的城市。

SegmentResponse

屬性 類型 說明
segment 區隔陣列 區隔的描述元。

區隔

屬性 類型 說明
segment_id 字串 區隔的 ID。ID 應與 Marketplace API curators.dataSegments 資源中區隔名稱的 curatorDataSegmentId 相符。