本頁面由 Cloud Translation API 翻譯而成。

將 Measurement Protocol 事件傳送至 Google Analytics (分析)

本指南說明如何將 Google Analytics (分析) Measurement Protocol 網站和應用程式串流事件傳送至 Google Analytics (分析) 伺服器，這樣才能在 Google Analytics (分析) 報表中查看 Measurement Protocol 事件。

選擇您要在本指南中看到的平台：

設定要求的格式

Google Analytics (分析) 4 的 Measurement Protocol 僅支援 HTTP POST 要求。

如要傳送事件，請使用下列格式：

POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>

您必須在要求網址中提供以下內容：

api_secret：Google Analytics (分析) UI 中產生的 API SECRET。

如要建立新的密鑰，請依序前往「管理」 >「資料串流」 >「選擇串流」 >「Measurement Protocol」 >「建立」。

measurement_id：與串流相關聯的評估 ID。您可以在 Google Analytics (分析) UI 的「管理」 >「資料串流」 >「選擇串流」 >「評估 ID」中找到這個 ID。

measurement_id 不是串流 ID。

如需完整參考資料，請參閱查詢參數。

您必須在要求主體中提供以下內容：

client_id：客戶的專屬 ID。這與 Firebase app_instance_id 不同。使用 gtag.js('get')。

user_id：選用。使用者的專屬 ID。只能包含 utf-8 字元。如要進一步瞭解這個 ID，請參閱「跨平台分析的 User-ID」。
consent：選用。瞭解如何設定同意聲明設定。
events：事件項目的陣列。您可以在單一要求中加入多個事件。

如要在「即時」等報表中顯示使用者活動，必須在 event 的 params 中提供 engagement_time_msec 和 session_id。engagement_time_msec 參數應反映事件的參與時間 (以毫秒為單位)。

範例如下：

  {
   "client_id": "123456.7654321",
   "events": [
     {
        "name": "campaign_details",
        "params": {
          "campaign_id": "google_1234",
          "campaign": "Summer_fun",
          "source": "google",
          "medium": "cpc",
          "term": "summer+travel",
          "content": "logolink",
          "session_id": "123",
          "engagement_time_msec": "100"
        }
     }
   ]
  }

session_start 是保留事件名稱，但建立新的 session_id 時，系統會在無需傳送 session_start 的情況下建立新的工作階段。瞭解工作階段的計算方式。

立即試用

以下舉例說明如何將 tutorial_begin 事件傳送至 Google Analytics (分析) 伺服器：

const measurement_id = `G-XXXXXXXXXX`;
const api_secret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurement_id}&api_secret=${api_secret}`, {
  method: "POST",
  body: JSON.stringify({
    client_id: 'XXXXXXXXXX.YYYYYYYYYY',
    events: [{
      name: 'tutorial_begin',
      params: {},
    }]
  })
});

限制

將 Measurement Protocol 事件傳送至 Google Analytics (分析) 時，有以下限制：

要求最多可包含 25 個事件。
事件最多只能有 25 個參數。
事件最多只能有 25 個使用者屬性。
使用者屬性的名稱不能超過 24 個半形字元。
使用者屬性的值不能超過 36 個半形字元。
事件名稱不得超過 40 個半形字元、只能使用英數字元和底線，且必須以字母字元開頭。
包含項目參數的參數名稱不能超過 40 個字元、只能包含英數字元和底線，且必須以字母字元開頭。
標準 Google Analytics (分析) 4 資源中的項目參數值不得超過 100 個半形字元，Google Analytics (分析) 360 資源最多 500 個半形字元。
項目參數最多可以有 10 個自訂參數。
貼文內文必須小於 130 KB。
評估 Protocol 事件的最新標記線上事件後，最晚可在 63 天內將轉換匯出至 Google Ads 和其他媒體整合，即使轉換事件的轉換回溯期超過 63 天也一樣。相反地，整個轉換回溯期支援事件層級歸因線上事件。
進行再行銷時，您可以在最近一次線上事件和相關 Cookie 或裝置 ID 後的幾天內，加入 Measurement Protocol 事件：
- 網站串流：30 天
- 應用程式串流：42 天
傳送到 Google Analytics (分析) 4 的 App Measurement Protocol 事件不會在 Google Ads 中填入應用程式使用者的搜尋目標對象。