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

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

本文將說明如何：

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

事前準備

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

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

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

Google 代碼：GA4

如要設定伺服器端處理作業的 Google 代碼，您必須新增伺服器容器網址。

為伺服器容器網址建立設定變數

  1. 開啟 Google 代碼管理工具

  2. 選取要設定的網頁容器。

  3. 開啟「變數」選單。

  4. 建立類型為「Google 代碼：配置設定」的新使用者定義變數。

  5. 新增下列參數：

    • Name (名稱)：server_container_url
    • Value (值)：設為代碼管理工具伺服器容器的網址。

  6. 為變數命名 (例如「伺服器網址」)，然後儲存該變數。

將伺服器容器網址指派給 Google 代碼

  1. 並開啟 「代碼」選單。
  2. 新增 Google 代碼或編輯現有代碼。
  3. 在「配置設定」中，選取您剛建立的伺服器容器變數。
  4. 為確保 Google 代碼在其他觸發條件之前觸發，請按一下「觸發條件」，然後使用「初始化 - 所有網頁」做為觸發條件。進一步瞭解網頁觸發條件。
  5. 「儲存」代碼並「發布」容器。

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

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

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

設定參數所有活動選取事件page_view 個事件

瞭解如何在 Google 代碼管理工具中重複使用配置設定。

如要針對所有事件傳送其他參數，請在 Google 代碼管理工具中重複使用事件設定。

如要使用 Google Analytics 4 事件傳送其他參數，請按照下列步驟操作：

  1. 在網頁容器中，新增 Google Analytics 4 事件代碼或編輯現有代碼。
  2. 依序點選「事件參數」>「新增列」。
  3. 新增要隨事件傳送的參數。如需預先定義的事件參數，請參閱建議事件參考資料。
    • 在「欄位名稱」中加入參數名稱，例如 language。
    • 在「值」中，新增參數的值。
  1. 將觸發條件設為在「初始化 - 所有網頁」觸發。
  2. 「儲存」代碼並「發布」容器。

如要傳送 page_view 事件的參數，請按照下列步驟操作：

  1. 在網頁容器中編輯現有的 Google 代碼。

  2. 新增參數，停用設定中的預設 page_view：

    • Name (名稱)：send_page_view
    • 值：false

  3. 建立新的 Google Analytics：GA4 事件代碼。

    • 選取您在步驟 1 中修改的設定代碼。
    • 將「事件名稱」設為 page_view。

  4. 新增要隨事件傳送的參數。如需預先定義的事件參數，請參閱建議事件參考資料。- 在「欄位名稱」中新增參數名稱，例如 language。

    • 在「值」中新增參數的值。
  1. 將觸發條件設為在「初始化 - 所有網頁」觸發。
  2. 「儲存」代碼並「發布」容器。

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 指令碼