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
ad_ecpm_record — 广告展示 eCPM 上报(收益对账)
模型
app/models/ad_ecpm.py· 仓库app/repositories/ad_ecpm.py· 接口 ad-ecpm-report · ← 索引 · 总览
每条 = 客户端一次广告展示(onAdShow)后读到的 eCPM。ad_session_id 可与 S2S 回调 extra.ad_session_id 对齐:当普通激励视频回调没有 ecpm 时,后端会用它匹配本表作为发奖 eCPM 依据。
用在哪 / 增删改查
- C(插入):
POST /ad/ecpm-report(create_ecpm_record)。每次广告展示上报一条;best-effort,丢一两条不影响业务。鉴权接口已确保 user 存在。 - U / D:无。
- R:内部收益统计/对账(按
(user_id, report_date)聚合);count_today排查辅助。当前无面向 C 端用户的读接口。
字段
| 列 | 类型 | 约束 / 默认 | 说明(取值 / join) |
|---|---|---|---|
id |
Integer | PK, autoincrement | |
user_id |
Integer | FK→user.id, index, NOT NULL | 归属用户 |
ad_type |
String(32) | NOT NULL | 广告类型,取值如 reward_video(激励视频)/ draw(Draw 信息流);各类型各自上报,不强行统一代码位 |
ad_session_id |
String(64) | UNIQUE, index, nullable | 客户端广告会话 ID;用于普通激励视频在 S2S 缺 ecpm 时匹配发奖 |
adn |
String(32) | nullable | 实际投放 ADN(getShowEcpm().getSdkName(),如 pangle/gdt) |
slot_id |
String(64) | nullable | 实际展示用代码位(底层 mediation rit,非客户端配置位) |
ecpm_raw |
String(32) | NOT NULL | 客户端上报的 eCPM 原始串(穿山甲 getEcpm 原值,单位分/千次展示);后端 ÷100 转元参与金币公式 |
report_date |
String(10) | index, NOT NULL | 北京时间日期串 YYYY-MM-DD,按它做按天聚合 |
created_at |
DateTime(tz) | server_default now(), index | 时间 |
关系 / Join Key
user_id→user.id(多对一)。ad_session_id→ 可关联ad_reward_record.ad_session_id。
索引与约束
- PK
id;indexuser_id、report_date、created_at、ad_session_id;UNIQUEad_session_id。
注意
- S2S 回调自带
ecpm优先;缺失时才使用同ad_session_id的客户端上报值。两者都没有时普通激励视频不发币,ad_reward_record.status=ecpm_missing。