向 Google Analytics（分析）发送 Measurement Protocol 事件  |  Google for Developers (original) (raw)

本指南介绍了如何将 Google Analytics Measurement Protocol 网站和应用数据流事件发送到 Google Analytics 服务器，以便在 Google Analytics 报告中查看 Measurement Protocol 事件。

请选择您想在本指南中查看哪个平台的信息：

设置请求格式

Google Analytics Measurement Protocol 仅支持 HTTP POST 请求。

如要发送事件，请使用以下格式：

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

必须在请求网址中提供以下内容：

如需获取完整的参考信息，请参阅查询参数。

必须在请求正文中提供以下内容：

  {
   "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。了解会话的统计方式。

试试看

您可以使用以下示例一次发送多个事件。此示例会向您的 Google Analytics 服务器发送 tutorial_begin 事件和 join_group 事件，使用 user_location 字段包含地理位置信息，并使用 device 字段包含设备信息。

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: {
          "session_id": "123",
          "engagement_time_msec": 100
        }
      },
      {
        name: "join_group",
        params: {
          "group_id": "G_12345",
          "session_id": "123",
          "engagement_time_msec": 150
        }
      }
    ],
    user_location: {
      city: "Mountain View",
      region_id: "US-CA",
      country_id: "US",
      subcontinent_id: "021",
      continent_id: "019"
    },
    device: {
      category: "mobile",
      language: "en",
      screen_resolution: "1280x2856",
      operating_system: "Android",
      operating_system_version: "14",
      model: "Pixel 9 Pro",
      brand: "Google",
      browser: "Chrome",
      browser_version: "136.0.7103.60"
    }
  })
});

替换时间戳

Measurement Protocol 会针对请求中的每个事件使用它在以下列表中找到的_第一个_时间戳：

  1. 事件的 timestamp_micros。
  2. 请求的 timestamp_micros。
  3. 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",
      }
    }
  ]
}

限制

向 Google Analytics 发送 Measurement Protocol 事件时，存在以下限制：

如需了解每种用例的其他要求，请参阅常见用例。