概览
本指南介绍了如何设置请求格式并将其发送到 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:
网址参数
api_secret
- 必需。在 Google Analytics(分析)界面中生成的API SECRET
。如需创建新的密钥,请依次转到:
管理 > 数据流 > 选择您的数据流 > Measurement Protocol > 创建
如需查看完整的参考,请参阅查询参数。
JSON 正文
user_id
- 可选。用户的唯一标识符。如需详细了解此标识符,请参阅使用 User-ID 进行跨平台分析。events
- 必需。事件 item 的数组。
如需查看完整的参考,请参阅 JSON POST 正文。
推荐的报告参数
若要在标准报告(如“实时”报告)中显示用户活动,必须将 engagement_time_msec
和 session_id
作为 event
的 params
的一部分提供。
示例:
{
"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。