OuYingJun1024
356d6e52b9
签到加成(boost): - 新增 signin_boost_record 表(user+date 唯一)+ POST /api/v1/signin/boost - signin 状态/结算逻辑调整 信息流广告结算: - 新增 ad_feed_reward_record 表(client_event_id 幂等)+ POST /api/v1/ad/feed-reward - ad_feed_reward 模型/repo、ad schema、按 ecpm/时长结算金币 金币数值:core/rewards.py 数值调整、config_schema/admin config 适配 迁移 coin_reward_phase1(down_revision pstat3growth);测试 + API/DB 文档同步 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
41 lines
1.5 KiB
Markdown
41 lines
1.5 KiB
Markdown
# POST /api/v1/ad/feed-reward — 信息流广告完成后结算金币
|
||
|
||
点位 2：比价等待 / 领券信息流广告。每展示满 10 秒累计一份奖励，视频完成后一次性入账。
|
||
|
||
## 鉴权
|
||
|
||
需要 Bearer token。
|
||
|
||
## 请求体
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
|---|---|---:|---|
|
||
| `client_event_id` | string | 是 | 客户端生成的幂等事件 id，8-64 字符 |
|
||
| `ecpm` | string | 是 | 本条信息流广告 eCPM，按“元/千次展示”处理 |
|
||
| `duration_seconds` | int | 是 | 实际展示/播放秒数 |
|
||
| `adn` | string\|null | 否 | 实际投放 ADN |
|
||
| `slot_id` | string\|null | 否 | 实际展示代码位 |
|
||
|
||
## 响应
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|---|---|---|
|
||
| `granted` | bool | 本次是否入账；达上限时为 `false` |
|
||
| `status` | string | `granted` / `capped` |
|
||
| `coin` | int | 本次发放金币 |
|
||
| `unit_count` | int | 按 10 秒折算出的奖励份数 |
|
||
| `daily_limit` | int | 每日信息流展示次数上限，默认 500 |
|
||
|
||
## 计算口径
|
||
|
||
- 奖励份数：`duration_seconds // 10`。
|
||
- 单份奖励：`eCPM / 1000 × 因子1(eCPM 档) × 因子2(当天累计份序号) × 10000`，四舍五入为整数金币。
|
||
- eCPM 档：`0-100=0.1`，`101-200=0.3`，`201-400=0.4`，`>400=0.6`。
|
||
- LT 档：第 1 份 `2.0`，第 2 份 `1.5`，第 3 份 `1.3`，第 4-10 份 `1.1`，第 11 份及以后 `1.0`。
|
||
|
||
## 数据写入
|
||
|
||
- `ad_feed_reward_record` 新增一行。
|
||
- 入账时 `coin_account` 增加余额。
|
||
- 入账时 `coin_transaction` 写入 `biz_type=feed_ad_reward`。
|