Files

T

ouzhou d7c29c0883 feat(coin): 金币数值体系二期——看广告按 eCPM 发奖 + ad_session_id 幂等 + 签到膨胀固定金币 (#28 )

- rewards: 激励视频实发改按 calculate_ad_reward_coin(eCPM, 当日第N次) 公式;AD_REWARD_COIN/MAX_AD_REWARD_COIN 降为历史兼容口径;新增 SIGNIN_BOOST_COIN=2000

- 签到膨胀: Day1-13 看完激励视频额外发固定金币、Day14 不允许 (signin.py / signin-boost)

- ad_session_id 幂等: ad_ecpm/ad_reward/ad_feed_reward 记录加 ad_session_id 列 + 唯一索引(新迁移 coin_reward_phase2 / ad_feed_reward_session)

- ad.py + schemas + repositories: ecpm-report / feed-reward / reward-status / test-grant 改造;config_schema 增 signin_boost_coin;admin stats overview 补充

- 同步 docs/api + docs/database + docs/integrations/pangle 及 tests(test_ad_reward / test_welfare)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

---------

Co-authored-by: OuYingJun1024 <1034284404@qq.com>
Reviewed-on: #28
Co-authored-by: ouzhou <ouzhou@wonderable.ai>
Co-committed-by: ouzhou <ouzhou@wonderable.ai>

2026-06-09 01:56:47 +08:00

2.2 KiB

Raw Blame History

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()` 原始字符串,后端按“元/千次展示”参与金币公式
`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 次/分钟。

2.2 KiB Raw Blame History Unescape Escape

POST /api/v1/ad/ecpm-report — 上报本次广告展示的 eCPM（内部收益统计）

入参

出参

说明

相关

2.2 KiB

Raw Blame History