5.6 统计、Campaign 与 Tag 接口

a month ago
3e0973a

5.6 统计与分析接口

点击统计 /api/v1/click_statistics

原始事件列表

GET /api/v1/click_statistics?short_link_id=42&from=2026-04-01&to=2026-04-15&page=1&page_size=50

返回每次点击的原始记录：IP、地域、设备、UA、时间。

聚合分析

GET /api/v1/click_statistics/analysis?short_link_id=42&dimension=country&from=2026-04-01&to=2026-04-15

dimension 支持：day / hour / country / region / city / device / os / browser / referrer。

仪表板 /api/v1/statistics

接口 说明
GET /statistics/dashboard 首页概览：今日点击、总链接数、活跃链接等
GET /statistics/system 系统运行状态：DB、缓存连通性
GET /statistics/short-links 所有短链接的聚合排行榜

Dashboard 响应示例

{
  "code": 0,
  "data": {
    "total_links": 1234,
    "active_links": 1100,
    "total_clicks": 987654,
    "today_clicks": 4321,
    "top_links": [ ... ]
  }
}

A/B 测试统计 /api/v1/ab_test_click_statistics

接口 说明
GET /ab_test_click_statistics A/B 点击事件列表
GET /ab_test_click_statistics/analysis 按维度聚合
GET /ab_test_click_statistics/{id}/variants 变体级统计

数据导出建议

当前所有接口返回 JSON，如需 CSV / Excel：

  1. 在客户端（Python pandas / Node）拉取 JSON 后转换
  2. 或在 dwz-server 前面接 BI 工具（Metabase、Superset），直接连库做报表