OuYingJun1024
c958546e07
- compute_feed_reward/preview_feed_reward: 逐条 (eCPM,秒) 跨条进位、每满 10s 一份、 每份用所在段 eCPM × LT，封顶 12 份/场；发奖与预览同一口径 - grant_feed_reward 改收 segments（旧 ecpm/duration 单段自动回退，兼容旧客户端） - 新增 POST /api/v1/ad/feed-reward/preview（只读不入账，给比价金币小球实时显示真实即将到账额） - schemas 加 FeedSegmentIn/FeedPreviewIn/FeedPreviewOut；docs/api 补 preview 文档 + 更新 feed-reward - tests: 按条结算/12份封顶/aborted/preview==grant 等 6 个用例 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
3.6 KiB
3.6 KiB
POST /api/v1/ad/feed-reward — 信息流广告完成后结算金币
点位 2：比价等待 / 领券信息流广告（轮播多条）。整场比价全程不关广告才发，金额按整场折份（每 10 秒 1 份），结束时一次性入账。用户中途 ✕ 关闭则整场不发。
播放过程中查询「此刻将发放多少金币」（金币小球实时显示用）见 feed-reward/preview，与本接口同一计价口径但只读不入账。
鉴权
需要 Bearer token。
请求体
计价优先用 segments 逐条精确结算；未传 segments 时回退用 ecpm + duration_seconds 当单段（旧客户端兼容）。两者都不传 → 422。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
client_event_id |
string | 是 | 客户端生成的幂等事件 id，8-64 字符 |
ad_session_id |
string|null | 否 | 客户端生成的一次信息流广告会话 id，用于对账/排查 |
segments |
array|null | 否* | 逐条广告段（时序），每项 {ecpm: string, seconds: int}。新客户端传它做按条精确结算 |
ecpm |
string|null | 否* | [回退] 本场代表 eCPM(穿山甲 getEcpm 原值，分/千次展示，非元)；传了 segments 时仅作落库代表值 |
duration_seconds |
int | 否 | [回退] 整场累计观看秒数；传了 segments 时忽略。默认 0 |
adn |
string|null | 否 | 实际投放 ADN(聚合后实际填充的子渠道) |
slot_id |
string|null | 否 | 实际展示代码位(底层 mediation rit) |
app_env |
string|null | 否 | 我们的应用环境:prod(傻瓜比价正式) / test(测试应用) |
our_code_id |
string|null | 否 | 我们后台配置的代码位 ID(104xxx,非底层 rit);供广告收益报表按代码位聚合金币 |
aborted |
bool | 否 | 用户中途 ✕ 关闭广告(未走完比价):整场不发，仅记 closed_early。默认 false |
* segments 与 ecpm 至少传其一。
响应
| 字段 | 类型 | 说明 |
|---|---|---|
granted |
bool | 本次是否入账；未发(任一非 granted 状态)时为 false |
status |
string | granted(已发) / capped(当日次数超限) / too_short(整场<10s 凑不满一份) / closed_early(用户中途关闭) |
coin |
int | 本次发放金币；非 granted 为 0 |
unit_count |
int | 折算出的奖励份数（封顶 12） |
daily_limit |
int | 每日信息流展示次数上限，默认 500 |
计算口径
- 奖励份数（跨条进位）：按
segments时序遍历，维护一个连续秒数计数器，每满 10 秒结算一份；换条时不足一份的零头进位到下一条。份数封顶 12 份/场（防刷硬闸，替代旧的「单事件时长钳 120s」）。 - 每份归属的 eCPM：该份「满 10 秒那一刻正在播的那条广告」的 eCPM。
- 单份奖励：
eCPM / 1000 × 因子1(eCPM 档) × 因子2(账号累计份序号) × 10000，四舍五入为整数金币。 - eCPM 档：
0-100=0.1，101-200=0.3，201-400=0.4，>400=0.6（eCPM 钳顶 ¥500 CPM）。 - LT 档（按账号累计已发份数，不按天重置）：第 1 份
2.0，第 2 份1.5，第 3 份1.3，第 4-10 份1.1，第 11 份及以后1.0。 - 旧客户端单段口径
[(ecpm, duration_seconds)]是上述的特例，份数 =min(duration//10, 12)，结果与改造前一致。
数据写入
ad_feed_reward_record新增一行（ecpm_raw存代表 eCPM，通常为末段）。- 入账时
coin_account增加余额。 - 入账时
coin_transaction写入biz_type=feed_ad_reward。