ouzhou
0bddce516f
- eCPM 口径修正:getEcpm 原值是分/千次,新增 parse_ecpm_fen;parse_ecpm_yuan 改为 ÷100 转元,因子1 阈值按元判档(100/200/400),收益换算用元 - test-grant 用客户端按 ad_session_id 上报的真实 eCPM 发奖(取不到/≤0 兜底 200) - 新增 GET /admin/api/ad-coin-audit 只读复算对账(router/repo/schema),复用发奖公式 - 同步更新 docs/api、docs/database 的分/元口径 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> --------- Co-authored-by: OuYingJun1024 <1034284404@qq.com> Reviewed-on: #32 Co-authored-by: ouzhou <ouzhou@wonderable.ai> Co-committed-by: ouzhou <ouzhou@wonderable.ai>
2.3 KiB
2.3 KiB
POST /api/v1/ad/ecpm-report — 上报本次广告展示的 eCPM（内部收益统计）
所属:Ad 组（前缀
/api/v1/ad） | 鉴权:Bearer | ← 返回 API 索引
入参
请求体:EcpmReportIn
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
ad_type |
str | 是 | 广告类型:reward_video(激励视频) / draw(Draw 信息流) 等 |
ad_session_id |
str|null | 否 | 客户端生成的广告会话 ID;需和穿山甲 extra.ad_session_id 一致,用于 S2S 缺 eCPM 时匹配 |
ecpm |
str | 是 | 穿山甲 getShowEcpm().getEcpm() 原始字符串,单位是分/千次展示(非元),后端 ÷100 转元参与金币公式 |
adn |
str|null | 否 | 实际投放 ADN(getSdkName),如 pangle |
slot_id |
str|null | 否 | 实际展示代码位(底层 mediation rit,非客户端配置位) |
user_id 不在 body 里——由 JWT 取(Bearer),防伪造。
出参
响应 200:EcpmReportOut
| 字段 | 类型 | 说明 |
|---|---|---|
ok |
bool | 落库即 true |
说明
客户端在广告展示后(onAdShow 读 getShowEcpm())调用,把本次展示的 eCPM 落库做内部收益统计/对账。
- 普通激励视频发奖会先用 S2S 回调自带
ecpm;若缺失,再按ad_session_id读取本接口上报的 eCPM;两边都没有则不发并记录异常。 - best-effort:客户端 fire-and-forget,但普通激励视频若 S2S 缺 eCPM,这条上报会成为发奖依据。
- 落
ad_ecpm_record表,report_date用北京时间当天,供「按用户/按天聚合」对账。 - 与发奖是两条独立流:发奖走 ad-pangle-callback(穿山甲 S2S,有
trans_id、无 ecpm),本接口客户端上报(有 ecpm、无trans_id)。两者无公共键,不逐条一一对应,只做按用户/按天聚合口径。 - eCPM 是每千次展示预估,单条展示预估收益 ≈
ecpm / 1000,且为客户端预估口径,非最终结算。 - ⚠️ eCPM 单位(分/元)截至 2026-05-31 未最终确认,故
ecpm_raw原样存字符串;确认后再加一列解析好的数值。 - 限流:同 IP 120 次/分钟。
相关
- ad-pangle-callback — 穿山甲 S2S 发奖回调
- ad-reward-status — 今日看广告发奖进度