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

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

本文將說明如何：

  • 將網站資料傳送至伺服器端容器
  • 傳送其他資料至伺服器容器
  • 接收伺服器端容器中的資料
  • 傳送來自網站以外來源的資料

事前準備

本指南假設您已：

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

你可以透過代碼管理工具採用伺服器端導入來轉送資料，或是 gtag.js。選擇導入選項。

請選擇您的導入選項。

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

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

事件參數會指定事件的其他資訊，您可以設定 定義所有事件、選取事件或 page_view 事件。

請選擇您的導入選項。

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

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

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

  1. 開啟 Google 代碼管理工具

  2. 開啟伺服器容器。

  3. 在左側導覽列中，按一下「客戶」。GA4 客戶是 預先安裝於伺服器端容器中。如果需要 若是通用 Analytics，請設定「Google Analytics：通用 Analytics」 用戶端。

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

用戶端設定 (選用)

在大多數情況下，用戶端不需要修改。不過，用途 因此，建議您編輯下列其中一種設定：

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

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

    • 如果是通用 Analytics 客戶：預設通用 Analytics 路徑：客戶會 要求路徑包含 /collect、/r/collect 和 傳送資料給 Google 的 JavaScript 檔案使用的其他類似路徑 分析這項設定預設為啟用。

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

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

如要傳送其他參數， 在伺服器容器中設定 Google Analytics 4 用戶端來剖析 從中產生事件資料

某些伺服器代碼會在傳出 不必經過設定若要排除這些參數，請建立轉換 來移除值。

如何在其他代碼中使用其他參數：

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

您現在可以在伺服器內的任何其他代碼中使用該事件參數 都會在 Docker 容器中執行

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

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. 儲存用戶端設定並發布伺服器端容器。

伺服器對伺服器應用程式

如要將 Measurement Protocol 資料傳送至伺服器容器，請將 含有伺服器網域名稱的 www.google-analytics.com 主機名稱 都會在 Docker 容器中執行例如：

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. 在伺服器端容器中，依序按一下「Clients」>「New」。
  2. 在「用戶端設定」中，選取「Measurement Protocol」用戶端 類型。
  3. 將「Activation Path」設為伺服器端點的路徑。
  4. 儲存用戶端設定並發布容器。

後續步驟

為了在真正的第一方情境下傳送資料，您需要提供 Google 指令碼。 例如 Google Analytics 程式庫

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