Agent Skills
› google/skills
› ima-sdk-basics
ima-sdk-basics
GitHub用于在Web、Android、iOS等平台通过IMA SDK进行客户端VAST/VMAP广告插入。涵盖SDK导入、初始化、请求、播放事件处理及资源清理，不适用于动态或服务器端广告插入。
Trigger Scenarios
需要在网站、App或TV中集成VAST/VMAP视频广告
实现客户端侧的广告加载与播放管理
Install
npx skills add google/skills --skill ima-sdk-basics -g -y
SKILL.md
Frontmatter
{
"name": "ima-sdk-basics",
"license": "Apache-2.0",
"metadata": {
"author": "Google LLC",
"version": "1.0.0",
"category": "GoogleAds"
},
"description": "Use this skill for Interactive Media Ads (IMA) SDK client-side ad insertion when you are requesting video ads client-side into websites, apps, TVs or other platforms with VAST or VMAP. Do not use for Dynamic Ad Insertion (DAI), SSAI, or SGAI (use the `ima-sdk-dai-basics` skill instead)."
}
IMA SDK basics
The Google IMA SDK (Interactive Media Ads) lets you load in-stream video and audio ads into websites, apps, TVs and other digital platforms. Use an IMA SDK to request ads from any VAST-compliant ad server and manage ad playback.
Prerequisites
Before integrating the IMA SDK, you must read the platform-specific guide below to support all platforms that your app can support:
- Web/HTML5/ReactJs/NodeJs/Angular: Read all these guides ima-sdk-web-guide.md, ima-sdk-web-iframe-mode.md, ima-sdk-web-mobile-safari.md
- Android/AndroidTV/ReactNative: Read ima-sdk-android-guide.md
- iOS/tvOS/ReactNative: Read all these guides ima-sdk-ios-guide.md, ima-sdk-tvos-guide.md
Quick start (general workflow)
- Import the SDK: Prerequisites, dependencies.
- Initialization: Early setup, Warmup, Settings Configuration, and Ad UI Setup.
- Ad Request: Creating and triggering the request, User gesture compliance.
- Ad Load Success/Failure: Handling the load event to get the AdsManager, or handling early fatal errors.
- Ad Playback Events: Listening to playback events via AdsManager to coordinate content play/pause, and handling non-fatal LOG events and fatal active playback errors.
- Cleanup: Properly destroying the AdsManager to release resources and prevent memory leaks.
For detailed, platform-specific implementation details, always refer to the guides in the Prerequisites section.
Version History
- aabe37a Current 2026-07-05 15:27
