本文旨在協助開發人員在網站上導入同意聲明解決方案,並想在伺服器端環境中使用同意聲明模式。
什麼是同意聲明模式?
同意聲明模式用來將使用者的 Cookie 或應用程式 ID 同意聲明狀態傳送給 Google。代碼會遵照使用者選用的設定調整行為。同意聲明模式不提供同意聲明橫幅或小工具,而是與您的同意聲明管理平台 (CMP) 互動。
如要深入瞭解同意聲明模式,請參閱「網站和行動應用程式中的同意聲明模式」一文
如要導入同意聲明模式,必須符合下列規定:
- 具備您要設定之 Google 產品的管理員存取權
- 您網站上與 Google 同意聲明模式 API 或 gtag.js 相容的同意聲明解決方案或 Cookie 橫幅
- Google 代碼管理工具網頁容器和伺服器容器。
- 伺服器容器中的 Google Analytics (分析):GA4 用戶端來接收同意聲明資料
同意聲明模式如何與伺服器端代碼搭配運作
您網站上的同意聲明橫幅會收到使用者選擇的同意聲明選項,並將選項傳送至 Google 代碼。
Google 代碼會將同意聲明參數新增至 HTTP 要求,將使用者的偏好設定傳送至伺服器容器。
伺服器中的 Google 產品標記會感知同意聲明,並根據使用者的偏好設定調整傳送的資料量和類型。
進階同意聲明模式
伺服器容器同時支援基本和進階同意聲明模式。
在網站容器中導入進階同意聲明模式,並使用區域專屬設定後,請設定標記伺服器來支援區域專屬設定。
範例
貴機構要求您為 Google Analytics (分析) 4 和 Google Ads 轉換追蹤導入 Google 的同意聲明模式 API。網站上已經有 Cookie 橫幅,您可以使用網頁容器中的社群範本進行部署。
您必須確保使用者接受 Google Ads (ad_storage
) 和 Analytics (分析) (analytics_storage
) Cookie 時,Google Ads 和 Google Analytics (分析) 代碼才會觸發。使用者拒絕 Google Ads 或 Analytics (分析) Cookie 時,代碼應一律將不含 Cookie 的
連線偵測 (ping) 傳送至他們的目的地。
如要透過伺服器端代碼導入同意聲明模式,您需要下列元件:
網站容器 (用戶端)
- Cookie 橫幅 - 詢問是否同意儲存 Google Ads 和 Google Analytics (分析) 的 Cookie。在使用者決定更新同意聲明狀態。
- Google 代碼 - 在瀏覽器中初始化 Google Analytics (分析) 4 程式庫,並將資料傳送至伺服器容器。
伺服器容器 (伺服器端)
- 用戶端:Google Analytics (分析):GA4 用戶端 - 解讀網站容器收到的 HTTP 要求。
- 代碼:「轉換連接器」 - 評估轉換。
- 代碼:Google Ads 轉換追蹤 - 將轉換資料傳送至 Google Ads
同意聲明設定對代碼行為的影響
下列分頁說明特定代碼在同意聲明模式中的行為。
Google Analytics (分析) 4
代碼行為
analytics_storage: granted
- Google Analytics (分析) 4 可正常運作。analytics_storage: denied
- 同意聲明模式 (基本導入):只要使用者不同意 Analytics (分析) Cookie,Google 代碼就會完全封鎖 (即停止載入)。用戶端和伺服器不會設定、存取或讀取裝置上任何 Analytics (分析) Cookie。
- 同意聲明模式 (進階導入):無論同意聲明狀態為何,Google 代碼都會在每個網頁上載入。Google 代碼會使用同意聲明模式指令,根據使用者 Cookie 同意聲明選項調整行為。當使用者拒絕 ad_storage 時,系統會將不含 Cookie 的連線偵測 (ping) 傳送至 Google Analytics (分析)。不含 Cookie 的連線偵測 (ping) 是匿名且無法辨識的 Google Analytics (分析) 事件。 用戶端和伺服器都不會在這類裝置上設定、存取或讀取 Analytics (分析) Cookie。
支援的功能
- 網址直通:必須在用戶端 Google 代碼中啟用。
- 資訊公開和同意聲明架構第 2.0 版整合:如果在整個網頁的網站容器中啟用整個網頁,即可運作。系統會讀取資訊公開和同意聲明架構字串,以便支援廣告個人化和 Google 信號。
Google Ads 轉換
修課條件
為了讓這個代碼正常運作,您必須在伺服器容器中安裝轉換連接器代碼。
代碼行為
ad_storage: granted
:Google Ads 轉換代碼可正常運作。ad_storage: denied
- 未寫入或讀取 Google Ads Cookie。而瀏覽器會將轉換像素傳送至不含 Cookie 的網域。
支援的功能
- 網址直通:必須在用戶端 Google 代碼中啟用。
- 廣告資料遮蓋:必須在用戶端 Google 代碼中啟用。
- 資訊公開和同意聲明架構第 2.0 版整合:如果在整個網頁的網站容器中啟用該功能,即可運作。
- 強化轉換:取得同意聲明後才會運作。
Google Ads 再行銷
代碼行為
ad_storage: granted
- Google Ads 再行銷代碼正常運作。ad_storage: denied
- 封鎖 HTTP 要求和 Cookie 使用。
支援的功能
- 網址直通:不支援。
- 廣告資料遮蓋:當
ad_storage
遭拒時,代碼不會傳送要求以儲存資料。 - 資訊公開和同意聲明架構第 2.0 版整合:如果在整個網頁的網站容器中啟用整個網頁,即可運作。
Floodlight 計數器/銷售
修課條件
為了讓這些代碼順利運作,您必須在伺服器容器中安裝轉換連接器代碼。
代碼行為
ad_storage: granted
:Floodlight 代碼可正常運作。ad_storage: denied
- 封鎖 HTTP 要求和 Cookie 使用。
支援的功能
- 網址直通:必須在用戶端 Google 代碼中啟用。
- 廣告資料遮蓋:當
ad_storage
遭拒時,代碼不會傳送要求以儲存資料。 - 資訊公開和同意聲明架構第 2.0 版整合:如果在整個網頁的網站容器中啟用整個網頁,即可運作。