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

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

本文將說明如何執行下列操作：

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

事前準備

本指南假設您已具備以下項目：

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

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

請選擇導入選項。

選用：透過每個事件傳送額外參數

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

事件參數指定事件的額外資訊，您可以為所有事件、特定事件或 page_view 事件設定。

請選擇導入選項。

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

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

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

  1. 開啟 Google 代碼管理工具

  2. 開啟伺服器容器。

  3. 在左側的導覽列中，按一下「客戶」。根據預設，GA4 用戶端已預先安裝在伺服器端容器中。如要使用通用 Analytics (分析)，請設定 Google Analytics (分析)：通用 Analytics (分析) 用戶端。

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

可選用的用戶端設定

在大多數情況下，用戶端都不需要做任何修改。不過，您的用途可能會有所不同，您可能會想編輯下列其中一項設定：

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

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

    • 通用 Analytics (分析) 用戶端：預設通用 Analytics (分析) 路徑：如果要求路徑包含 /collect、/r/collect，以及其他會將資料傳送至 Google Analytics (分析) 的 JavaScript 檔案所使用的類似路徑，用戶端就會啟用。這項設定預設為啟用。

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

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

如要傳送其他參數，您必須在伺服器容器中設定 Google Analytics (分析) 4 用戶端，才能剖析其他參數並運用這些參數建立事件資料。

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

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

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

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. 在「Client Configuration」(用戶端設定) 中，選取「Measurement Protocol」用戶端類型。
  8. 將「Activation Path」(啟用路徑) 設為應用程式集合端點的路徑。
  9. 儲存用戶端設定並發布伺服器端容器。

伺服器對伺服器應用程式

如要將 Measurement Protocol 資料傳送至伺服器容器，請將 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. 在「Client Configuration」(用戶端設定) 中，選取「Measurement Protocol」用戶端類型。
  3. 將「Activation Path」(啟用路徑) 設為伺服器端點的路徑。
  4. 儲存用戶端設定並發布容器。

後續步驟

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

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