Google IMA SDK 客户端广告插入指南
为视频和音频内容实现基于 VAST/VMAP 的客户端广告插入。
文档说明了客户端广告请求、iframe 权限、广告标签 URL、页面 URL、Cookie 访问和广告商落地页跳转等数据流，并要求清理 AdsManager、监听器和 SDK 资源；但未提供最小权限原则、敏感数据/隐私处理、广告标签可信性验证、用户确认或回滚策略，因此扣分。
主流程覆盖初始化、请求、成功/失败事件、播放和清理，也包含错误回退到内容；但未提供测试、CI 或静态 API 校验，部分示例存在可疑或可能不一致的 API/生命周期写法，异常输入和版本兼容说明不足，因此扣分。
明确面向 Web、Android、iOS、tvOS 及相关框架，并明确排除 DAI、SSAI 和 SGAI；但输入、输出、非适用边界和触发条件仍较粗略，未说明中文支持或中国大陆网络可达性，且核心功能依赖 Google 外部 SDK/广告服务，因此扣分。
目录结构和平台分层清晰，渐进式阅读路径、Apache-2.0 许可证、作者和版本号均有；但没有变更日志、明确维护责任/更新流程、FAQ 或系统化故障排查，Android 示例版本与“推荐最新版本”的要求也不一致，因此扣分。
文档提供了可直接改造的多平台生命周期示例、错误回退和资源清理，能够覆盖客户端 IMA 集成的核心任务；但代码含占位符、应用自定义函数和未验证的 SDK 调用，缺少完整可运行项目和结果验证，仍需较多集成与审查，因此按静态上限给分。
引用了 Google 官方开发文档地址及 Google 官方示例仓库，并提供了可审计的代码路径；但没有提交测试套件、CI 执行证据或多来源交叉复现，静态评估无法验证示例可编译和运行，因此按静态上限给分。
- 不要将示例中的占位符、版本号或 API 调用直接用于生产；应按目标平台当前官方 SDK 文档和示例核对。
- 广告请求、页面 URL、Cookie、VPAID 和落地页跳转涉及隐私与第三方数据流，部署前应完成权限、同意管理、域名/广告标签验证和安全审查。
- 核心 SDK 与广告服务依赖外部网络；文档未证明中国大陆网络可达性或离线降级能力。
这个 Skill 能做什么，适合哪些场景？
该技能面向使用 Google IMA SDK 在网站、应用、电视及其他数字平台中插入视频或音频广告的开发者。它覆盖从 SDK 导入、初始化和广告请求，到播放事件处理及资源清理的一般流程。使用前必须阅读适用平台的参考指南。它不适用于 DAI、SSAI 或 SGAI。
指导开发者导入和初始化 Google IMA SDK，配置设置与广告界面，创建并触发广告请求，处理广告加载成功或失败，使用 AdsManager 协调内容播放与广告播放，处理日志和致命错误，并销毁 AdsManager 以释放资源。
- 网站开发者需要使用 VAST 兼容广告服务器为 HTML5 视频请求客户端广告时。
- Android 或 Android TV 应用需要集成 IMA SDK 进行视频广告播放时。
- iOS、tvOS 或 React Native 应用需要实现客户端视频广告插入时。
- 开发者需要处理广告加载事件、播放事件、用户手势要求和资源清理时。
这个 Skill 有哪些优点和局限？
- 覆盖客户端广告插入的完整通用工作流。
- 明确支持网站、应用、电视及其他数字平台。
- 涵盖 VAST，并在描述中提到 VAST 或 VMAP 广告请求。
- 明确包含加载失败、播放错误和 AdsManager 清理处理。
- 详细实现依赖未随 SKILL.md 展开的平台专属参考指南。
- 源材料未提供测试套件或验证结果。
- 不覆盖 DAI、SSAI 或 SGAI 场景。
如何安装这个 Skill？
运行 npx skills add google/skills，并在安装过程中选择 IMA SDK basics 技能。仓库整体采用 Apache 2.0 许可证。除该命令外，源材料未说明额外安装步骤。
如何使用这个 Skill？
将技能安装到 Agent Skills 客户端后，可提出类似“帮我为 HTML5 视频集成 Google IMA SDK 客户端广告请求，并遵循适用的平台指南”的请求。使用前阅读适用平台的参考文件：Web 指南及其 iframe、Mobile Safari 指南；Android/Android TV 指南；或 iOS/tvOS 指南。具体平台实现步骤未在该 SKILL.md 中展开。
这个 Skill 与同类方案有什么区别？
若需求是 Dynamic Ad Insertion、SSAI 或 SGAI，应改用源材料明确提到的 ima-sdk-dai-basics 技能；本技能针对客户端广告插入。