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

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

本指南將說明傳送方式 Google Analytics Measurement Protocol 網站和應用程式串流將「事件」套用至 Google Analytics 伺服器，方便您在 Google Analytics 報表。

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

設定要求的格式

Google Analytics 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：選用。瞭解如何設定同意聲明設定。
timestamp_micros：選用。Unix 紀元時間 (以微秒為單位)，以及事件和使用者屬性如未指定，則預設為要求時間。
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 會使用在下列清單中找到的第一個時間戳記將要求傳回：

事件的 timestamp_micros。
要求的 timestamp_micros。
Measurement Protocol 接收要求的時間。

以下範例傳送的要求層級時間戳記，適用於所有來處理這類事件。因此，Measurement Protocol 會指派 tutorial_begin 和 join_group 事件的時間戳記： requestUnixEpochTimeInMicros。

{
  "timestamp_micros": requestUnixEpochTimeInMicros,
  "events": [
    {
      "name": "tutorial_begin"
    },
    {
      "name": "join_group",
      "params": {
        "group_id": "G_12345",
      }
    }
  ]
}

以下範例會同時傳送要求層級的時間戳記和事件層級時間戳記。因此，Measurement Protocol 會指派 tutorial_begin 事件 (時間戳記為 tutorialBeginUnixEpochTimeInMicros，而 join_group) 事件，時間戳記則是 requestUnixEpochTimeInMicros

{
  "timestamp_micros": requestUnixEpochTimeInMicros,
  "events": [
    {
      "name": "tutorial_begin",
      "timestamp_micros": tutorialBeginUnixEpochTimeInMicros
    },
    {
      "name": "join_group",
      "params": {
        "group_id": "G_12345",
      }
    }
  ]
}

限制

將 Measurement Protocol 事件傳送給 Google 時有下列限制數據分析：

要求最多只能有 25 個事件。
事件最多只能有 25 個參數。
事件最多只能有 25 個使用者屬性。
使用者屬性的名稱不能超過 24 個半形字元。
使用者屬性的值不能超過 36 個半形字元。
事件名稱長度不得超過 40 個字元，只能由英數字元組成字元和底線，且必須以字母字元開頭。
包含項目參數的參數名稱不能超過 40 個半形字元。只能包含英數字元和底線，且開頭須為的符記
包含項目參數值的參數值必須是 100 個字元，或標準 Google Analytics 資源的上限，上限為 500 個半形字元 Google Analytics 360 資源
項目參數最多可以有 10 個自訂參數。
貼文內文必須小於 130 KB。
傳送到 Google Analytics 的 App Measurement Protocol 事件不會填入搜尋資料 Google Ads 目標對象。

如要瞭解各種用途的其他規定，請參閱常見用途。