dotnet/molilian.api/Controllers/admin/TRACKS_API.md

监测链接接口说明（含 admin 鉴权）

业务场景

• 为第三方提供优惠券/活动链接，对曝光(expose)与点击(click)进行监测。
• 监测数据以多维度（平台 / 场景 / 场景+唯一ID）写入 Redis，并定时落库到 track_daily_report，可与 push_data_report 汇总分析。
• 触发接口高频，默认只触达 Redis；首次访问会通过缓存判断并自动补全 track_links 记录。

名词与存储

• track_links：监测链接配置表（event_type, typename(平台，来源 platformOptions), scene, unique_id, path, description）。
• track_daily_report：日聚合表（event_count, track_link_id 等）。
• Redis 缓存键：
  • 链接缓存：:tracks:link:{eventType}:{platform}:{scene}:{uniqueId}（30 天）。
  • 事件计数（日维）：:tracks:daily:{eventType}:{platform}:{scene}:{uniqueId}:{yyyyMMdd}。
  • 事件计数（时维）：:tracks:hour:{eventType}:{platform}:{scene}:{uniqueId}:{yyyyMMddHH}。
  • 索引集（枚举有数据的维度）：:tracks:daily:index:{yyyyMMdd}:unique 等。
• 维度缺省值：scene/uniqueId 为空时使用空字符串。
• 路径模板（交付方自行补域名）：/Tracks/Track?track_id={id}&eventType={eventType}。

公共接口（无需鉴权）

触发监测

• GET /Tracks/Track
• 用途：记录曝光/点击，快速返回（fire-and-forget）。
• 参数：
  • track_id *(必填)*：监测链接 ID
  • eventType *(必填)*：expose 或 click
• 响应：{ success: true, message: "ok" }
• 说明：接口不会自动创建链接，必须先调用生成接口拿到 track_id。

生成监测链接

• POST /Tracks/Create
• 参数：eventType *(必填)*，typename、scene、uniqueId、description (可空，默认空字符串)
• 响应：{ success: true, message: "ok", url: "/Tracks/Track?track_id={id}&eventType=..." }
• 说明：如果已存在则复用；内部写入 track_links 与缓存。

日报落库

• GET /Tracks/Daily
• 参数：
  • daysAgo：默认 1（统计昨天）
  • reportDate：YYYY-MM-DD，优先于 daysAgo
• 响应：{ success: true, message: "ok", rows: <写入条数> }
• 说明：读取 Redis 的日索引与计数，落库 track_daily_report。

管理端接口（需 admin 鉴权，路径前缀 /api/TracksAdmin/*）

支持查询/查看/新增/删除/报表查询。

列表

• POST /api/TracksAdmin/list
• Body：{ "current":1, "pageSize":10, "getTotal":true, "sort":"id", "order":"DESC|ASC|descending|ascending", "keyword":"tb" }
• 说明：按 event_type/typename/scene/unique_id 模糊搜索。

详情

• GET /api/TracksAdmin/info?id=123

新增

• POST /api/TracksAdmin/create
• Body：{ "event_type":"expose", "typename":1, "scene":"coupon", "unique_id":"u1", "description":"xxx" }
• 说明：typename 取值来自前端 platformOptions（pushReport.vue 引用的 platformList），后台创建始终生成新链接（不复用）。

删除

• POST /api/TracksAdmin/delete
• Body：{ "id":123 }
• 说明：删除 DB 记录并清理缓存 :tracks:link:{eventType}:{platform}:{scene}:{uniqueId}。

报表列表

• POST /api/TracksAdmin/report
• Body：{ "current":1, "pageSize":10, "getTotal":true, "track_link_id":123, "event_type":"expose", "platform":"tb", "scene":"coupon", "unique_id":"u1", "start":"2024-01-01", "end":"2024-01-31" }
• 说明：按链接/事件/平台/场景/唯一ID及日期范围筛选 track_daily_report，分页返回。