发送事件

概览

本指南介绍了如何设置请求格式并将其发送到 Google Analytics(分析)Measurement Protocol。

发送事件

如需发送事件,请向以下端点发出 HTTP POST 请求:

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

必需参数

有效请求需要两组参数,具体取决于您使用的是 Firebase 还是 gtag.js:

  1. 网址参数

    • api_secret - 必需。在 Google Analytics(分析)界面中生成的 API SECRET。如需创建新的密钥,请依次转到:
      管理 > 数据流 > 选择您的数据流 > Measurement Protocol > 创建

    如需查看完整的参考,请参阅查询参数

  2. JSON 正文

    • user_id - 可选。用户的唯一标识符。如需详细了解此标识符,请参阅使用 User-ID 进行跨平台分析

    • events - 必需。事件 item 的数组。

    如需查看完整的参考,请参阅 JSON POST 正文

若要在标准报告(如“实时”报告)中显示用户活动,必须将 engagement_time_msecsession_id 作为 eventparams 的一部分提供。

示例:

{
"client_id": "x",
"events": [
  {
    "name": "offline_purchase",
    "params": {
      "engagement_time_msec": "100",
      "session_id": "123"
    }
  }
]
}

虽然 session_start预留的事件名称,但创建新的 session_id 将会有效地创建新会话,而无需发送 session_start

发送事件

如需发送 tutorial_begin 事件,请发出以下请求:

限制

  • 请求最多可以包含 25 个事件。
  • 事件最多可以包含 25 个参数。
  • 事件最多可以包含 25 个用户属性。
  • 用户属性名称不得超过 24 个字符。
  • 用户属性值不得超过 36 个字符。
  • 事件名称不得超过 40 个字符,只能包含字母数字字符和下划线,并且必须以字母字符开头。
  • 参数名称(包括 item 参数)不得超过 40 个字符,只能包含字母数字字符和下划线,并且必须以字母字符开头。
  • 参数值(包括 item 参数值)不得超过 100 个字符。
  • Item 参数最多可以包含 10 个自定义参数。
  • POST 正文必须小于 130kB。