ima-sdk-client-side
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.
Summary
- Purpose
- It helps integrate Google's IMA SDK to request and manage in-stream video and audio ads in digital products.
- When to use
- Use it when implementing client-side ad requests with VAST or VMAP for web, app, TV, or other platforms; it is not for DAI, SSAI, or SGAI.
- Outputs
- It provides a general workflow for SDK setup, ad requests, load and playback event and error handling, and AdsManager cleanup, plus platform-specific guides for implementation details.
Upstream changes (5, latest included 2026-08-11)
a54d506 Fix broken relative links in ima-sdk-tvos-guide.md. Updated the skill metadata version from 1.0.1 to 1.0.2 and removed the blank line before the heading. 80513f4 Renames IMA SDK basics skill from ima-sdk-basics to ima-sdk-client-side. Renamed the skill to `ima-sdk-client-side`, revised its IMA client-side description, and bumped its metadata version from 1.0.0 to 1.0.1. 703f8d2 Move ads skills from per-product subdirectories to top-level skills/ads/ directory. Moved the skill file from the `interactive-media-ads` subdirectory to `skills/ads/ima-sdk-basics` without changing its contents. c75b500 Restructure the YAML frontmatter in all SKILL.md files to nest the 'category' field under the 'metadata:' block. The 'category' field is used to organize the skills in the README.md Added `category: GoogleAds` under the skill metadata and removed the blank line before the heading. 28d90a3 Add new skill for Interactive Media Ads SDK basics. Added an `ima-sdk-basics` skill describing client-side IMA use, linking platform-specific guides, and outlining the general ad-integration workflow. npx skills add "lettucebo/Skills#v2.2.0@ima-sdk-client-side" --full-depth ⚠ Available after v2.2.0 is published
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.