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

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

本指南將說明如何傳送 Google Analytics 評估通訊協定網站和應用程式串流將「事件」套用至 Google Analytics 伺服器，方便你在 Google Analytics 報表。

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

設定要求的格式

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：

measurement_id 不是串流 ID。

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

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

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

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

如要在類似報表內顯示使用者活動，即時、 engagement_time_msec 和 session_id 必須做為 event 的 params。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 是保留活動時 name、建立新的 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 時有下列限制數據分析：

要求最多可包含 25 個事件。
事件最多只能有 25 個參數。
事件最多只能有 25 個使用者屬性。
使用者屬性的名稱不能超過 24 個半形字元。
使用者屬性的值不能超過 36 個半形字元。
事件名稱長度不得超過 40 個字元，只能由英數字元組成字元和底線，且必須以字母字元開頭。
包含項目參數的參數名稱不能超過 40 個半形字元。只能包含英數字元和底線，且開頭須為的符記
包含項目參數值的參數值必須是 100 個字元，或標準 Google Analytics 4 資源的費用上限，則最多 500 個半形字元 Google Analytics 360 資源可能會比較少
項目參數最多可以有 10 個自訂參數。
貼文內文必須小於 130 KB。
系統最多支援 Measurement Protocol 事件的事件層級歸因，將最近一次標記線上事件加入轉換的 63 天後廣告和其他媒體整合，包括轉換回溯期轉換事件超過 63 天。反之，事件層級整個轉換都可使用歸因線上事件代碼功能視窗。
進行再行銷時，您最多可彙整 Measurement Protocol 事件至從最近一次線上活動到相關的 Cookie 或裝置 ID：
- 網站串流：30 天
- 應用程式串流：42 天
傳送到 Google Analytics 4 的 App Measurement Protocol 事件無法填入資料在 Google Ads 中搜尋應用程式使用者。