Agent Skills › google/skills › ima-sdk-client-side

ima-sdk-client-side

GitHub

提供Google IMA SDK客户端广告集成指南，支持Web、Android、iOS等平台。涵盖SDK导入、初始化、广告请求、播放事件处理及资源清理，适用于VAST/VMAP标准的视频音频广告插入，不适用于动态或服务端广告插入。

skills/ads/ima-sdk-client-side/SKILL.md google/skills

Trigger Scenarios

需要集成Google IMA SDK实现客户端视频广告处理VAST或VMAP广告请求与播放逻辑解决多平台（Web/Android/iOS）广告播放兼容性问题

Install

npx skills add google/skills --skill ima-sdk-client-side -g -y

More Options

Non-standard path

npx skills add https://github.com/google/skills/tree/main/skills/ads/ima-sdk-client-side -g -y

Use without installing

npx skills use google/skills@ima-sdk-client-side

指定 Agent (Claude Code)

npx skills add google/skills --skill ima-sdk-client-side -a claude-code -g -y

安装 repo 全部 skill

npx skills add google/skills --all -g -y

预览 repo 内 skill

npx skills add google/skills --list

SKILL.md

Frontmatter

{
    "name": "ima-sdk-client-side",
    "license": "Apache-2.0",
    "metadata": {
        "author": "Google LLC",
        "version": "1.0.2",
        "category": "GoogleAds"
    },
    "description": "Supports Interactive Media Ads (IMA) SDK. Use this skill for client-side ad insertion when you are requesting video ads for websites, apps, TVs or other platforms using VAST or VMAP. Do not use for Dynamic Ad Insertion (DAI), SSAI, or SGAI."
}

IMA SDK client-side

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

7072dc4 Current 2026-08-13 10:28

Metadata

Files: 0
Version: 8f57a0d
Hash: ff6523c5
Indexed: 2026-08-13 10:28

ima-sdk-client-side