瞭解即時精選規格

Google 會根據與指定廣告空間相符的廣告請求,將 SegmentRequest 傳送至您的即時精選整合服務。SegmentRequest 物件會提供脈絡信號或目標對象信號,可用於識別哪些區隔適用於 SegmentResponse 中的指定廣告空間。即時精選內容支援以 JSON 格式傳送的 SegmentRequest 和 SegmentResponse 物件。

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

SegmentRequest

屬性 類型 說明
imp 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 僅支援情境式精選合作夥伴。高度 (以裝置無關像素 (DIP) 為單位)。
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。

使用者

屬性 類型 說明
id 字串 Google 使用者 ID。
buyeruid 字串 透過 Cookie 比對服務上傳的代管比對資料。根據預設,這是以網頁安全的 Base64 編碼指定,且不含填充。如要設定這個欄位,請聯絡客戶經理,即可在不編碼的情況下填入資料。
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 欄位是安全信號。如要進一步瞭解安全信號,請參閱 Ad Manager 的「與出價方和收錄合作夥伴共用安全信號」。

裝置

屬性 類型 說明
geo 地理區域 僅支援情境式精選合作夥伴。使用者裝置的位置。
devicetype int 僅適用於情境式精選合作夥伴。裝置的一般類型。如要進一步瞭解可能的裝置類型,請參閱 AdCOM 1.0 中的「清單:裝置類型」。
os 字串 僅適用於情境式精選合作夥伴。裝置作業系統 (例如「iOS」)。
make 字串 僅支援情境式精選合作夥伴。裝置廠牌 (例如「Apple」)。
ifa 字串 未加密的裝置廣告 ID (未經雜湊處理)。在 Google 的即時精選通訊協定中,這通常是 36 個半形字元的 UUID,其中 Android ID 為小寫,廣告 ID 為大寫。如果是 Samsung 裝置,這些是 32 個字元的英數字元值。

地理區域

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

SegmentResponse

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

區隔

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