SDK 合规接入指引

上线前须法律审核

本文档为模板，汇总集成 KeyPuff SDK 的最低合规要求。发布前须经法务审核，并结合应用上架应用市场的审核要求补充完善（见 site/README.md「上线前确认」）。

1. 先同意，后初始化

核心原则：用户同意 App 隐私政策之前，不得初始化 KeyPuff SDK，不得发起任何广告请求。

推荐流程：

1. 用户首次启动 App 时展示您的隐私政策弹窗，其中应列明 KeyPuff SDK 及实际集成渠道 SDK 的名称、收集的信息类型与用途（可引用 SDK 隐私政策）；
2. 用户同意后，再调用 SDK 初始化（AdvanceSDKManager setAppId: / AdvanceSDK.initSDK / 鸿蒙 AdvanceSDK.initSDK）；
3. 用户拒绝时，不初始化 SDK、不展示广告；
4. 不要在 Application / Ability 生命周期入口处无条件初始化。

2. iOS 端要点

• 在 Info.plist 中配置 NSUserTrackingUsageDescription，向用户说明 IDFA 用途；
• 通过 ATT（App Tracking Transparency）向用户申请跟踪授权；未授权时 SDK 自动以 donottrack=1 请求，不做个性化投放；
• 不要为广告申请与功能无关的系统权限。

3. Android 端要点

• 通过 AdvanceSDK.setPrivacyController(new AdvancePrivacyController(){…}) 声明各采集项的授权状态，未取得用户同意的项返回 false 或空值，包括：精确定位与位置信息（isCanUseLocation）、设备信息（isCanUsePhoneState）、OAID（canUseOaid / getDevOaid）、Android ID、应用列表（alist / getInstalledPackages）；
• 该控制器会同步透传给已集成的渠道 adapter；
• 目标 API 等级较高的系统版本上，遵循系统对敏感权限与广告 ID 重置功能的限制。

4. 鸿蒙端要点

• 在用户同意隐私政策后再调用 AdvanceSDK.initSDK；
• 遵循 HarmonyOS 应用市场对广告标识符（OAID 等）与权限披露的要求。

5. 隐私政策披露

App 隐私政策中应披露：

1. KeyPuff SDK（聚合广告服务）及实际集成的渠道 SDK 清单；
2. 各 SDK 收集的设备信息类型与用途（字段清单见 SDK 隐私政策）；
3. 各第三方渠道 SDK 隐私政策的查阅方式。

6. 渠道 SDK 自身合规

App 仅集成其接入渠道对应的 adapter，但渠道 SDK 自身的隐私政策、合规初始化要求同样适用（部分渠道 SDK 有独立的合规初始化接口与披露要求）。请按各渠道官方文档完成其合规配置。

7. 未成年人保护

您的 App 若面向未成年人，应在隐私政策中说明儿童个人信息的处理规则，并按适用法规取得监护人同意后再启用广告；必要时关闭个性化广告或不在未成年人产品中集成广告 SDK。

8. 联系方式

接入合规问题请联系：bd@example.com。