外观
接入概览
开发者接入 KeyPuff SDK 后，App 内的广告请求先到达 KeyPuff 服务端，由平台完成多渠道聚合调度后返回最优广告。本节说明接入前提、支持的广告格式与平台规则；三端详细步骤见对应指南。
接入前提
- 控制台账号：通过入驻申请开户并激活；
- appid 与 adspotid：appid 即应用 id，adspotid 即广告位 id，在控制台「应用与广告位」中查看；每个广告位一个 adspotid；
- 梳理已自接的广告 SDK：登记应用时需如实告知 App 已自接的广告 SDK（渠道），见下方重要规则。
支持的广告格式
| 广告位类型 | iOS | Android | 鸿蒙 |
|---|---|---|---|
| 开屏 | ✓ | ✓ | ✓ |
| 横幅 | ✓ | ✓ | ✓ |
| 插屏 | ✓ | ✓ | ✓ |
| 激励视频 | ✓ | ✓ | ✓ |
| 信息流（模板渲染） | ✓ | ✓ | ✓ |
| 信息流（自渲染） | ✓ | ✓ | ✓ |
| 全屏视频 | ✓ | ✓ | — |
| Draw 视频 | — | ✓ | — |
广告位类型在控制台创建广告位时指定，代码示例见各端接入指南。
接入方式：核心 SDK + 渠道 adapter
- 核心 SDK：负责与 KeyPuff 服务端通信、策略拉取与聚合调度；
- 渠道 adapter：对接各广告平台（ADN）SDK 的桥接层，按需集成。
需要集成的依赖行（核心 SDK + 渠道 adapter）按应用在控制台「SDK 中心」生成，已排除该应用自接的渠道。详见 Adapter 集成。
重要规则：同一渠道不能双入口
同一广告平台（ADN）不能既由开发者自接、又经 KeyPuff 接入。
- 登记应用时请如实填写 App 已自接的广告 SDK；
- 平台不会为该应用配置这些渠道，SDK 中心也不会列出对应的 adapter；
- 双入口会导致同一渠道内竞价冲突、数据归属混乱，属于违约行为，可能影响结算。
各端接入指南
| 平台 | 语言 | 指南 |
|---|---|---|
| iOS | Objective-C | iOS 接入指南 |
| Android | Java | Android 接入指南 |
| 鸿蒙 | ArkTS | 鸿蒙接入指南 |
配套文档：Adapter 集成、激励视频服务端回调、常见问题。