Cookie 比對

「Cookie 比對」功能可讓您比對 Cookie (例如網站瀏覽者的使用者 ID) 與對應的出價方專屬 Google 使用者 ID，並建構使用者名單，協助您做出更有成效的出價選擇。本指南說明 Cookie 比對中使用的概念、不同的 Cookie 比對工作流程，以及特定用途的任何變化。

重點：如要存取 Cookie 比對功能，請與您的客戶經理聯絡，以便設定帳戶。本指南的其餘部分假設您已完成這項操作。

概念

什麼是 Cookie 比對？

網域擁有者通常會為瀏覽網站的使用者設定 Cookie 內容，用於識別該網域內的使用者。即使兩個網域擁有者同意交換這項資料，網際網路瀏覽器的安全模式也會限制一個網域讀取另一個網域設定的 Cookie。

在數位廣告領域中，Google 會使用屬於 doubleclick.net 網域的 Cookie 識別使用者，而參與即時出價的競價者可能會有自己的網域，用於識別想向其放送廣告的一組使用者。出價方可透過 Cookie 比對功能，將自己的 Cookie 與 Google 的 Cookie 進行比對，判斷出價要求中傳送的曝光是否與目標使用者相關聯，並接收自己的 Cookie 資料或出價方專屬的 Google 使用者 ID，後者是出價要求中 doubleclick.net Cookie 的加密形式。

本指南所述的 Cookie 比對服務可協助您建立及維護出價者的 Cookie 與 Google 使用者 ID 之間的關聯，並填入使用者名單。

對照表

對照表可用於將一個網域的 ID 或其他資料對應至另一個網域。出價者可以使用 Cookie 比對服務，將特定使用者的 Cookie 對應至 Google 使用者 ID，藉此填入自己的對照表，或是填入 Google 代管的對照表。出價者應用程式必須有比對表，才能存取向使用者顯示曝光的 Cookie 資料。

Google 代管的對照表

為方便維護、改善延遲時間，以及讓特定地區的使用者存取比對資料，建議您允許 Google 代管比對資料表。您可以指定採用網路安全 Base64 編碼的字串 (以下稱為代管比對資料)，並將該字串對應至特定使用者的 Google 使用者 ID。建立比對後，即可透過下列方式使用：

• 即時出價：在後續與使用者相關的曝光出價要求中，Google 會傳送您與使用者 Google 使用者 ID 相符的代管比對資料。Google 會將 BidRequest.user.buyeruid 指定為具網路安全性的 Base64 編碼字串。

  重點：如果系統偵測到使用者來自隱私權受限的美國州別，出價要求中就不會指定 Google 使用者 ID。您仍會收到代管比對資料，可用於制定出價邏輯。
  注意：根據預設，buyeruid 中的值是採用網路安全 Base64 編碼的字串，應等同於您在 google_hm 中傳送的值。如果在出價要求中收到非預期的 buyeruid 值，可能表示您傳送的是未編碼的 google_hm 值。如要停用出價要求中的編碼，請與客戶技術顧問聯絡。

• 使用者名單：使用者名單可填入 Google 使用者 ID 或代管比對資料。

  注意：如果系統偵測到使用者來自隱私權受限的美國州別，則不建議使用 Google User-ID 填入使用者名單，這項功能最終將會停用。建議出價者為這些使用者填入使用者清單，並提供代管比對資料。
• 預先指定： 您可以設定預先指定，只接收含有代管比對資料的出價要求。這項功能可排除 Cookie 空間外使用者較不相關的曝光。

使用者名單

您可以使用即時出價 API 建立及管理使用者名單。 建立完成後，您可以使用下列 Cookie 比對工作流程或大量上傳服務，在這些名單中填入資料。

重點：使用者名單可同時填入 Google 使用者 ID 和代管比對資料，且可混合使用。請注意，指定後者時，必須已將這些資料新增至 Google 代管的比對表。對於來自隱私權受限美國州別的使用者，您必須使用經過修改的工作流程，將代管比對資料加入使用者名單，而非 Google 使用者 ID。

開始使用

如要開始使用 Cookie 比對，請與技術客戶經理聯絡，由對方啟用特定工作流程，並協助您設定下列項目：

• Cookie 比對聯播網 ID (NID)：在進行 Cookie 比對和其他相關作業時，用來識別出價方帳戶的專屬字串 ID。
• Cookie 比對網址：端點的基準網址，該端點為「Cookie 比對」工作流程的一部分，用於接受並處理所收到的請求項目。 出價者可以在這個網址中嵌入巨集，藉此控管在 Cookie 比對工作流程中傳遞給網址的參數順序。
• 比對標記：您必須在使用者瀏覽器中安插這個標記，才能進行由出價者發起的 Cookie 比對工作流程。這類廣告可與一般廣告一起放送， 也可放置在廣告以外的網路資源上。
• Cookie 比對報表網址 (選填)：在單向 Cookie 比對工作流程中，這是選填網址，可用來指定 Cookie 比對失敗時，透過 HTTP 302 重新導向接收錯誤詳情的端點。根據預設，只有在 Cookie 比對作業發生錯誤時，系統才會將回應傳送至這個網址，但競價者可以要求一律傳送重新導向。
• Cookie 比對輔助網址：對於實作 Cookie 比對輔助工作流程的交易平台，這是要回應傳入要求的端點基準網址。
• Cookie 比對輔助配額：如果交易平台實作Cookie 比對輔助工作流程，這是指 Cookie 比對網址每秒可接收的要求數量上限。這是為了避免 CMA 要求造成交易所伺服器超載。

注意：Authorized Buyers 可以使用競價者 資源，查看為帳戶設定的 Cookie 比對 NID 和網址。

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

巨集範例

出價者與 https://user.bidder.com/cookies 代管的端點整合了 Cookie 比對功能，且實作方式除了 Pixel 比對參數外，還需要預先設定出價者定義的參數，順序如下：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

注意：在 Pixel 比對工作流程中，Google 比對代碼不會填入 google_error 參數，因此會排除該參數。

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" />

注意：BIDDER_ACCOUNT_NID 應替換為出價者帳戶的 NID。這項資訊由技術客戶經理在設定出價工具帳戶的 Cookie 比對時提供，也可以透過即時出價 API 的出價工具資源查看。

您可以在比對代碼中加入其他參數，以滿足不同用途。如要進一步瞭解這些參數，請參閱「比對代碼網址參數」。

步驟 2：Google 會傳送包含比對資料的重新導向回應

比對代碼會導致 Google 的 Cookie 比對服務收到使用者瀏覽器的要求，並向競價者的 Cookie 比對網址發出 HTTP 302 重新導向。重新導向的網址會包含查詢參數，指定 Google 使用者 ID 和版本號碼，出價者也會在要求標頭中收到自己的 Cookie。在實務上，如果 Cookie 比對網址指定為 https://ad.network.com/pixel，先前比對代碼的重新導向網址可能如下所示：

https://ad.network.com/pixel?google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1

透過 google_gid 參數傳遞的 Google 使用者 ID 是未填補的網路安全 Base64 編碼字串。如果出價者選擇代管比對表，建議儲存 Cookie 比對服務傳回的確切字串。在後續出價要求中，這會對應至透過 BidRequest.user.id 指定的值。

google_cver 中指定的版本會指出 Google 使用者 ID 的數字版本號碼。特定使用者的 Google 使用者 ID 不常變更，變更後就會遞增。

如果 Google 在處理比對要求時發生錯誤，系統會改為指定 google_error 參數。

步驟 3：出價者處理重新導向，並以像素回應

出價者會收到重新導向至 Cookie 比對網址的連結，其中包含在第一個步驟中指定的參數，以及 Google 在第二個步驟中提供的參數。此外，他們也會在 HTTP 標頭中收到 Cookie。如果作業成功，自行代管比對表的廣告主，就能將自己的 Cookie 與回應中包含的 Google 使用者 ID 比對。建議出價者儲存 Cookie 比對服務傳回的確切字串。

如果作業失敗，競價者會在重新導向中收到 google_error 參數。這是對應不同錯誤狀態的數值，可識別發生的特定錯誤。如要進一步瞭解可能發生的錯誤值，請參閱 google_error 網址參數的說明。如果收到錯誤訊息，您可以放置新的比對標記，再次嘗試比對該使用者。

出價者一律必須傳送 1x1 的不可見像素圖片來回應，或傳回 HTTP 204「No Content」(無內容) 回應。

Cookie 比對工作流程圖

下圖說明這個工作流程，其中要求和回應以箭頭表示，隨附的資料項目則列於括號中。

比對代碼網址參數

參數	說明
google_nid	出價者帳戶的網路 ID (NID)。這個 ID 可透過 Bidders 資源擷取。
google_cm	向 Google 的 Cookie 比對服務指出應執行 Cookie 比對。系統會忽略參數值，因此可以省略。
google_sc	這個參數已淘汰。如果使用者沒有 Google Cookie，系統會設定。系統會忽略參數值，因此可以省略。如果沒有 Cookie，省略參數會導致錯誤。
google_no_sc	這個參數已淘汰。這會向 Google 的 Cookie 比對服務指出，如果使用者沒有 Cookie，就不應為使用者設定 Cookie。系統會忽略參數值，因此可以省略。
google_hm	出價者想儲存在 Google 代管比對資料表中的資料。 這個值是採用 Base64 編碼的網路安全字串 (可選用填充)。原始資料不得超過 40 個位元組。例如：Q29va2llIHRoYXQgaXMgdW5kZXIgNDAgdG90YWwgYnl0ZXMuLi4u。
google_redir	如果出價者希望 Google 將 HTTP 302 重新導向傳送至這個相符代碼的編碼網址，可以指定網址編碼字串。這樣一來，Google 就能在合作夥伴的鏈結呼叫中排在最前面。如果指定時沒有 google_hm 或有 google_cm，就會發生錯誤。
google_ula	用於將使用者新增至現有使用者名單的字串。這個值的預期格式為 userlistid[,timestamp]： userlistid：單一數值使用者名單 ID。 timestamp：POSIX 格式的選用時間戳記， 表示使用者加入使用者名單的時間。 這個網址參數可能會重複，將使用者加入多個清單。
gdpr	指出要求受到《一般資料保護條例》的資料使用限制。詳情請參閱 歐盟地區使用者同意聲明規定，或「Authorized Buyers IAB 資訊公開和同意聲明架構第 2.0 版」說明文件中的「對 Cookie 比對資格的影響」。 範例：gdpr=1
gdpr_consent	代表使用者同意聲明的資訊公開和同意聲明字串。詳情請參閱歐盟地區使用者同意聲明規定，或 Authorized Buyers IAB 資訊公開和同意聲明架構第 2.0 版文件中的「資訊公開和同意聲明字串的傳遞方式為何？」。
process_consent	表示出價者已取得使用者同意，可將資料用於 Google 歐盟地區使用者同意授權政策中指定的用途。 如果請求不受《歐盟地區使用者同意授權政策》規範，或請求中含有其他同意聲明參數 (gdpr_consent)，系統會忽略這個參數。 範例：process_consent=T

除了上述參數外，出價者也可以指定自己的參數，這些參數會附加至重新導向網址。請注意，系統會忽略以 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_ 回應參數。支援的錯誤值包括： 1：使用者有 Google Cookie，但已選擇停用任何使用這項 Cookie 的追蹤功能。 2：未指定任何有效作業。舉例來說，系統收到的是無作業要求。 3：使用者沒有 Google Cookie。Google 不會透過 Cookie 比對服務設定 Cookie。 4：指定的操作相互衝突。您不得在同一項要求中同時指定 google_push 和 google_cm 旗標，因為這兩個旗標的用途互斥。 5：在重新導向至 Google 伺服器時，系統傳遞了無效的 google_push 參數，這是雙向像素比對要求的一部分。重新導向必須將 google_push 設為與初始像素要求中傳遞給您的值相同。 6：比對代碼中提供的 NID 無效。 7：系統偵測到無效的 Cookie。 8：已淘汰。找不到 Cookie。 9：找不到 Cookie，系統會嘗試設定測試 Cookie。 10：使用 google_redir 參數時未指定 google_hm，或同時使用 google_redir 和 google_cm。 15：要求來自 Google 規定比對資料表必須由 Google 代管的區域。因此，這項回應不含 Google 使用者 ID。
google_hm	只有在寫入 Google 代管的相符資料表失敗時，才會顯示這項錯誤。發生這種情況時，其值會是下列其中一個狀態碼： 1 - Forbidden：顧客無權寫入代管對照表項目。 2 - 解碼錯誤：無法解碼參數值。 3 - 酬載過長：解碼後的參數值資料超過 40 個位元組。 4 - 內部錯誤：儲存資料時發生內部錯誤。 5 - 受限：由於節流，系統未處理這項寫入作業。
google_ula	使用者名單新增作業的狀態。如果要求中指定了多個 google_ula，則會重複顯示。格式為： userlistid,status code 例如：google_ula=1234567890,0 google_ula 作業可能會傳回下列任一狀態碼： 0 - No error. 使用者已新增至使用者清單。 2 - Permission denied. 您沒有權限將使用者新增至指定的使用者清單。 5 - 使用者名單 ID 錯誤。提供的使用者名單 ID 無效。 6 - Closed attribute ID. 提供的使用者清單 ID 已關閉。 10 - 發生內部錯誤。Cookie 比對服務發生內部錯誤，您可以嘗試再次比對使用者。

Cookie 比對工作流程範例情境

以下情境說明一般使用者瀏覽網頁時，Cookie 比對可能發生的情況。

情境 1：使用者清除 Cookie 並瀏覽網站

Jane 清除了所有 Cookie 的快取。接著造訪 ExampleNews.com 的首頁。

接下來會發生的情況是：

1. ExampleNews.com 會算繪並呼叫 Google (Ad Manager) 的廣告。
2. 由於廣告單元符合動態分配資格，Google 會透過即時出價服務，將出價請求傳送給 FinestDSP 和其他出價方。
3. FinestDSP 的出價方應用程式會接收及處理出價要求， 並傳送出價回應。
4. Google 會收到出價者的出價回應，包括 FinestDSP 的回應，其中指定含有比對代碼 (像素) 的廣告。
5. FinestDSP 贏得競價。Google 會向小珍放送 FinestDSP 的廣告和比對代碼。
6. 比對代碼會呼叫 Google 的 Cookie 比對服務，並指定 google_nid 和 google_cm 參數。
7. Cookie 比對服務會讀取 Jane 的 Google Cookie，並將 Jane 的瀏覽器重新導向至 FinestDSP 的 Cookie 比對網址，並設定 google_gid 和 google_cver 參數。
8. 阿珍的瀏覽器會載入重新導向，前往 FinestDSP 的 Cookie 比對網址。
9. FinestDSP 的 Cookie 比對端點會處理重新導向要求，其中包含 Google 設定的網址參數，以及 HTTP 標頭中 Jane 的 Cookie。FinestDSP 現在可以在比對資料表中，儲存 Cookie 與 google_gid 的對應關係。
10. FinestDSP 會以不可見的 1x1 像素回應重新導向。

情境 2：使用者已有對應關係

情境 1 發生一週後，Jane 再次造訪 ExampleNews.com。現在 Jane 的電腦上同時有競價工具和 Ad Manager Cookie，以下說明比對作業的運作方式。

1. 網頁會顯示，導致 Google (Ad Manager) 請求要在網頁上顯示的廣告。
2. 在廣告競價期間，Google 會向適用的出價者 (包括 FinestDSP) 傳送出價要求。
3. FinestDSP 會收到出價要求，包括 google_gid 等信號。
4. FinestDSP 會在比對表格中查詢 google_gid，並找出與 Jane 相關聯的 Cookie，該 Cookie 是在一週前建立 (情境 1)。
5. 根據與 Cookie 相關聯的資訊，FinestDSP 的出價邏輯會對曝光出價，並贏得競價。
6. 根據 FinestDSP 擁有的資訊，小珍可能會看到符合自己興趣的廣告。

由競價者發起：單向 Cookie 比對

單向 Cookie 比對與雙向工作流程類似， 但經過修改，只有 Google 會代管及填入比對表。 如果出價者無法在自己的比對表格中代管 Google 使用者 ID，就可以使用這項功能。如要使用這個流程，出價者必須允許 Google 代管比對表，且無法再於向 Google Cookie 比對服務發出的要求中指定 google_cm，因此不會收到 google_gid 來填入自己的比對表。Google 建立使用者的比對後，出價者就能使用自己的 Cookie 資料，將使用者加入使用者名單。同樣地，這些使用者的出價要求會排除 Google 使用者 ID，但會納入代管比對資料。以下步驟將說明修訂後的工作流程範例。

注意：如果使用者來自隱私權受限的美國州別，就必須採用這個工作流程，但出價者也可以選擇在其他地區採用這個工作流程。

步驟 1：將比對代碼導向競價者的 Cookie 比對網址

如要啟動這項流程，出價者必須放置相符標記，讓標記在使用者瀏覽器中顯示。與隱私權受限的美國州別以外使用者不同，比對代碼必須將使用者的瀏覽器導向 Cookie 比對網址。舉例來說，如果 Cookie 比對網址設定為「https://ad.network.com/pixel」，則會顯示如下：

<img src="https://ad.network.com/pixel" />

在使用者瀏覽器中載入時，系統會向競價者的 Cookie 比對網址要求像素。這項要求會在 HTTP 標頭中包含使用者的 Cookie，您應擷取該 Cookie 以進行下一個步驟。

步驟 2：重新導向至 Google 的 Cookie 比對服務

出價者的 Cookie 比對端點必須重新導向至 Google 的 Cookie 比對服務，包括填入以具網路安全性的 Base64 編碼方式編碼的 Cookie 資料的 google_hm 參數。重新導向網址可能如下所示：

https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA

步驟 3：使用者的瀏覽器會重新導向至 Google 的 Cookie 比對服務

Google 會收到含有您指定參數的重新導向，以及 HTTP 標頭中的 Google Cookie。

步驟 4：如果指定報表網址，Google 會在成功或錯誤重新導向時提供像素

如果 Cookie 比對作業成功，或是出價者帳戶未指定 Cookie 比對報表網址，Google 預設會放送 1x1 透明像素，工作流程也會在此結束。後續出價要求中，這位使用者的曝光次數會包含出價者在 BidRequest.user.buyeruid 中代管的相符資料。出價方也可以使用指定的代管比對資料，填入使用者名單。

否則，如果發生錯誤，Google 會將重新導向傳送至競價者的 Cookie 比對報表網址，並在 google_error 參數中指定錯誤原因。如果競價者的 Cookie 比對報表網址為 https://ad.network.com/report，重新導向網址會如下所示：

<img src="https://ad.network.com/report?google_error=ERROR_ID" />

注意：出價者可以要求帳戶一律重新導向至 Cookie 比對報表網址，即使作業成功也一樣。如要啟用這項功能，請與技術支援客戶經理聯絡。

步驟 5：使用者的瀏覽器會重新導向至競價者的 Cookie 比對報表網址

使用者的瀏覽器會重新導向至競價者的 Cookie 比對報表網址，包括 Google 在 google_error 參數中指定的錯誤原因 (如有)。如要進一步瞭解如何解讀錯誤代碼，請參閱參數說明。

注意：只有在出價者的帳戶設定為將作業失敗或成功資訊傳送至 Cookie 比對報表網址時，才會執行這個步驟。

步驟 6：出價者提供 1x1 透明像素

出價者必須向使用者瀏覽器放送 1x1 透明像素，以做出回應。

注意：只有在出價者的帳戶設定為將作業失敗或成功資訊傳送至 Cookie 比對報表網址時，才會執行這個步驟。

美國州別使用者 (有隱私權限制) 的 Cookie 比對工作流程圖

對於位於隱私權限制美國州別的使用者，預設工作流程如下圖所示，其中要求和回應以箭頭表示，隨附的資料項目則列於括號中。

競價工具重新導向至 Google Cookie 比對服務的網址參數

參數	說明
google_nid	出價者帳戶的網路 ID (NID)。這個 ID 可透過 Bidders 資源擷取。
google_sc	這個參數已淘汰。如果使用者沒有 Google Cookie，系統會設定。系統會忽略參數值，因此可以省略。如果沒有 Cookie，省略參數會導致錯誤。
google_no_sc	這個參數已淘汰。這會向 Google 的 Cookie 比對服務指出，如果使用者沒有 Cookie，就不應為使用者設定 Cookie。系統會忽略參數值，因此可以省略。
google_hm	包含出價者想儲存在 Google 代管比對資料表中的資料。 注意：這個值是網路安全 Base64 編碼的字串 (可選用填補)，不得超過 40 個位元組。舉例來說，這可能看起來像這樣：Q29va2llIG51bWJlciAxIQ==。
google_redir	您希望 Google 傳送 HTTP 302 重新導向的編碼網址。指定的網址會收到重新導向，其中包含錯誤和成功作業的 google_error 參數。
google_ula	用於將使用者新增至現有使用者名單的字串。這個值的預期格式為 userlistid[,timestamp]： userlistid：單一數值使用者名單 ID。 timestamp：POSIX 格式的選用時間戳記， 表示使用者加入使用者名單的時間。 這個網址參數可能會重複，將使用者加入多個清單。
gdpr	指出要求受到《一般資料保護條例》的資料使用限制。詳情請參閱 歐盟地區使用者同意聲明規定，或「Authorized Buyers IAB 資訊公開和同意聲明架構第 2.0 版」說明文件中的「對 Cookie 比對資格的影響」。 範例：gdpr=1
gdpr_consent	代表使用者同意聲明的資訊公開和同意聲明字串。詳情請參閱歐盟地區使用者同意聲明規定，或 Authorized Buyers IAB 資訊公開和同意聲明架構第 2.0 版文件中的「資訊公開和同意聲明字串的傳遞方式為何？」。
process_consent	表示出價者已取得使用者同意，可將資料用於 Google 歐盟地區使用者同意授權政策中指定的用途。 如果請求不受《歐盟地區使用者同意授權政策》規範，或請求中含有其他同意聲明參數 (gdpr_consent)，系統會忽略這個參數。 範例：process_consent=T

Google 重新導向至廣告主 Cookie 比對報表網址時使用的網址參數

參數

說明

google_error

表示整體要求錯誤的整數值。收到這項回應時，表示系統未執行任何作業，也不會設定其他 google_ 回應參數。支援的錯誤值包括： 1：使用者有 Google Cookie，但已選擇停用任何使用這項 Cookie 的追蹤功能。 2：未指定任何有效作業。舉例來說，系統收到的是無作業要求。 3：使用者沒有 Google Cookie。Google 不會透過 Cookie 比對服務設定 Cookie。 4：指定的操作相互衝突。您不得在同一項要求中同時指定 google_push 和 google_cm 旗標，因為這兩個旗標的用途互斥。 5：在重新導向至 Google 伺服器時，系統傳遞了無效的 google_push 參數，這是雙向像素比對要求的一部分。重新導向必須將 google_push 設為與初始像素要求中傳遞給您的值相同。 6：比對代碼中提供的 NID 無效。 7：系統偵測到無效的 Cookie。 8：已淘汰。找不到 Cookie。 9：找不到 Cookie，系統會嘗試設定測試 Cookie。 10：使用 google_redir 參數時未指定 google_hm，或同時使用 google_redir 和 google_cm。 15：要求來自 Google 規定比對資料表必須由 Google 代管的區域。因此，這項回應不含 Google 使用者 ID。

Google 發起：雙向像素比對

雙向 Pixel 比對是 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 在要求中提供的值。與出價方發起的類似工作流程相同，您也可以指定其他參數，滿足其他用途。

警告：google_cm 和 google_push 參數絕不應在同一項要求中，傳送至 Google 的 Cookie 比對服務。

步驟 3：Google 處理重新導向並以像素回應

Google 會記錄已為使用者建立比對，並處理透過查詢參數要求的任何其他作業。最後，Google 會傳回 1x1 透明像素。

像素比對工作流程圖

下圖說明這個工作流程，其中要求和回應以箭頭表示，隨附的資料項目則列於括號中。

Google 比對代碼要求參數

參數	說明
google_gid	Google 使用者 ID。如果使用者並非來自隱私權受限的美國州別，Google 比對代碼一律會指定這項設定。
google_cver	Cookie 版本。Google 的比對代碼一律會指定這項資訊。
google_push	表示這項要求正在啟動 Pixel 比對工作流程。 該值必須透過競價者的重新導向回應中的對應參數傳回。
gdpr_consent	代表使用者同意聲明的資訊公開和同意聲明字串。詳情請參閱 [歐盟使用者同意聲明規定](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements)，或 [Authorized Buyers IAB TCF v2.0 文件](//support.google.com/authorizedbuyers/answer/9789378)中的「如何傳遞 TC 字串？」。

競價者像素比對重新導向參數

參數	說明
google_nid	出價者帳戶的網路 ID (NID)。這個 ID 可透過 Bidders 資源擷取。
google_push	表示這項重新導向正在完成 Pixel 比對工作流程。請在此指定對應 Google 比對代碼的值。
google_hm	包含出價者想儲存在 Google 代管比對資料表中的資料。 注意：這個值是網路安全 Base64 編碼的字串 (可選用填補)，不得超過 40 個位元組。舉例來說，這可能看起來像這樣：Q29va2llIG51bWJlciAxIQ==。
google_ula	用於將使用者新增至現有使用者名單的字串。這個值的預期格式為 userlistid[,timestamp]： userlistid：單一數值使用者名單 ID。 timestamp：POSIX 格式的選用時間戳記， 表示使用者加入使用者名單的時間。 這個網址參數可能會重複，將使用者加入多個清單。
gdpr_consent	代表使用者同意聲明的資訊公開和同意聲明字串。詳情請參閱 [歐盟地區使用者同意聲明規定](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements)，或 [Authorized Buyers IAB TCF v2.0 說明文件](//support.google.com/authorizedbuyers/answer/9789378)中的「如何傳遞 TC 字串？」。

Google 發起：單向像素比對

單向像素比對與雙向工作流程不同，因為 Google 的比對代碼不會包含指定 Google 使用者 ID 的參數，但會繼續填入 Google 代管的比對表。如果出價者無法在自己的比對表格中代管 Google 使用者 ID，就可以使用這項功能。以下步驟摘要說明修訂後的工作流程。

注意：如果使用者來自隱私權受限的美國州別，就必須採用這個工作流程，但出價者也可以選擇在其他地區採用這個工作流程。

步驟 1：Google 會放置比對標記

Google 會為演算法選取的競價者安插比對代碼。比對代碼包含 google_push 參數。範例如下：

<img src="https://ad.network.com/pixel?google_push=PUSH_DATA" />

步驟 2：使用者的瀏覽器向競價者的 Cookie 比對網址要求像素

使用者的瀏覽器會向競價者的 Cookie 比對網址要求像素，包括 HTTP 標頭中的競價者 Cookie。

步驟 3：重新導向至 Google 的 Cookie 比對服務

出價者的 Cookie 比對端點必須重新導向至 Google 的 Cookie 比對服務，包括填入以具網路安全性的 Base64 編碼方式編碼的 Cookie 資料的 google_hm 參數。重新導向網址可能如下所示：

https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA&google_push=PUSH_DATA

步驟 4：使用者的瀏覽器會重新導向至 Google 的 Cookie 比對服務

Google 會收到含有您指定參數的重新導向，以及 HTTP 標頭中的 Google Cookie。如果作業成功，後續出價請求中，這位使用者的曝光次數會包含出價者在 BidRequest.user.buyeruid 中代管的比對資料。出價方也可以使用指定的代管比對資料填入使用者名單。

最後，Google 會將 1x1 透明像素傳回使用者的瀏覽器。

Cookie 比對輔助

廣告交易平台可透過公開出價，使用廣告主發起和 Google 發起的 Cookie 比對工作流程，比對 Google 使用者 ID 與 Cookie。Cookie 比對輔助 (CMA) 是交易平台的一項額外功能，可讓交易平台與自己的競價者建立比對表。

Cookie 比對輔助功能的運作方式

注意：Cookie 比對輔助功能將於 2025 年 10 月 28 日淘汰。

1. 放送廣告時，Google 會以演算法選取參與的廣告交易平台，並安插 Cookie 比對輔助代碼，其結構如下：

   <img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>

   注意：如果使用者來自隱私權受限的美國州別，Cookie Match Assist 不會納入 google_gid 參數。

2. Google 的 CMA 比對代碼會導致交易所的 Cookie 比對網址收到像素要求。

   注意：與 Google 發起的流程不同，這項流程不包含 google_push 參數。
3. 交易所的 Cookie 比對端點會收到要求，並由交易所的 Cookie 比對服務負責將使用者 ID 與其中一個出價者比對。在下圖中，交易所的 Cookie 比對服務會將重新導向傳送至其中一個競價工具端點，以回應使用者的瀏覽器。
4. 出價方會收到要求，以及廣告交易平台指定的任何參數，以便將使用者 ID 與 Cookie 相符。

注意：視交易所的實作方式而定，出價者可能會額外重新導向至交易所，以便在交易所代管的相符資料表中設定 Cookie。

限制

限制新媒合要求的頻率

如果使用者在 Google 代管的比對資料表中擁有新項目，出價方有責任限制對 Cookie 比對服務的呼叫次數。代管對照表中的項目可能在 14 天後過期，屆時可以重新整理。

警告：Google 不會在放送時強制執行展示頻率上限。 不過，系統會定期監控您是否遵守頻率上限政策，並保留在發生違規情形時中斷服務的權利。

回覆所有像素比對要求

使用 Pixel 比對工作流程的出價者，應對所有傳入的 Pixel 比對要求做出回應，包括 google_push 參數。Google 會監控使用情形，確保政策獲得落實。如果競價者的回應率低於 90%，Google 會限制傳送至其帳戶的 Pixel 比對要求數量。

使用 HTTPS 端點

所有 Cookie 比對工作流程中使用的端點都必須使用 HTTPS。

透過 HTTPS 傳送給您的 Pixel 比對要求，您必須透過 HTTPS 重新導向至 Cookie 比對服務。同樣地，重新導向至競價者的 Cookie 比對輔助端點也必須使用 HTTPS。如果透過 HTTP 向 Google 傳送要求的頻率超過每 2 分鐘一次，系統就會限制傳送至您帳戶的相符要求數量。

歐盟使用者同意聲明規定

如果 Cookie 比對要求須遵守 Google 的《歐盟地區使用者同意授權政策》，就應指出使用者同意聲明。這類要求必須指出已透過下列其中一種方式取得同意聲明：

• TCFv2：包括 gdpr 和 gdpr_consent 參數。詳情請參閱 Authorized Buyers IAB 資訊公開和同意聲明架構第 2.0 版說明文件。
• process_consent：聲明出價者已取得必要的使用者同意聲明。

範例

下列範例說明如何使用 Cookie 比對服務達成特定目標。請注意，除非另有說明，否則系統會假設受影響的使用者並非來自隱私權受限的美國州別。

填入廣告主代管的對照表

出價者可以在比對代碼中只提供 google_nid 和 google_cm 參數，藉此使用 Cookie 比對工作流程填入自己的比對表。這可能如下所示：

<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

如果使用者沒有 Google Cookie，導致 Cookie 比對作業失敗，回應會是：

https://ad.network.com/pixel?id=1&google_error=3

錯誤代碼取決於錯誤的根本原因。如要進一步瞭解 Cookie 比對工作流程可能出現的錯誤代碼，請參閱重新導向網址參數。

注意：當 Google 重新導向至競價者的 Cookie 比對網址時，系統會照原樣傳遞比對代碼中顯示的競價者定義參數 id。

新增至單一使用者名單

您可以在競價者的比對代碼中指定 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_ula 的值為 12345,0，表示應將使用者新增至 ID 為 12345 的使用者名單，而在此情況下，時間戳記會設為 0，表示未指定時間戳記。或者，也可以只提供使用者名單 ID。

如果發生整體錯誤 (例如使用者沒有 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。這可能如下所示：

https://ad.network.com/pixel?id=&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1&google_ula=12345,0

將比對結果儲存在 Google 代管的比對資料表中

如果出價者想將 Cookie 資料儲存在 Google 代管的對照表，且不打算在自己的對照表中儲存與 Google User-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_cm，且成功的回應中未包含 google_hm，因此重新導向中沒有 google_gid 參數。在日後針對這位使用者放送的曝光出價要求中，出價者會在 BidRequest.user.buyeruid 中收到代管比對資料。

如果出價者改用比對代碼，且 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_gid 中指定的 Google 使用者 ID 與比對表中的 Cookie 資料。此外，他們可以判斷 Google 代管的對照表和使用者名單作業是否成功。因此，出價方設定的任何預先指定目標，只要指定特定使用者名單 ID，出價方就會收到來自該使用者的曝光出價要求。同樣地，在這些出價要求中，出價方會在 BidRequest.user.buyeruid 中收到代管比對資料。