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

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

本文將說明如何執行以下作業:

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

事前準備

本指南假設您已具備以下條件:

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. 在伺服器端容器中,依序點選「Clients」>「New」
  7. 在「用戶端設定」中,選取「Measurement Protocol」用戶端類型。
  8. 將「啟用路徑」設為應用程式收集端點的路徑。
  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. 在伺服器端容器中,依序點選「Clients」>「New」
  2. 在「用戶端設定」中,選取「Measurement Protocol」用戶端類型。
  3. 將「啟用路徑」設為伺服器端點的路徑。
  4. 儲存用戶端設定並發布容器。

後續步驟

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

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