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

本文適用於已在網站上導入同意聲明解決方案,且想在伺服器端環境中使用同意聲明模式的開發人員。

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

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

如要導入同意聲明模式,您需要:

  • 要設定的 Google 產品管理員存取權
  • 網站上的同意聲明解決方案或 Cookie 通知橫幅,必須與 Google 同意聲明模式 API 或 gtag.js 相容
  • 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) 和 Google Analytics (analytics_storage) Cookie 時,系統會觸發 Google Ads 和 Google Analytics 代碼。如果使用者拒絕廣告或 Analytics Cookie,代碼應一律 將不含第三方 Cookie 的評估資料傳送至目的地

如要透過伺服器端代碼導入同意聲明模式,您需要下列元件:

網站容器 (用戶端)

  • 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 的評估資料傳送至 Google Analytics (例如 www.google-analytics.com 或標準 Analytics 網域)。這些評估指標會去識別化,且為無法識別的 Google Analytics 事件。系統不會在用戶端和伺服器上,設定、存取或讀取裝置上的 Analytics Cookie。

支援的功能

  • 網址傳遞:如果已在用戶端 Google 代碼中啟用,即可運作。
  • 整合資訊公開和同意聲明架構第 2.0 版:如果網站容器已啟用,系統就會運作。系統會讀取 TCF 字串,以支援廣告個人化和 Google 信號。

Google Ads 轉換

修課條件

如要讓這個代碼正常運作,請在伺服器容器中安裝轉換連接器代碼。

代碼行為

  • ad_storage: granted - Google Ads 轉換代碼正常運作。
  • ad_storage: denied - 系統不會寫入或讀取 Google Ads Cookie。瀏覽器會將轉換像素傳送至沒有第三方 Cookie 的網域 (例如 pagead2.googlesyndication.com)。

支援的功能

  • 網址傳輸:如果已在用戶端 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 版:如果網站容器已啟用,系統就會運作。

後續步驟