About ima-sdk-basics
A practical introduction to the Google IMA SDK for developers integrating interactive ads across platforms. It outlines the general ad request and playback lifecycle, with platform-specific guides for implementation details.
Key features
- 01Request ads from VAST-compliant servers
- 02Initialize the SDK and ad UI
- 03Handle ad loading and playback events
- 04Destroy AdsManager and release resources
Use cases
- 01Integrate video or audio ads into websites
- 02Manage in-stream ad playback in apps
- 03Follow platform guides during SDK integration
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ google/ skills --skill ima-sdk-basicsAfter installing, type/ima-sdk-basicsin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
references/ima-sdk-android-guide.mdima-sdk-ios-guide.mdima-sdk-tvos-guide.mdima-sdk-web-guide.mdima-sdk-web-iframe-mode.mdima-sdk-web-mobile-safari.mdDetails
From the project READMEIMA 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.