常见问题

账号与配置

appid 和 adspotid 在哪里获取？

都在开发者控制台：appid 即应用 id，在「应用与广告位」的应用列表中查看；adspotid 即广告位 id，在应用下的广告位列表中查看。二者分别用于 SDK 初始化与各广告格式加载。

SDK 与 adapter 的依赖行在哪里获取？

控制台「SDK 中心」按应用生成，包含核心 SDK 与该应用所需渠道 adapter 的确切依赖行与版本号，直接复制使用。详见 Adapter 集成。

同一渠道可以既自接又经 KeyPuff 接入吗？

不可以。同一广告渠道（ADN）不能既由开发者自接、又经 KeyPuff 接入。登记应用时如实填写已自接渠道，平台不会为该应用配置这些渠道。详见 Adapter 集成 · 重要规则。

支持 Android 以外的语言 / 框架吗？

官方 SDK 提供 iOS（Objective-C）、Android（Java）、鸿蒙（ArkTS）三端。Flutter、React Native 等跨端框架可分别集成对应原生端的 SDK，官方暂不提供桥接层。

流量与填充

请求无广告 / 填充率低怎么排查？

按顺序检查：

1. appid / adspotid 是否与控制台一致；
2. SDK 是否在用户同意隐私政策后初始化（未同意时部分设备标识不可用，影响定向与填充）；
3. 所需渠道 adapter 是否已按 SDK 中心列表集成；
4. 应用与广告位是否已通过审核并启用（状态与原因在控制台可见）；
5. SDK 只区分有无广告、不返回具体原因，可在控制台报表按请求 / 填充维度排查，仍无结论时联系客户经理。

SDK 返回的错误码能区分具体原因吗？

不能。SDK 侧只区分「有广告 / 无广告」，内部原因（超时、无填充、风控等）记录在平台请求事件中，用于平台侧排查，不在 SDK 侧暴露。

激励视频

激励回调验证失败（code -3）怎么办？

按此顺序排查：服务端响应体是否为文本 success；Security Key 是否与服务端保存的一致（重置后旧 Key 立即失效）；md5 输入是否为 adspotid + securityKey + timestamp 三段直接拼接且输出为小写十六进制；回调地址是否公网可达。详见激励视频服务端回调。

不配置回调地址可以吗？

可以。未配置回调地址时激励由客户端回调发放，不经过服务端验证；需要防刷保障时建议配置服务端回调（需 Android SDK ≥ 5.1.4、iOS SDK ≥ 5.1.5）。

合规

SDK 初始化有什么合规要求？

必须在用户同意 App 隐私政策之后初始化 SDK，并按指引配置各端隐私开关（iOS ATT、Android PrivacyController 等）。详见 SDK 合规接入指引与 SDK 隐私政策。

集成 KeyPuff 后还需要处理渠道 SDK 的合规要求吗？

需要。App 只集成其实际接入渠道的 adapter，各渠道 SDK 自身的隐私政策与合规要求同样适用于您的 App，请一并在 App 隐私政策中披露。

结算

结算周期是怎样的？

按月结算：平台每月出具结算单，您在异议期内确认后开具发票，平台线下打款。分成比例等商务条款以双方合同为准。