POST管理接口

漏斗转化分析

按步骤顺序统计同一标识的转化情况:每一步取「上一步之后、且仍在转化窗口内」 的最早一条命中。转化窗口锚定在第一步,因为业务上说的「7 天内完成下单」算的是 从进入漏斗起的总时长。 这是只读接口,用 POST 只是因为步骤是带属性条件的结构化数组,塞进 query string 既超长又要自己发明一套编码。所需权限是 events:read。

URL

/api/v1/admin/projects/{projectKey}/events/analysis/funnel

鉴权方式

需要管理员 JWT 或 API Key,二者等价(Authorization: Bearer <token>)

请求参数

Path 参数

名称类型必填说明
projectKeystring项目主键 project_key(大小写不敏感)

Header 参数

名称类型必填说明
AuthorizationstringBearer <管理员 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

Try It Out

请求 URL 预览

/api/v1/admin/projects/verhub/events/analysis/funnel