使用伺服器端代碼管理工具導入同意聲明模式

本文旨在協助開發人員在網站上導入同意聲明解決方案,並想在伺服器端環境中使用同意聲明模式。

同意聲明模式用來將使用者的 Cookie 或應用程式 ID 同意聲明狀態傳送給 Google。代碼會遵照使用者選用的設定調整行為。同意聲明模式不提供同意聲明橫幅或小工具,而是與您的同意聲明管理平台 (CMP) 互動。

如要深入瞭解同意聲明模式,請參閱「網站和行動應用程式中的同意聲明模式」一文

如要導入同意聲明模式,必須符合下列規定:

  • 具備您要設定之 Google 產品的管理員存取權
  • 您網站上與 Google 同意聲明模式 API 或 gtag.js 相容的同意聲明解決方案或 Cookie 橫幅
  • Google 代碼管理工具網頁容器伺服器容器
  • 伺服器容器中的 Google Analytics (分析):GA4 用戶端來接收同意聲明資料

同意聲明模式如何與伺服器端代碼搭配運作

同意聲明橫幅會將同意聲明選項傳送至 Google 代碼。Google 代碼會將資料傳送至伺服器。

  1. 您網站上的同意聲明橫幅會收到使用者選擇的同意聲明選項,並將選項傳送至 Google 代碼。

  2. Google 代碼會將同意聲明參數新增至 HTTP 要求,將使用者的偏好設定傳送至伺服器容器。

  3. 伺服器中的 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 使用。

支援的功能

Floodlight 計數器/銷售

修課條件

為了讓這些代碼順利運作,您必須在伺服器容器中安裝轉換連接器代碼。

代碼行為

  • ad_storage: granted:Floodlight 代碼可正常運作。
  • ad_storage: denied - 封鎖 HTTP 要求和 Cookie 使用。

支援的功能

  • 網址直通:必須在用戶端 Google 代碼中啟用。
  • 廣告資料遮蓋:當 ad_storage 遭拒時,代碼不會傳送要求以儲存資料。
  • 資訊公開和同意聲明架構第 2.0 版整合:如果在整個網頁的網站容器中啟用整個網頁,即可運作。

後續步驟