/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 入库为空导致大盘时间窗漏算。

2.5 KiB Raw Permalink Blame History

/admin/api/cps — CPS 群发联盟运营台(群/活动/短链/对账)

端点

说明

2.5 KiB

Raw Permalink Blame History