主题
Novvy Ads Android SDK
Android 端广告 SDK 对接文档。当前版本 1.2.0。
从 1.1 升级
1.2 兼容 1.1：无需修改任何代码，把依赖版本号换成 1.2.0 即可，详见SDK 安装。
接入顺序
SDK 安装（依赖 + 权限）
↓
初始化 SDK（appId / endpoint / apiKey）
↓
设置用户与内容上下文 // 短剧场景是填充前提
↓
按广告类型接入（load → show / attach）- SDK 安装 —— 环境要求、Gradle 依赖、权限声明
- 初始化 SDK ——
NovvySDK.initialize()参数与时机 - 用户与内容上下文 ——
NovvyUserContext/NovvyContentContext - 广告类型 —— 见下表
- 错误类型 ——
NovvyError各取值含义
广告类型一览
SDK 提供以下广告类。除暂停卡（实时请求）、叙事植入（SDK 自驱动）与横幅（构造即常驻、自动轮换）外，均为两段式 —— 先 load() 预加载，就绪后再展示。adUnitId 按类型区分，请使用对应列的广告位标识：
| 广告类型 | 类 | adUnitId 类型 | 形态 | 展示方法 | 生命周期回调 |
|---|---|---|---|---|---|
| 激励视频 | NovvyRewardedAd | rewarded | 全屏 | show(activity) | Shown → Reward → Closed |
| 插屏 | NovvyInterstitialAd | interstitial | 全屏 | show(activity) | Shown → Closed |
| 信息流滑动位 | NovvyScrollAd | scroll_placement | 内联（信息流滑动位） | attach(container) | Shown / Hidden |
| 中插 | NovvyMidAd | mid_placement | 全屏（中插） | show(activity) | Shown → Closed |
| 片尾 | NovvyEndAd | end_placement | 全屏（片尾） | show(activity) | Shown → Closed |
| 暂停卡 | NovvyPauseAd | pause_placement | 内联（暂停卡，260dp） | attach(container, player) | Shown / Hidden（实时，无预加载） |
| 叙事植入 | NovvyInsertAd | story_placement | 播放器视图内铺满（叙事植入） | 无 —— SDK 自动到点展示 | Loaded → Shown → Closed（串行多支）→ ChainFinished |
| 横幅 | NovvyBannerAd | banner | 内联（固定尺寸常驻） | 无 —— 构造即建位，load() 起自动轮换 | Loaded → Shown → Clicked / Hidden（每轮重复） |
短剧场景务必先设置内容上下文
短剧后端需要「当前在看哪部剧、第几集」才有填充，否则返回 NoFill。请在每次 load() / attach() 之前调用 NovvySDK.setContentContext(...)，详见用户与内容上下文。
点击、曝光、跳转等追踪与计费由 SDK 内部自动处理，宿主无需干预；各广告的回调统一在主线程触发。