Google IMA SDK Client-Side Ad Insertion
Implement client-side video and audio ad insertion with VAST or VMAP.
The guide discloses client-side ad requests, iframe permissions, ad-tag URLs, page URLs, cookie access, and advertiser landing-page navigation, and recommends cleanup of AdsManager, listeners, and SDK resources. It lacks least-privilege guidance, sensitive-data/privacy handling, ad-tag trust validation, explicit user confirmation, and rollback procedures, so points are deducted.
The main flow covers initialization, requests, success and failure events, playback, cleanup, and fallback to content. However, there are no tests, CI, or static API checks; some examples contain questionable or potentially inconsistent API/lifecycle usage, and abnormal-input and version-compatibility guidance is thin, so points are deducted.
The scope clearly covers Web, Android, iOS, tvOS, and related frameworks, and explicitly excludes DAI, SSAI, and SGAI. Inputs, outputs, non-fit boundaries, and trigger conditions remain only partly specified; Chinese support and mainland-China reachability are not addressed, and core operation depends on external Google SDK and ad services, so points are deducted.
The documentation is well separated by platform and provides a progressive reading path, Apache-2.0 licensing, author, and version metadata. It lacks a changelog, explicit maintenance/update procedure, FAQs, and systematic troubleshooting; the Android example version also conflicts with the instruction to recommend the latest version, so points are deducted.
The material provides adaptable multi-platform lifecycle examples, failure fallback, and resource cleanup that cover the core IMA client-side integration task. The snippets still contain placeholders, app-specific helper functions, and unverified SDK calls, with no complete runnable project or validated output, requiring substantial integration and review; the static score ceiling therefore applies.
The skill links to Google developer documentation and official Google example repositories and provides auditable code paths. It contains no committed test suite, CI execution evidence, or cross-source reproduction, and static review cannot verify compilation or runtime behavior; the static score ceiling therefore applies.
- Do not use the placeholders, version numbers, or API calls directly in production; verify them against the current official SDK documentation and examples for the target platform.
- Ad requests, page URLs, cookies, VPAID, and landing-page navigation create privacy and third-party data flows; complete consent, permission, domain/ad-tag validation, and security review before deployment.
- The core SDK and ad services depend on external network access; the material does not establish mainland-China reachability or offline degradation behavior.
What does this skill do, and when should you use it?
This skill helps developers integrate the Google IMA SDK to insert video or audio ads on websites, apps, TVs, and other digital platforms. It covers the general workflow from SDK import, initialization, and ad requests through playback-event handling and cleanup. Platform-specific reference guides are required before integration. It does not apply to DAI, SSAI, or SGAI.
Guides developers through importing and initializing the Google IMA SDK, configuring settings and ad UI, creating and triggering ad requests, handling ad-load success or failure, using AdsManager to coordinate content and ad playback, handling log and fatal errors, and destroying AdsManager to release resources.
- A web developer needs to request client-side ads from a VAST-compliant ad server for HTML5 video.
- An Android or Android TV application needs to integrate IMA SDK for video ad playback.
- An iOS, tvOS, or React Native application needs client-side video ad insertion.
- A developer needs guidance for ad-load events, playback events, user-gesture compliance, and cleanup.
What are this skill's strengths and limitations?
- Covers the main end-to-end client-side ad insertion workflow.
- Explicitly targets websites, apps, TVs, and other digital platforms.
- Addresses VAST and describes requests involving VAST or VMAP.
- Includes load failures, playback errors, and AdsManager cleanup.
- Detailed implementation is delegated to platform-specific reference guides.
- The source provides no test suite or validation results.
- DAI, SSAI, and SGAI are explicitly out of scope.
How do you install this skill?
Run npx skills add google/skills and select the IMA SDK basics skill during installation. The repository is licensed under Apache 2.0. The source material does not document additional installation steps.
How do you use this skill?
After installing the skill in an Agent Skills-compatible client, use a prompt such as “Help me integrate Google IMA SDK client-side ad requests for an HTML5 video and follow the applicable platform guides.” Before use, read the relevant references: the Web guide plus iframe and Mobile Safari guides; the Android/Android TV guide; or the iOS/tvOS guides. The SKILL.md does not provide the detailed platform implementation steps.
How does this skill compare with similar options?
For Dynamic Ad Insertion, SSAI, or SGAI, use the source-mentioned ima-sdk-dai-basics skill instead; this skill is for client-side ad insertion.