2.5 KiB
2.5 KiB
/admin/api/cps — CPS 群发联盟运营台(群/活动/短链/对账)
所属:Admin 子应用(前缀
/admin/api/cps) | 鉴权:读=admin,写=operator/finance(对账) | 表 cps_group / cps_activity / cps_link / cps_click / cps_order / cps_wx_user | ← 返回 API 索引业务与授权流程详见 guides/CPS发券分发与微信授权;C 端落地短链见 cps-redirect。
私域社群 CPS 的完整运营链:建群(拿 sid)→ 建活动(券/物料)→ 生成群发短链 /c/{code} → 用户点击/复制口令 → 联盟订单按 sid 归群对账,汇成「点击→下单→佣金」漏斗。
端点
| 方法 + 路径 | 说明 |
|---|---|
GET / POST /admin/api/cps/groups,PATCH / DELETE /groups/{id} |
推广群 CRUD;含美团平台的群自动分配 sid |
GET / POST /admin/api/cps/activities,PATCH / DELETE /activities/{id} |
可推广活动 CRUD(美团 actId / 淘宝淘口令 / 京东链接) |
POST /admin/api/cps/upload-image、GET /activity-images |
活动落地页图上传 / 已有图列表(新建复用) |
POST /admin/api/cps/referral-links |
批量生成群×活动短链(美团经 sid 转链) |
POST /admin/api/cps/orders/reconcile |
拉联盟订单对账(美团 query_order + 京东联盟 #90,order_id 幂等 upsert;finance) |
GET /admin/api/cps/orders |
订单明细(游标分页,可按 sid / 状态筛) |
GET /admin/api/cps/stats |
按群对账统计(点击/订单/GMV/预估与结算佣金) |
GET /admin/api/cps/groups/{id}/timeseries |
群点击时序(天/小时级 PV/UV/复制,折线图) |
GET /admin/api/cps/groups/{id}/daily |
群每天明细大表格(点击+订单按天合并;#79 起支持按天下钻) |
GET /admin/api/cps/groups/{id}/wx-users |
群内微信用户(领券画像:头像/昵称/领券次数) |
GET /admin/api/cps/groups/{id}/day-users |
某天该群按用户的领券/点击 + 每人点过的券(#79) |
说明
- 订单与点击只能在群(sid)维度汇合,无法对到单笔(联盟只回传 sid)。
- 京东单有效性按
jd_valid_code,美团按mt_status(4 取消/5 风控不计佣,6 结算才到账);淘宝无对账 API,对账列显示-。 - #119 修美团
pay_time入库为空导致大盘时间窗漏算。