1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | ima-sdk-client-side-google-skills |
| 作者/维护者 | Google LLC |
| 来源链接 | https://github.com/google/skills/tree/main/skills/ads/ima-sdk-client-side |
| 许可证 | Apache-2.0（GitHub API） |
| GitHub Stars | 19,762（GitHub API；该数字属整个 google/skills 合集仓库，不代表本技能自身热度） |
| Forks | 1,592（GitHub API） |
| 最新版本 | 1.0.2（SKILL.md metadata） |
| 安装方式 | npx skills add google/skills/skills/ads（Google 官方文档） |
2. 功能介绍与亮点
ima-sdk-client-side 是 Google IMA（Interactive Media Ads）SDK 的客户端集成指南，帮助开发者在网站、App、电视等设备上接入 VAST/VMAP 兼容的视频/音频广告，并管理广告播放的全生命周期。
核心能力：
- 按平台分流的详细集成指南：Web/HTML5/React/Node/Angular、Android/AndroidTV/React Native、iOS/tvOS/React Native 各有独立参考文档
- 覆盖 SDK 集成的完整工作流：导入依赖、初始化与预热、发起广告请求（含用户手势合规要求）、处理加载成功/失败事件、监听播放事件、正确销毁 AdsManager 释放资源
- 明确界定适用边界：仅用于客户端广告插入，不适用于服务器端插入（DAI/SSAI/SGAI）场景
主要亮点：官方出品、开源可审计、2026-08-11 刚完成一次内容修订（修复跨平台引用链接、technique 由 ima-sdk-basics 更名为现名），维护活跃。
3. 适用场景
所属分类：集成与工作流自动化
适合需要在自有网站、移动 App 或智能电视应用中接入第三方视频广告变现能力的开发者：媒体/流媒体发布商接入贴片广告、Web 应用集成 VAST 广告位、跨平台 App（Web+Android+iOS+tvOS）需要统一的广告 SDK 集成参考。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | Google 官方文档（developers.google.com/admob/ios/agent-skills）明确列出，npx skills add 一条命令安装 |
| Codex | 原生支持 | 同上，官方文档同页面列出 |
| OpenClaw | 未验证 | 官方文档未提及，无法核实 |
| Hermes Agent | 未验证 | 官方文档未提及，无法核实 |
5. 推荐理由
Google 官方出品的视频广告 SDK 集成指南，一次覆盖 Web/Android/iOS/tvOS 四大平台，按场景给出可直接落地的集成步骤与资源释放规范，省去开发者自行拼凑各平台文档的成本，且内容近期刚做过修订，可信度与时效性俱佳。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Google 为 IMA SDK 官方所有者，属第一方出品；该子技能自身暂无独立第三方评价或讨论证据 |
| 可用性 | 9 | 四大平台参考指南齐全、步骤清晰，npx skills add 一条命令安装，无付费依赖；2026-08-11 刚完成内容修订，维护活跃 |
| 安全性 | 9 | 纯文档/参考指南型技能，SKILL.md 本身不含可执行脚本，无网络外发行为；官方仓库、Apache-2.0 开源可审计 |
安全检查清单： ① Shell 命令执行：无，纯引导性文档，不含脚本 ② 运行时联网外发：无 ③ API Key/凭据：不涉及，技能本身不代管任何凭据 ④ 可疑指令：未发现 ⑤ 作者信誉：Google LLC，官方仓库 ⑥ License：Apache-2.0，明确 ⑦ 最近维护：2026-08-11，活跃
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| ima-dai-sdk（同仓库） | 面向服务器端广告插入（DAI/SSAI/SGAI） | 与本技能互补而非替代——采用服务器端广告拼接架构的应用应改用该技能，本技能只覆盖客户端插入 |
| google-mobile-ads-rewarded（同仓库） | 面向移动原生 App 内的激励视频广告，依赖 Google Mobile Ads SDK 生态 | 受众更窄（限移动 App 的激励广告场景）；本技能面向任意 VAST 兼容广告服务器，覆盖 Web/App/TV 跨平台通用场景 |
8. 用户评价
该技能目前在第三方平台（GitHub Issues、Reddit、Hacker News 等）尚无具名用户评价。
9. 其他补充
技能刚于 2026-08-11 由 ima-sdk-basics 更名为 ima-sdk-client-side，并修复了 tvOS 指南中的引用链接问题；若查阅早期社区讨论或文档存档，注意名称已变更。
10. 安装使用方式
npx skills add google/skills/skills/ads该命令会安装 google/skills 仓库 skills/ads/ 目录下的全部技能（含本技能）。安装后无需重启，当用户提出视频广告 SDK 集成、VAST/VMAP 广告播放相关任务时，Agent 会自动读取对应平台的参考指南并给出集成步骤。
11. 注意事项
- 仅覆盖客户端广告插入（VAST/VMAP），不适用于服务器端插入（DAI/SSAI/SGAI）场景，SKILL.md 已明确注明并指向 ima-dai-sdk
- 官方兼容性文档未提及 OpenClaw、Hermes Agent 的支持情况，在这两个平台使用前建议自行验证 skills 目录加载机制
- 实际广告播放效果依赖开发者自有的 VAST 兼容广告服务器，技能本身不提供广告库存