广告对接
广告走我们自有的 kuad 平台（ad.kuad.cn）。 打包免费、不抽成，站长的收入来自自己 APP 里的广告。
安装包里只编译
appKey，广告位 ID 运行时从你的站点配置下发。 所以改广告位、调频次都不用重新打包，改完配置 APP 下次启动就生效。第一步 · 在 kuad 登记应用
到 ad.kuad.cn 注册并按「平台 + 包名」登记你的 APP， 审核通过后拿到正式 Key（pk_live_…）。登记要提供隐私政策链接——平台为每个 APP 自动托管了一份， 地址是 https://ads.spkx.cn/privacy/你的包名，直接填它即可。
同平台同包名只能有一个上线应用；测试阶段可以先用测试 Key（pk_test_…），不计费。
第二步 · 填进插件设置页
插件设置页的 ads 分组里填：
{
"enabled": true,
"kuadAppKey": "pk_live_xxxxxxxx",
"hostUrl": "https://ad.kuad.cn/sdk-host/",
"placements": {
"splash": "广告位ID",
"homeInterstitial": "广告位ID",
"rewardSignIn": "广告位ID"
},
"rules": { "playInterstitialEvery": 3 }
}enabled 设为 false、或某个广告位留空字符串，对应位置就不展示广告。
支持的广告位
| 配置键 | 位置 | 触发时机 |
|---|---|---|
splash | 开屏 | APP 启动时展示一次 |
homeInterstitial | 首页插屏 | 冷启动进入首页后展示一次 |
hotStartInterstitial | 热启动插屏 | 从后台切回前台时，按下方间隔规则展示 |
playInterstitial | 播放页插屏 | 每 N 次进入播放页展示一次 |
dramaInterstitial | 短剧插屏 | 短剧每 N 集展示一次 |
feed | 信息流 | 列表页内嵌的信息流卡片 |
rewardSignIn | 激励·签到 | 「看视频领积分」按钮 |
rewardUnlock | 激励·解锁 | 需积分解锁内容时的「看视频解锁」 |
rewardDownload | 激励·下载 | 每 N 次下载要求看一次激励视频 |
rewardUrge | 激励·催更 | 每 N 次催更要求看一次激励视频 |
横幅（Banner）目前由信息流通道承载——Flutter 适配层暂未暴露独立的 Banner 接口。
频次与奖励规则
| 规则键 | 默认值 | 含义 |
|---|---|---|
hotStartIntervalSeconds | 30 | 热启动插屏的最小间隔秒数 |
playInterstitialEvery | 3 | 每 N 次进播放页弹一次插屏，0 表示关闭 |
dramaInterstitialEvery | 5 | 短剧每 N 集弹一次插屏，0 表示关闭 |
downloadRewardEvery | 0 | 每 N 次下载要求看激励，0 表示不要求 |
urgeRewardEvery | 1 | 每 N 次催更要求看激励 |
signInRewardPoints | 10 | 看激励视频奖励的积分数 |
signInRewardDailyLimit | 3 | 每人每天最多领几次激励积分 |
unlockMinutes | 180 | 激励解锁的有效时长（分钟） |
激励视频怎么发奖
以 kuad 服务端判定有效完播后的回调为准，客户端的完播事件只是回执。 也就是说：用户看完 → kuad 回调你的站点接口 → 你的站点发积分或解锁。 APP 里看到的「积分稍后到账」就是在等这个回调。
这样做是为了防刷：客户端上报可以被伪造，服务端回调不行。