aidentity / index

google/skills · Apache-2.0

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.

ads cloud stable

Contents

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](references/ima-sdk-web-guide.md),

[ima-sdk-web-iframe-mode.md](references/ima-sdk-web-iframe-mode.md),

[ima-sdk-web-mobile-safari.md](references/ima-sdk-web-mobile-safari.md)

  • Android/AndroidTV/ReactNative: Read [ima-sdk-android-guide.md](references/ima-sdk-android-guide.md)
  • iOS/tvOS/ReactNative: Read all these guides

[ima-sdk-ios-guide.md](references/ima-sdk-ios-guide.md),

[ima-sdk-tvos-guide.md](references/ima-sdk-tvos-guide.md)

Quick start (general workflow)

  1. Import the SDK: Prerequisites, dependencies.
  2. Initialization: Early setup, Warmup, Settings Configuration, and Ad UI

Setup.

  1. Ad Request: Creating and triggering the request, User gesture compliance.
  2. Ad Load Success/Failure: Handling the load event to get the AdsManager, or

handling early fatal errors.

  1. 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.

  1. 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.

Provenance

Authored by Google LLC in google/skills. The content is mirrored here under its upstream license.

Related

data-manager-api-audience-ingestion Guides developers through managing (adding, removing, and clearing) audience members for Google products using the Data Manager API and its associated client libraries. Use this skill when the user wants to upload audience members, remove specific users, or clear/replace an entire audience for Customer Match, mobile device ID audiences, or any other audience use case supported by the Data Manager API. Don't use for uploading events or conversions (use the data-manager-api-event-ingestion skill). google/skills Apache-2.0 data-manager-api-event-ingestion Guides developers through implementing event and conversion ingestion to Google products using the Data Manager API /v1/events/ingest endpoint and its associated client libraries. Use this skill when the user wants to upload offline conversions, enhanced conversions for leads, click conversions, Google Analytics web or app events, or any other event ingestion use case supported by the Data Manager API. Don't use for uploading audience members (use the data-manager-api-audience-ingestion skill). google/skills Apache-2.0 data-manager-api-setup Guides developers through client library installation and authentication setup steps for the Data Manager API. Use this skill when a user is getting started with the Data Manager API and needs to setup their local environment, install the client library, or setup access to the API. Don't use for implementing audience or event ingestion logic (use the data-manager-api-audience-ingestion or data-manager-api-event-ingestion skills instead). google/skills Apache-2.0 google-ads-api-account-diagnostics Diagnoses Google Ads account performance issues such as conversion loss (value or volume), low lead flow/volume, and lost impression share (opportunities) due to ad rank, bids, or budgets. Use when troubleshooting sudden performance drops, analyzing campaign impression share metrics, investigating low lead flow, or searching for bidding and budget constraints. Don't use for setting up new campaigns, uploading conversion events directly, or general Google Mobile Ads SDK integration issues (use gma-android-integrate instead). google/skills Apache-2.0 google-ads-api-mcp-setup Guides developers through downloading, configuring, and installing the official open-source Google Ads MCP Server. Use this skill when a user wants to connect their AI assistant (such as Gemini, Claude Code, or Cursor) to their Google Ads account to query campaigns or retrieve reporting metrics using natural language. google/skills Apache-2.0