將資料傳送至伺服器端代碼管理工具

本文將說明將事件傳送至伺服器端容器的各種方式。如需更多背景資訊，請參閱伺服器端代碼的運作方式。

本文將說明如何：

  • 將資料從網站傳送至伺服器端容器
  • 將額外資料傳送至伺服器容器
  • 在伺服器端容器中接收資料
  • 從網站以外的來源傳送資料

事前準備

本指南假設您已具備下列條件：

1. 將網站資料傳送至伺服器端容器

您可以透過代碼管理工具或 gtag.js，透過伺服器端導入方式轉送資料。選擇導入選項。

選擇導入選項。

選用：為每個事件傳送其他參數

您可以傳送兩種額外參數：設定層級參數和事件層級參數。設定參數會影響 Google 代碼的行為，且只能在 Google 代碼層級設定。

事件參數會指定事件的額外資訊，且可為所有事件、選取的事件或 page_view 事件設定。

選擇導入選項。

設定建議

建議您在網頁上使用 GA4 代碼，將資料傳送至伺服器容器。這個代碼可以使用不同的傳輸方式，確保事件的傳送率達到最高。這類方法包括但不限於

  • 圖片像素
  • Fetch API
  • XHR
  • 在從伺服器容器網域載入的 iframe 中執行的 Service Worker。

如要確保支援所有方法，請檢查下列項目：

內容安全政策 (CSP)

指令 內容 目的
img-src [SERVER_CONTAINER_URL] 成效評估要求
connect-src [SERVER_CONTAINER_URL] 成效評估要求
frame-src [SERVER_CONTAINER_URL] 實作 Service Worker

此外，X-Frame-Options 不得限制從伺服器容器網址載入 iframe。

如需各產品的特定政策，請參閱 https://developers.google.com/tag-platform/security/guides/csp。

2. 在伺服器端容器中接收資料

將 HTTP 要求傳送至伺服器容器時，用戶端必須聲明該要求。

如要查看可用用戶端清單，請按照下列步驟操作：

  1. 開啟 Google 代碼管理工具

  2. 開啟伺服器容器。

  3. 在左側導覽列中，按一下「客戶」。根據預設，伺服器端容器會預先安裝 GA4 用戶端。

  4. 按一下客戶名稱，即可查看或編輯詳細資料。

選用用戶端設定

在大多數情況下，用戶端不需要修改。不過，您的用途可能不同，因此可能需要編輯下列其中一項設定：

  • 優先順序：決定用戶端執行的順序。數字較高者會優先執行，且與傳入要求相符的第一位用戶端會成為該要求的有效用戶端。

  • 啟用條件：啟用條件會定義用戶端何時回應要求：

    • 特定 ID 的預設 gtag.js 路徑：使用這項設定即可透過您的伺服器容器網址啟用 gtag.js JavaScript 服務。啟用之後，此用戶端將會啟動，以回應針對預設 gtag.js 要求路徑 (例如：/gtag/js?id=TAG_ID) 提出的請求。按一下「新增評估 ID」，新增一或多個目的地 ID。

選用：在伺服器端代碼管理工具中接收其他資料

如果您要傳送其他參數，請在伺服器容器中設定 Google Analytics 4 用戶端，剖析其他參數並從中建立事件資料。

部分伺服器代碼會在輸出要求中加入額外參數，不需進行任何設定。如要排除這些參數，請建立轉換來移除值。

如要在其他代碼中使用額外參數，請按照下列步驟操作：

  1. 在伺服器容器中，按一下左側導覽中的「變數」。
  2. 建立新的使用者定義變數。
  3. 在「變數設定」中，選取「事件資料」變數類型。
  4. 在「金鑰路徑」中輸入參數名稱。
  5. 為變數命名並按一下「儲存」。

現在，您可以在伺服器容器中的任何其他代碼中使用事件參數。

3. 選用：從網站以外的來源傳送資料

Google Analytics Measurement Protocol 可用於啟用伺服器端標記支援，適用於行動應用程式和伺服器對伺服器應用程式等來源。這個選項可讓您以 Measurement Protocol 格式將事件傳送至容器。容器會使用與所有其他 SGTM 事件相同的機制，將這些事件傳送至 Google Analytics。

這個選項不支援 Measurement Protocol 端點的所有功能，例如從標記事件衍生地理位置和裝置資訊。

行動應用程式

如要讓 Android 或 iOS 應用程式將資料傳送至伺服器容器，請建立自訂圖片代碼，並設定使用 Measurement Protocol：

  1. 在行動容器 (Android 或 iOS) 中，依序按一下「代碼」>「新增」。
  2. 在「代碼設定」中，選取「自訂圖片」代碼類型。
  3. 將「圖片網址」的值設為伺服器容器上的像素圖片，路徑為您先前在 Measurement Protocol 用戶端中指定的路徑。在像素網址結尾附加任何所需的 Measurement Protocol 參數：
    https://custom.example.com/app?v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home
  4. 取消選取「啟用快取清除」。
  5. 儲存代碼並發布容器。
  6. 在伺服器端容器中，依序點選「用戶端」>「新增」。
  7. 在「用戶端設定」中，選取「Measurement Protocol」用戶端類型。
  8. 將「Activation Path」設為應用程式收集端點的路徑。
  9. 儲存用戶端設定，並發布伺服器端容器。

伺服器對伺服器應用程式

如要將評估通訊協定資料傳送至伺服器容器，請將 www.google-analytics.com 主機名稱替換為伺服器容器的網域名稱。例如：

POST /batch HTTP/1.1
Host: collection.example.com

v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home

如要接收 Measurement Protocol 點擊，請使用 Measurement Protocol 用戶端設定伺服器端代碼管理工具安裝：

  1. 在伺服器端容器中，依序點選「用戶端」>「新增」。
  2. 在「用戶端設定」中，選取「Measurement Protocol」用戶端類型。
  3. 將「Activation Path」設為伺服器端點的路徑。
  4. 儲存用戶端設定並發布容器。

後續步驟

如要在真正的第一方環境中傳送資料，您需要從自己的伺服器放送 Google 指令碼，例如 Google Analytics 程式庫。

透過我的伺服器載入 Google 指令碼