本文將說明將事件傳送至伺服器端的各種方式 都會在 Docker 容器中執行如需更多背景資訊,請參閱伺服器端代碼的運作方式。
本文將說明如何:
- 將網站資料傳送至伺服器端容器
- 傳送其他資料至伺服器容器
- 接收伺服器端容器中的資料
- 傳送來自網站以外來源的資料
事前準備
本指南假設您已:
1. 將網站資料傳送至伺服器端容器
你可以透過代碼管理工具採用伺服器端導入來轉送資料,或是 gtag.js。選擇導入選項。
選用:隨著每個事件傳送其他參數
您可以傳送其他兩種額外參數:設定層級 參數和事件層級參數設定參數會影響 Google 代碼的行為,且只能在 Google 代碼層級設定。
事件參數會指定事件的其他資訊,您可以設定
定義所有事件、選取事件或 page_view
事件。
2. 接收伺服器端容器中的資料
當您將 HTTP 要求傳送至伺服器容器時,用戶端必須聲明該要求。
如要查看可用用戶端清單,請按照下列步驟操作:
開啟伺服器容器。
在左側導覽列中,按一下「客戶」。GA4 客戶是 預先安裝於伺服器端容器中。如果需要 若是通用 Analytics,請設定「Google Analytics:通用 Analytics」 用戶端。
按一下客戶名稱即可查看或編輯詳細資料。
用戶端設定 (選用)
在大多數情況下,用戶端不需要修改。不過,用途 因此,建議您編輯下列其中一種設定:
優先順序:決定用戶端的執行順序。數字較高 且符合傳入要求的第一個用戶端 成為該要求的有效用戶端。
啟用條件:啟用條件會定義用戶端何時 回應要求:
如果是通用 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 用戶端來剖析 從中產生事件資料
某些伺服器代碼會在傳出 不必經過設定若要排除這些參數,請建立轉換 來移除值。
如何在其他代碼中使用其他參數:
- 在伺服器容器中,按一下左側導覽中的「Variables」。
- 建立新的使用者定義的變數。
- 在「變數設定」中,選取「事件資料」變數類型。
- 在「Key Path」(金鑰路徑) 中,輸入參數的名稱。
- 為變數命名,然後按一下「儲存」。
您現在可以在伺服器內的任何其他代碼中使用該事件參數 都會在 Docker 容器中執行
3. 選用:從網站以外的來源傳送資料
Google Analytics Measurement Protocol 可用於啟用伺服器端代碼支援,來源包括行動應用程式和伺服器對伺服器應用程式。
行動應用程式
若要讓 Android 或 iOS 應用程式傳送資料至伺服器容器,您必須 建立自訂圖片代碼,並將其設為使用 Measurement Protocol:
- 在行動容器 (Android 或 iOS) 中,按一下 [代碼] > [新功能:
- 在「代碼設定」中,選取「自訂圖片」代碼類型。
- 將「圖片網址」的值設為伺服器容器上的像素映像檔:
您在稍早指定的 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
- 取消選取「啟用快取清除」。
- 儲存代碼並發布容器。
- 在伺服器端容器中,按一下 [用戶端] > 新功能:
- 在「用戶端設定」中,選取「Measurement Protocol」用戶端 類型。
- 將「Activation Path」(啟用路徑) 設為應用程式的集合端點路徑。
- 儲存用戶端設定並發布伺服器端容器。
伺服器對伺服器應用程式
如要將 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 用戶端進行安裝:
- 在伺服器端容器中,依序按一下「Clients」>「New」。
- 在「用戶端設定」中,選取「Measurement Protocol」用戶端 類型。
- 將「Activation Path」設為伺服器端點的路徑。
- 儲存用戶端設定並發布容器。
後續步驟
為了在真正的第一方情境下傳送資料,您需要提供 Google 指令碼。 例如 Google Analytics 程式庫