POST管理接口
漏斗转化分析
按步骤顺序统计同一标识的转化情况:每一步取「上一步之后、且仍在转化窗口内」 的最早一条命中。转化窗口锚定在第一步,因为业务上说的「7 天内完成下单」算的是 从进入漏斗起的总时长。 这是只读接口,用 POST 只是因为步骤是带属性条件的结构化数组,塞进 query string 既超长又要自己发明一套编码。所需权限是 events:read。
URL
/api/v1/admin/projects/{projectKey}/events/analysis/funnel鉴权方式
需要管理员 JWT 或 API Key,二者等价(Authorization: Bearer <token>)
请求参数
Path 参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| projectKey | string | 是 | 项目主键 project_key(大小写不敏感) |
Header 参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer <管理员 JWT 或 API Key> |
请求体
{
"steps": [
{
"event_name": "app_opened"
},
{
"event_name": "cart_viewed"
},
{
"event_name": "checkout_clicked",
"filters": [
{
"property": "plan",
"op": "eq",
"value": "pro"
}
]
}
],
"window_seconds": 604800
}响应示例
200 响应
{
"start_time": 0,
"end_time": 0,
"window_seconds": 0,
"data": [
{
"step": 0,
"event_name": "string",
"users": 0,
"conversion_rate": 0,
"total_conversion_rate": 0,
"dropped": 0
}
]
}POST
