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

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

本文將說明如何：

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

事前準備

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

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

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

請選擇導入選項。

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

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

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

請選擇您的導入選項。

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 可用於啟用伺服器端代碼支援，來源包括行動應用程式和伺服器對伺服器應用程式。

行動應用程式

如要讓 Android 或 iOS 應用程式將資料傳送至伺服器容器，您必須建立自訂圖像代碼，並將其設為使用評估資料記錄協定：

  1. 在行動容器 (Android 或 iOS) 中，依序點選「代碼」>「新增」。
  2. 在「代碼設定」中，選取「自訂圖片」代碼類型。
  3. 將「圖片網址」的值設為伺服器容器中的像素圖片，位於先前在評估資料通訊協定用戶端中指定的路徑。將所需的 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. 在伺服器端容器中，依序按一下「Clients」>「New」。
  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. 在伺服器端容器中，依序按一下「Clients」>「New」。
  2. 在「用戶端設定」中，選取「Measurement Protocol」用戶端類型。
  3. 將「Activation Path」設為伺服器端點的路徑。
  4. 儲存用戶端設定並發布容器。

後續步驟

如要在真正的第一方環境中傳送資料，您必須從自有伺服器提供 Google 指令碼 (例如 Google Analytics 程式庫)。

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