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

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

本文說明如何：

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

事前準備

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

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

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

選擇導入選項。

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

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

事件參數會指定事件的其他資訊，可為所有事件、特定事件或 page_view 事件設定。

選擇導入選項。

設定建議

建議您在網頁上使用 Google Analytics 代碼，將資料傳送至伺服器容器。這個代碼可使用不同的傳輸方式，確保事件的傳送率達到最佳。這類方法包括但不限於

  • 圖片像素
  • Fetch API
  • XHR
  • 在從伺服器容器網域載入的 iframe 中執行的 Service Worker。

如要確保支援所有方法，請檢查下列項目：

內容安全政策 (CSP)

指令 內容 目的
img-src [SERVER_CONTAINER_URL] 評估要求
connect-src [SERVER_CONTAINER_URL] 評估要求
frame-src [SERVER_CONTAINER_URL] 實作 Service Worker

此外，X-Frame-Options 不得限制從伺服器容器網址載入 iframe。

如要瞭解各項產品的具體政策，請參閱 https://developers.google.com/tag-platform/security/guides/csp。

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

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

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

  1. 開啟 Google 代碼管理工具

  2. 開啟伺服器容器。

  3. 在左側導覽列中，按一下「客戶」。伺服器端容器預設會預先安裝 Google Analytics 用戶端。

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

選用用戶端設定

在多數情況下，用戶端不需要修改。不過，您的用途可能不同，因此可能需要編輯下列其中一項設定：

  • 優先順序：決定用戶端執行的順序。系統會先執行數字較大的篩選器，而第一個與傳入要求相符的用戶端，會成為該要求的有效用戶端。

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

    • 特定 ID 的預設 gtag.js 路徑：若啟用這項設定，您就能透過自己的伺服器容器網址取得 gtag.js JavaScript。啟用後，此用戶端會隨之啟動，回應對預設 gtag.js 要求路徑送出的要求。要求路徑的形式如下：/gtag/js?id=TAG_ID。按一下「Add Measurement ID」(新增評估 ID)，新增一或多個目的地 ID。

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

如要傳送額外參數，請在伺服器容器中設定 Google Analytics 用戶端，剖析額外參數並建立事件資料。

部分伺服器代碼會在傳出要求中加入額外參數，無需設定。如要排除這些參數，請建立轉換來移除值。

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

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

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

3. 選用：從網站以外的來源傳送資料

Google Analytics Measurement Protocol 可用於從行動應用程式和伺服器對伺服器應用程式等來源，啟用伺服器端代碼支援功能。這個選項可讓您以 Measurement Protocol 格式將事件傳送至容器。容器會使用與所有其他 SGTM 事件相同的機制，將這些事件傳送至 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. 在「用戶端設定」中，選取「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. 在「用戶端設定」中，選取「Measurement Protocol」用戶端類型。
  3. 將「Activation Path」設為伺服器端點的路徑。
  4. 儲存用戶端設定並發布容器。

後續步驟

如要在真正的第一方情境中傳送資料，您需要從自己的伺服器提供 Google 指令碼，例如 Google Analytics 程式庫。

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