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

本文將說明將事件傳送至伺服器端的各種方式 都會在 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 指令碼