Cookie 比對功能可讓您將 Cookie 與 例如,瀏覽網站使用者的 ID 出價工具專屬的 Google 使用者 ID,並建立使用者名單 更有效的出價選擇本指南將說明 Cookie 中使用的概念 比對功能及不同的 Cookie 比對工作流程,以及任何變化版本 或是特定用途
概念
什麼是 Cookie 比對?
網域擁有者通常會為瀏覽的使用者設定 Cookie 內容 並用來識別該網域內的使用者。即使兩個 網域擁有者另外同意交換這類資料,也就是安全性模型 的網際網路瀏覽器限制使用者讀取另一個瀏覽器設定的 Cookie 網域。
在數位廣告的情境中,Google 會使用 Cookie 來識別使用者
和出價方都屬於 doubleclick.net
網域
參與「即時出價」時,可能擁有自己的網域
找出一組想顯示廣告的使用者。Cookie 比對
出價工具可讓出價工具將他們的 Cookie 與 Google 的 Cookie 進行比對,
判斷透過出價要求傳送的曝光是否與其中一個
指定的使用者,會收到他們自己的 Cookie 資料或
出價工具專用的 Google 使用者 ID
出價要求中有 doubleclick.net
個 Cookie。
本指南介紹的 Cookie 比對服務有助於建立 出價方的 Cookie 與 Google 之間的關聯 User-ID,也能用來填入使用者名單。
對照表
對照表可用來將某個網域的 ID 或其他資料對應至 另一個例子。出價方可以使用 Cookie 比對服務自行填入資料 會將特定使用者的 Cookie 對應到使用者的 Google 使用者 ID,或是填入 Google 代管的對照表。對照表是 出價工具應用程式存取使用者 Cookie 資料時所需的 是否會影響放送次數
Google 代管的對照表
簡化維護工作、縮短延遲時間,並取得比對資料 某些地區的使用者,則建議您允許 Google 代管 對照表。可讓您指定網頁安全 Base64 編碼字串。 本文稱為代管比對資料,以對應至 特定使用者的 Google 使用者 ID。比對建立完成後 定義如下:
即時出價:在後續的曝光出價要求中 Google 會將代管比對資料傳送給您 與使用者 Google 使用者 ID 進行比對如果已設定出價端點 使用 Google 即時出價通訊協定,您會收到經過解碼的位元組
BidRequest.hosted_match_data
欄位。在 Google 的 OpenRTB 中 實作,BidRequest.user.buyeruid
會傳回 做為網頁安全的 base64 編碼字串。使用者名單:可填入使用者名單 搭配 Google 使用者 ID 或代管比對資料。
- 預先指定: 您可以設定預先指定,只接收出價要求 包含代管比對資料。這類資訊可用來排除關聯性較低的部分 來自 Cookie 空間之外使用者的曝光次數
使用者名單
您可以使用即時出價 API 建立及管理使用者名單。 建立完成後,您可以使用 Cookie 比對工作流程填入這些名單 下述,或透過大量上傳程式服務。
開始使用
開始使用 Cookie 比對時,您必須與 客戶技術顧問,能啟用特定工作流程並提供協助 設定下列項目:
- Cookie 比對聯播網 ID (NID):用來識別唯一識別碼的字串 ID 用於進行 Cookie 比對和其他相關作業的出價工具帳戶。
- Cookie 比對網址:可接受接受的端點的基準網址。 並在 Cookie 比對工作流程中處理傳入的請求。 出價方可以將巨集嵌入這個網址, 控制在 Cookie 比對工作流程中傳遞至該參數的參數順序。
- 比對代碼:代碼必須放置在使用者的瀏覽器中,才能 由出價工具發起的 Cookie 比對工作流程這可以與廣告一起放送 或刊登在廣告以外的網站資源
- Cookie 比對報表網址 (選用):採用單向 Cookie 比對工作流程,則是可以提供給使用者的選用網址。 指定會在 Cookie 發生時收到錯誤詳細資料的端點 比對失敗,卻透過 HTTP 302 重新導向。根據預設,回應只會 就會傳送至這個網址。 但出價方可能會要求一律傳送重新導向。
- Cookie 比對輔助網址:對於導入 Cookie 比對輔助工作流程,這就是 要回應傳入要求的端點基準網址。
- Cookie 比對輔助配額:對於導入 Cookie 比對輔助工作流程,這就是 Cookie 比對網址可接收的廣告請求數量上限 第二。這是為了防止 CMA 要求超載 交換伺服器
Cookie 比對巨集
在任何支援的 Cookie 比對工作流程中 出價方的 Cookie 比對網址通常會在 無保證訂單。有整合機制所需的出價方 參數順序可以在其 Cookie 比對網址中放置巨集, 保證廣告會刊登。
支援的巨集
出價方可選擇將 Cookie 比對網址設為包含一或多個
格式為 %%GOOGLE_<PARAM_NAME>%%
或
%%GOOGLE_<PARAM_NAME>_PAIR%%
。支援的巨集及其
展開後的值如下:
巨集 | 展開時的值 |
---|---|
GOOGLE_GID | GOOGLE_USER_ID |
GOOGLE_GID_PAIR | &google_gid=GOOGLE_USER_ID |
GOOGLE_CVER | COOKIE_VERSION_NUMBER |
GOOGLE_CVER_PAIR | &cver=COOKIE_VERSION_NUMBER |
GOOGLE_ERROR | ERROR_ID |
GOOGLE_ERROR_PAIR | &google_error=ERROR_ID |
GOOGLE_PUSH | PIXEL_MATCH_DATA |
GOOGLE_PUSH_PAIR | &google_push=PIXEL_MATCH_DATA |
GOOGLE_ALL_PARAMS | google_gid=GOOGLE_USER_ID&cver=COOKIE_VERSION_NUMBER&google_error=ERROR_ID |
巨集範例
出價工具已將 Cookie 比對整合到代管端點的位置
https://user.bidder.com.cookies
,其實作要求
除了 像素比對 以外,還有預設的出價方定義參數
並依下列順序使用參數:google_push
、
google_gid
、google_cver
和
google_error
。出價方只要設定
Cookie 比對網址符合以下條件:
https://user.bidder.com/cookies?w=0%%GOOGLE_PUSH_PAIR%%&x=1%%GOOGLE_GID_PAIR%%&y=2%%GOOGLE_CVER_PAIR%%&z=3%%GOOGLE_ERROR_PAIR%%
Google 稍後傳送比對要求給這個出價方時,將會展開 轉換為如下所示:
https://user.bidder.com/cookies?w=0&google_push=PUSH_DATA&x=1&google_gid=GOOGLE_GID&y=2&google_cver=1&z=3
Cookie 比對服務工作流程
Google 的 Cookie 比對服務目前支援三種工作流程 下文將介紹不同的用途
出價方啟動:雙向 Cookie 比對
雙向 Cookie 比對是指由出價工具發起的工作流程, 會在使用者的瀏覽器中加入比對標記,將代碼導向至 Google。這個 工作流程,Google 和出價工具就能在對照表中填入資料。以下是 透過簡單的例子瞭解這個工作流程
步驟 1:放置比對代碼
為啟動這項程序,出價方必須將比對廣告代碼 (例如 顯示時間。只會傳回這個簡單比對代碼 傳送給出價方的 Google 使用者 ID 結構可能會如下所示:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm" />
您可以在比對代碼中加入額外的參數來執行 應用實例如要進一步瞭解這些參數,請參照: 比對代碼網址參數。
步驟 2:Google 以重新導向 (包含比對資料) 回應
比對代碼會導致 Google 的 Cookie 比對服務接收
要求,因此會發出 HTTP 302
重新導向至出價方的 Cookie 比對網址。重新導向將包含查詢
參數中指定 Google 使用者 ID 及其版本號碼;以及
出價方也會收到包含在要求標頭中的 Cookie。於
對於指定為 https://ad.network.com/pixel
的 Cookie 比對網址
如上所示,簡易比對代碼的重新導向網址看起來可能像
包括:
https://ad.network.com/pixel?google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
透過 google_gid
參數傳遞的 Google 使用者 ID 是
未填充的網路安全 base64 編碼
字串。如果出價方選擇代管對照表,則建議
儲存 Cookie 比對服務傳回的確切字串。接下來
就會對應到透過 BidRequest.google_user_id
指定的值
加到 Google 即時出價通訊協定中的 BidRequest.user.id
OpenRTB 實作。
google_cver
中指定的版本代表數字
Google 使用者 ID 的版本編號。每位使用者的 Google 使用者 ID
頻率較低,之後就會遞增。
如果 Google 處理您的比對請求時發生錯誤,
改為指定 google_error
參數。
步驟 3:出價方會處理重新導向並以像素做為回應
出價方會收到 Cookie 比對網址的重新導向,包括 這些參數,以及 Google 在 第二個步驟。此外,他們的 Cookie 也會在 HTTP 標題。如果作業成功,就會由出價工具代管自己的對照表 可能會比對他們的 Cookie 和回應中的 Google 使用者 ID。是 建議出價工具儲存 Cookie 比對傳回的確切字串 售後服務
如果作業失敗,出價方會收到 google_error
參數。這是與不同值相應的數值
指出發生的特定錯誤。您可以從中學習
如要進一步瞭解可能的錯誤值,請參閱這篇文章。
如果您收到錯誤訊息,您可以嘗試在
就必須加入新的比對標記
出價工具必須一律放送 1x1 的隱藏像素圖片做為回應,或
也可以傳回 HTTP 204
無內容回應。
Cookie 比對工作流程圖
此工作流程如下圖所示 並以箭頭表示回應,以及相應的資料項目 都會以括號表示。
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_matching.png?authuser=2&hl=zh-tw)
比對代碼網址參數
參數 | 說明 |
---|---|
google_nid |
出價工具帳戶的聯播網 ID (NID)。您可以擷取這個 ID 透過出價方 資源。 |
google_cm |
向 Google 的 Cookie 比對服務表示應執行 Cookie 比對。此參數的值將遭忽略,且 省略。 |
google_sc |
此參數已淘汰。為廣告客戶設定 Google Cookie 則會傳回 true此參數的值將被忽略,且 省略。如果沒有 Cookie,省略參數會導致錯誤 存在。 |
google_no_sc |
此參數已淘汰。這向 Google 的 Cookie 比對服務,在 資源不存在。此參數的值將遭忽略,且 省略。 |
google_hm |
出價方想儲存在 Google 代管對照表中的資料。
這個值是網路安全的 Base64 編碼字串 (邊框間距選用)。原始資料必須是 40
位元組以下。例如 |
google_redir |
網址編碼字串,可供出價工具指定是否將流量導向
Google 會將 HTTP 302 重新導向傳送至以下項目的編碼網址:
這個比對標記。如此一來,Google 就能把 Google 置於鏈結的前端
呼叫夥伴。否則將導致錯誤
google_hm ,或google_cm 。 |
google_ula |
用來將使用者新增至現有使用者名單的字串。值的
格式應為 userlistid[,timestamp] :
可重複使用這個網址參數,將使用者新增至多個 清單。 |
gdpr |
表示要求受到 GDPR 限制的資料限制
。如需詳細資訊,請參閱
下方的歐盟地區使用者同意授權規定,或對 Cookie 比對結果的影響
符合
Authorized Buyers IAB 資訊公開和同意聲明架構第 2.0 版說明文件。
範例: |
gdpr_consent |
代表使用者同意聲明的資訊公開和同意聲明字串。詳情 請參閱「歐盟地區使用者同意授權規定」 下方的資訊公開和同意聲明字串將如何傳遞? Authorized Buyers IAB 資訊公開和同意聲明架構第 2.0 版說明文件。 |
process_consent |
表示出價工具已取得使用者同意聲明,可使用
Google 的《歐盟地區使用者同意授權政策》。
請求是否不受《歐盟地區使用者同意授權政策》約束
請求中可用的其他同意聲明參數
( 範例: |
除了上述參數外,出價方也可以自行指定
會以參數的形式附加至重新導向網址中請注意,出價工具定義
系統會忽略以 google_
前置字元命名的參數,這是因為
這些條款是由 Google 保留給日後開發之用,而且
參數不保證會優先排序。比對代碼,包括出價方定義的
參數看起來可能像這樣:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm&extra1=xx&extra2=yy" />
重新導向網址
重新導向網址是以 設定的基礎 Cookie 比對網址為基礎
出價方的帳戶,包括 google_
和出價方定義的參數
視比對標記中指定的條件而定下列google_
回應參數的定義如下:
參數 | 說明 |
---|---|
google_gid |
Google 使用者 ID。如果已在要求中指定 google_cm ,且要求成功,則設定此設定。 |
google_cver |
Cookie 版本。如果已在要求中指定 google_cm ,且要求成功,則設定此設定。 |
google_error |
代表整體要求錯誤的整數值。時間
表示未執行任何作業
將會設定
|
google_hm |
只有在嘗試寫入 Google 代管的對照表時才會顯示 失敗。此時,其值會是下列其中一個狀態碼:
|
google_ula |
使用者名單新增作業的狀態 (如果多個 例如:
|
Cookie 比對工作流程示例
下列情境描述的 Cookie 比對看起來可能像這樣 一般使用者瀏覽網頁時
情境 1:使用者清除 Cookie 並瀏覽網站
珍珍清除所有 Cookie 的快取。然後造訪 ExampleNews.com 的首頁。
接下來會發生的情況是:
- ExampleNews.com 會顯示,並呼叫 Google (Ad Manager) 的廣告。
- 由於廣告單元符合動態分配資格,Google 會傳送出價 透過即時出價服務向 FinestDSP 和其他出價者提出請求。
- FinestDSP 的出價回應應用程式接收並處理出價要求, 並傳送出價回應
- Google 會收到出價方的出價回應,包括 FinestDSP 的回應 可指定含有比對標記 (像素) 的廣告。
- FinestDSP 贏得競價。Google 會向發布商放送 FinestDSP 的廣告和比對廣告代碼 珍珍
- 比對標記呼叫 Google 的 Cookie 比對服務,並指定
google_nid
和google_cm
參數。 - Cookie 比對服務讀取阿珍的 Google Cookie,並將阿珍的 Cookie
瀏覽器會將重新導向到 FinestDSP 的 Cookie 比對網址,
已設定
google_user_id
和google_cver
參數。 - 阿珍的瀏覽器載入了重新導向到 FinestDSP 的 Cookie 比對網址。
- FinestDSP 的 Cookie 比對端點會處理重新導向請求,
其中包含 Google 設定的網址參數,以及在
HTTP 標頭。FinestDSP 現在能將他們的 Cookie 與
google_user_id
。 - FinestDSP 以隱藏的 1x1 像素回應重新導向。
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie-matching-schematic.png?authuser=2&hl=zh-tw)
情境 2:已有對應關係的使用者
在情境 1 過後一週,阿珍再次造訪 ExampleNews.com。現在小珍 他們的電腦上同時有出價工具和 Ad Manager Cookie 能夠正常運作。
- 網頁顯示,使 Google (Ad Manager) 請求 會顯示在頁面上。
- 在廣告競價期間,Google 會向適用的出價方傳送出價要求。 包括 FinestDSP
- FinestDSP 收到出價要求,包括
google_user_id
。 - FinestDSP 在其對照表中尋找
google_user_id
, 找出與阿珍相關聯的 Cookie (這是一週前建立的 Cookie) (在情境 1 中)。 - 根據與 Cookie 相關的資訊 FinestDSP 的出價 邏輯會針對曝光出價,然後在競價中勝出。
- 系統可能會根據你的資訊,向小珍放送符合個人興趣的廣告 所有 FinestDSP 所擁有
出價方啟動:單向 Cookie 比對
單向 Cookie 比對與雙向 Cookie 比對類似
但前者會變造,因此只有 Google 代管及填入相符項目。
表格。如果出價工具不得託管於出價工具時,則可以使用這個回呼。
Google 使用者 ID。為了方便採用這個流程
必須允許 Google 代管對照表,無法再指定
google_cm
出現在向 Google Cookie 比對服務發出的請求中,以及
所以不會收到可自行填入資料的 google_gid
對照表。Google 建立比對使用者後,出價方即可新增
進而根據自己的 Cookie 資料觸及使用者清單同樣地,對於以下項目的出價要求:
這些使用者會排除 Google 使用者 ID,但包含代管比對資料。A 罩杯
下方步驟摘要說明修改後的工作流程。
步驟 1:將導向出價方 Cookie 比對網址的比對代碼放置
為啟動此流程,出價工具必須放置比對代碼,讓其得以啟動。
會在使用者的瀏覽器中顯示。有別於適用於非美國州,且設有隱私權限制的使用者,
比對標記必須將使用者的瀏覽器導向您的 Cookie
相符的網址。例如,假設 Cookie 比對網址設為
https://ad.network.com/pixel
,看起來會像這樣:
<img src="https://ad.network.com/pixel" />
在使用者瀏覽器中載入時,瀏覽器會向出價方的 Cookie 比對網址。這個請求會將他們的 Cookie 包含在 HTTP 標頭中 進行下一個步驟時應擷取這個 ID
步驟 2:重新導向至 Google 的 Cookie 比對服務
出價方的 Cookie 比對端點必須重新導向至 Google 的 Cookie
比對服務,包括填入的 google_hm
參數
採用網路安全 base64 編碼的 Cookie 資料重新導向網址看起來可能就像
包括:
https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA
步驟 3:使用者的瀏覽器重新導向至 Google 的 Cookie 比對服務
Google 會收到含有您指定參數的重新導向,其中包含 同時加入 Google 的 Cookie 標頭
步驟 4:如果已指定報表網址,Google 會在成功或錯誤重新導向時顯示像素
Cookie 比對作業成功 (或沒有 Cookie)
已為出價方帳戶指定比對報表網址,也就是 Google
根據預設,系統會放送 1x1 透明像素,工作流程也會在此
在後續出價要求中,這位使用者的曝光次數將包含出價方的
Google 在 BidRequest.hosted_match_data
中的代管比對資料
通訊協定,或為 Google 的 OpenRTB 的 BidRequest.user.buyeruid
。出價方也可以使用代管比對資料填入使用者名單。
參數。
否則,如果發生錯誤,Google 會將重新導向傳送給出價工具的
Cookie 比對報表網址與
google_error
參數。如果出價方的 Cookie 比對報表網址
是 https://ad.network.com/report
,重新導向網址看起來是
例如:
<img src="https://ad.network.com/report?google_error=ERROR_ID" />
步驟 5:使用者的瀏覽器重新導向至出價方的 Cookie 比對報表網址
使用者的瀏覽器會重新導向至出價方的 Cookie 比對報表網址。
包括 Google 指明的錯誤原因 (如果有的話),
google_error
參數。進一步瞭解如何解讀錯誤
程式碼,請參閱參數說明。
步驟 6:出價方放送 1x1 透明像素
出價工具必須在回應時放送 1x1 的透明像素, 。
來自設有隱私權限制的美國各州使用者的 Cookie 比對工作流程圖表
適用於設有隱私權限制的美國州別的使用者,預設工作流程如下圖所示 下方以箭頭表示要求和回應,而資料 隨附的項目則會以括號表示。
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_matching_ca.png?authuser=2&hl=zh-tw)
出價工具的網址參數會重新導向至 Google 的 Cookie 比對服務
參數 | 說明 |
---|---|
google_nid |
出價工具帳戶的聯播網 ID (NID)。您可以擷取這個 ID 透過出價方 資源。 |
google_sc |
此參數已淘汰。為廣告客戶設定 Google Cookie 則會傳回 true此參數的值將被忽略,且 省略。如果沒有 Cookie,省略參數會導致錯誤 存在。 |
google_no_sc |
此參數已淘汰。這向 Google 的 Cookie 比對服務,在 資源不存在。此參數的值將遭忽略,且 省略。 |
google_hm |
包含出價工具想儲存在 Google 代管比對中的資料 表格。 |
google_redir |
您想讓 Google 傳送 HTTP 302 重新導向的編碼網址。
指定網址將接收含有 google_error 的重新導向
參數,適用於錯誤和成功的作業。 |
google_ula |
用來將使用者新增至現有使用者名單的字串。值的
格式應為 userlistid[,timestamp] :
可重複使用這個網址參數,將使用者新增至多個 清單。 |
gdpr |
表示要求受到 GDPR 限制的資料限制
。如需詳細資訊,請參閱
下方的歐盟地區使用者同意授權規定,或對 Cookie 比對結果的影響
符合
Authorized Buyers IAB 資訊公開和同意聲明架構第 2.0 版說明文件。
範例: |
gdpr_consent |
代表使用者同意聲明的資訊公開和同意聲明字串。詳情 請參閱「歐盟地區使用者同意授權規定」 下方的資訊公開和同意聲明字串將如何傳遞? Authorized Buyers IAB 資訊公開和同意聲明架構第 2.0 版說明文件。 |
process_consent |
表示出價工具已取得使用者同意聲明,可使用
Google 的《歐盟地區使用者同意授權政策》。
請求是否不受《歐盟地區使用者同意授權政策》約束
請求中可用的其他同意聲明參數
( 範例: |
Google 的網址參數重新導向至出價方的 Cookie 比對報表網址
參數 | 說明 |
---|---|
google_error |
代表整體要求錯誤的整數值。時間
表示未執行任何作業
將會設定
|
Google 發起:雙向像素比對
雙向像素比對是 Google Cookie 比對的工作流程 Google 會嘗試透過演算法比對 Google 使用者 ID 的服務 選擇的出價方 (即時出價競價勝出者除外)。當廣告 置入代碼後,Google 就會放置比對標記,引導使用者的瀏覽器載入 來自所選出價方的 Cookie 比對網址的透明像素。這會啟用 Google 和出價方都能在對照表中填入特定使用者。下方為 透過這個工作流程的簡單範例
步驟 1:Google 放置比對代碼
當使用者的瀏覽器載入參與發布商的網頁時,
網頁廣告版位就會由 Google 供應廣告,即可將比對標記放在
向演算法所選出價方要求像素。像素比對
Google 標記的廣告代碼將結合出價方的 Cookie 比對網址與
其他參數
出價方可以用來填入對照表。針對 Cookie 比對網址
指定為 https://ad.network.com/pixel
,表示其結構為
如下:
<img src="https://ad.network.com/pixel?google_gid=GOOGLE_GID&google_cver=1&google_push=PUSH_DATA" />
步驟 2:出價方必須以重新導向的 Google Cookie 比對服務網址做為回應
接收像素比對請求的出價方必須透過 重新導向至 Google Cookie 比對服務 (採用的結構如下:
https://cm.g.doubleclick.net/pixel?google_nid=GOOGLE_NID&google_push=PUSH_DATA
請注意,上述重新導向網址與上述重新導向網址的
「發起出價方的 Cookie 比對工作流程」比對代碼。
在像素比對中,google_cm
參數會由
google_push
參數,而且其值必須等於
使用 Google 提供的 IP 位址也類似於根據出價方
其他參數
就能滿足其他用途
步驟 3:Google 處理重新導向並以像素回應
Google 會記錄使用者已建立比對的項目,然後處理 透過查詢參數要求的額外作業。最後,Google 1x1 透明像素
像素比對工作流程圖
此工作流程如下圖所示 並以箭頭表示回應,以及相應的資料項目 都會以括號表示。
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/pixel_matching.png?authuser=2&hl=zh-tw)
Google 比對代碼要求參數
參數 | 說明 |
---|---|
google_gid |
Google 使用者 ID。如果使用者並非位於美國且設有隱私權限制的州,這項資訊一律會 您在 Google 的比對標記中所指定的對象 |
google_cver |
Cookie 版本。這項資訊一律會在 Google 的比對結果中指定 標記之前。 |
google_push |
表示這項要求正在啟動像素比對工作流程。 這個值必須透過出價工具中的對應參數傳回 重新導向回應。 |
出價方像素比對重新導向參數
參數 | 說明 |
---|---|
google_nid |
出價工具帳戶的聯播網 ID (NID)。您可以擷取這個 ID 透過出價方 資源。 |
google_push |
表示這次重新導向完成像素比對 工作流程對應的 Google 比對標記值必須是 參數。 |
google_hm |
包含出價工具想儲存在 Google 代管比對中的資料 表格。 |
google_ula |
用來將使用者新增至現有使用者名單的字串。值的
格式應為 userlistid[,timestamp] :
可重複使用這個網址參數,將使用者新增至多個 清單。 |
Google 發起:單向像素比對
單向像素比對與 表示 Google 的比對代碼不含指定 Google 使用者的參數 但仍會繼續填入 Google 代管的對照表。您可以用 出價工具不得在 自己的對照表。有關修改過的工作流程摘要範例請見 步驟。
步驟 1:Google 放置比對代碼
Google 會為演算法選擇的出價方放置比對代碼。比對標記會包含
google_push
參數。範例如下:
<img src="https://ad.network.com/pixel?google_push=PUSH_DATA" />
步驟 2:使用者的瀏覽器向出價方的烹飪比對網址要求像素
使用者的瀏覽器向出價方的 Cookie 比對網址請求像素, 將出價工具的 Cookie 加入 HTTP 標頭
步驟 3:重新導向至 Google 的 Cookie 比對服務
出價方的 Cookie 比對端點必須重新導向至 Google 的 Cookie
比對服務,包括填入的 google_hm
參數
採用網路安全 base64 編碼的 Cookie 資料重新導向網址看起來可能就像
包括:
https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA&google_push=PUSH_DATA
步驟 4:使用者的瀏覽器重新導向至 Google 的 Cookie 比對服務
Google 會收到含有您指定參數的重新導向,其中包含
同時加入 Google 的 Cookie 標頭如果作業
成功,這位使用者在後續出價要求的曝光會包含
為以下項目提供出價工具代管的比對資料:BidRequest.hosted_match_data
Google 通訊協定,若為 Google 通訊協定,則為 BidRequest.user.buyeruid
OpenRTB 實作。出價方也能使用
比對您指定的資料
最後,Google 會在使用者的瀏覽器傳回 1x1 透明像素。
Cookie 比對輔助
公開出價允許廣告交易平台使用發起的出價工具 並 由 Google 發起 Cookie 比對工作流程來比對 Google 使用者 ID 與其 Cookie。餅乾 比對輔助 (CMA) 是廣告交易平台的額外功能,可讓廣告交易平台 與自己的出價方建立對照表。
Cookie 比對輔助功能的運作方式
刊登廣告時,Google 會透過演算法選擇參與 並置入具有下列文字的 Cookie 比對輔助標記: 結構:
敬上<img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>
Google 的 CMA 比對代碼會使廣告交易平台的 Cookie 比對網址 接收像素要求
- 廣告交易平台的 Cookie 比對端點收到請求,其中 這個 Cookie 比對服務必須負責將 User-ID 和 出價方之一下圖中,廣告交易平台的 Cookie 比對功能 服務藉由重新導向,回應使用者的瀏覽器 端點。
- 出價工具會收到請求,以及由 來比對使用者 ID 和他們的 Cookie
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_match_assist_diagram.png?authuser=2&hl=zh-tw)
限制
新相符項目的要求頻率上限
出價方必須負責限制對 Cookie 發出的呼叫次數 使用者的比對服務,適用於在 Google 代管比對中有最新項目的使用者 表格。代管對照表中的項目可能會在 14 天後視為過期, 之後即可重新整理
回應所有像素比對請求
使用像素比對工作流程的出價方應會回應所有
傳入的 Pixel 比對請求及回應包含 google_push
參數。方便 Google 監控使用情形,藉此強制執行政策。如果
出價工具的回應率降到 90% 以下時,Google 會限制
傳送到孩子帳戶的像素比對請求。
使用 HTTPS 端點
所有 Cookie 比對工作流程使用的端點都必須 HTTPS
回應透過 HTTPS 傳送給您的 Pixel 比對要求時, 必須透過 HTTPS 重新導向至 Cookie 比對服務。同樣地 重新導向到出價工具的 Cookie 比對輔助端點也必須使用 HTTPS。 如果您透過 HTTP 傳送要求的頻率超過每 2 分鐘一次, 傳送至您帳戶的比對請求數量會受到限制。
歐盟地區使用者同意授權規定
牽涉到的 Cookie 比對請求 Google 的歐盟使用者 同意聲明政策應標示使用者同意。這類要求必須 表示已透過下列任一方式取得同意聲明:
- 資訊公開和同意聲明架構第 2 版:包括
gdpr
和gdpr_consent
參數。詳情請參閱 Authorized Buyers IAB 資訊公開和同意聲明架構第 2.0 版說明文件。 process_consent
:表示出價工具已取得的宣告 必要的使用者同意聲明。
範例
下方範例說明如何使用 Cookie 比對服務 來達成特定目標請注意,除非另有說明, 假設您的行為人並非 設有隱私權限制的美國州別。
填入出價工具代管的對照表
出價方可以使用 Cookie 比對工作流程,自行填入比對結果
資料表,方法是僅提供 google_nid
和 google_cm
參數。如下所示:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_cm" />
如果出價方的 Cookie 比對網址設為 https://ad.network.com/pixel?id=1
,
Cookie 比對作業成功後,Google 傳送的重新導向
回應出價方比對廣告代碼的回應看起來會像這樣:
https://ad.network.com/pixel?id=1&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
如果 Cookie 比對作業因使用者沒有 Google Cookie,回應會是:
https://ad.network.com/pixel?id=1&google_error=3
錯誤代碼會因錯誤的根本原因而異。學習 如要進一步瞭解 Cookie 比對工作流程中可能出現的錯誤代碼,請參閱 重新導向網址。
加入單一使用者名單
您可以在出價方的比對項目中指定 google_ula
參數
標記,將使用者加入含有指定 ID 的使用者名單。如果 Google 或
出價工具代管的對照表為使用者提供了新的項目,出價方可以放置
包含 google_nid
和 google_ula
的比對標記
參數,即可將使用者加入指定清單,而不必啟動
Cookie 比對工作流程:查看相關限制
呼叫 Cookie 比對服務 更多財產。對應的
比對標記看起來會像這樣:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345" />
如果回應成功,出價工具的 Cookie 比對網址為
https://ad.network.com/pixel
,Google 的重新導向網址會是:
https://ad.network.com/pixel?google_ula=12345,0
如果發生整體錯誤 (例如沒有 Google Cookie),
使用者,重新導向網址會包括
google_error
參數:
https://ad.network.com/pixel?google_error=3
如果我們在將使用者加入清單時遇到了什麼錯誤,
會在重新導向中收到 google_ula
。與
,這會將時間戳記換成狀態
指出作業成功的程式碼。舉例來說,如果要求失敗
因為出價方帳戶沒有指定使用者名單的存取權,
重新導向網址會是:
https://ad.network.com/pixel?google_ula=12345,2
加入多份使用者名單
出價方可以透過下列方式指定應將使用者加入多份使用者名單。
加入多個 google_ula
參數於
可能會像這樣:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345,7654321&google_ula=45678" />
每份使用者名單的作業狀態都是透過
重新導向中的不同 google_ula
參數:
https://ad.network.com/pixel?google_ula=12345,2&google_ula=45678,0
在上方的重新導向中,可以看到使用者操作成功
ID 為 45678
的清單,但不符合 ID 為 12345
的清單
因為出價方沒有存取權限。
逐步完成 Cookie 比對工作流程,並加入使用者名單
如要執行 Cookie 比對,並將使用者加入單一的使用者名單中
請求時,出價方的比對標記應包含 google_cm
和
google_ula
:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345&google_cm" />
Google 指定的重新導向網址會包含 google_gid
、
google_cver
和google_ula
。這個 ID 看起來可能像
包括:
https://ad.network.com/pixel?id=&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1&google_ula=12345,0
將比對項目儲存在 Google 代管的對照表中
如果出價方想將 Cookie 資料儲存在 Google 代管的對照表中,
也不打算將比對到的 Google 使用者 ID 進行比對
因此比對代碼必須包含 google_hm
參數,且
的值必須是網頁安全 base64 編碼的字串。如果使用者
出價方的未編碼 Cookie 資料是 Cookie number 1!
,經過編碼的
這個值會是 Q29va2llIG51bWJlciAxIQ==
,會在
比對標記,如下所示:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D" />
如果回應成功,出價工具的 Cookie 比對網址為
https://cookie-monster.com/pixel
,Google 的重新導向網址會
品牌:
https://cookie-monster.com/pixel
google_gid
參數並未包含在重新導向中,因為
比對標記不包含google_cm
,而google_hm
是
未包含在成功回應中。日後的曝光出價要求
因此,出價方將透過
BidRequest.hosted_match_data
為 Google RTB 通訊協定,或
BidRequest.user.buyeruid
適用於 Google 的 OpenRTB 實作。
如果出價方使用比對標記,其中
google_hm
未採用 Base64 編碼,例如
chocolate_chunk!
:重新導向網址看起來可能像
包括:
https://cookie-monster.com/pixel?google_hm=2
上述重新導向網址包含的 google_hm
值
2
,表示作業失敗,因為值
物件則不會解碼
出價方和 Google 代管的對照表及使用者名單
如果出價方除了 Google 代管使用者以外,還代管了自己的使用名單
,因此希望使用一個比對標記來同時比對這兩份資料表,並將使用者加進一份
指定使用者名單必須包含 google_cm
google_hm
和 google_ula
參數如果出價方
Cookie 資料是 Cookie number 1!
,編碼值會是
Q29va2llIG51bWJlciAxIQ==
,這樣會產生與
包括:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D&google_cm&google_ula=12345" />
如果回應成功,出價工具的 Cookie 比對網址為
https://cookie-monster.com/pixel
,Google 的重新導向網址會
如下所示:
https://cookie-monster.com/pixel?google_gid=ABCDETC&google_cver=1&google_ula=12345,0
收到重新導向時,出價方可以將指定的 Google 使用者 ID
google_gid
及其對照表中的 Cookie 資料。於
也可以決定 Google 代管的對照表和使用者名單。
作業成功。因此,如果預先指定
設為指定指定使用者名單 ID 之後,出價工具就會
接收來自使用者曝光的出價要求同樣地
出價方就會透過
BidRequest.hosted_match_data
為 Google RTB 通訊協定,或
BidRequest.user.buyeruid
適用於 Google 的 OpenRTB 實作。