AutoGineer
Generated banner for Ima Dai SDK
Generated logo for Ima Dai SDK

Ima Dai SDK

GoogleOfficialCreated by Google LLC

  • Skill
  • Tool integration
  • Software development
  • Apache-2.0
  • No issues found
Download ZIP

From the author

Integrates the Google Interactive Media Ads (IMA) Dynamic Ad Insertion (DAI) SDK into websites, web apps, mobile apps, or TV apps. Use when: - A video player needs to load and play HLS or DASH streams in web apps, Android apps, iOS apps, tvOS apps, Cast (CAF) receivers, or Roku channels. - The app needs to make use of a Google DAI livestream event asset key, or content source CMS ID, video ID for video on demand. Don't use this skill to load and play a VAST or VMAP URL.
— the description by Google LLC

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

The ima-dai-sdk provides the necessary implementation patterns to integrate Google's Dynamic Ad Insertion (DAI) technology into various platforms, including web, Android, iOS, tvOS, Cast, and Roku. It enables developers to load and play HLS or DASH streams with server-side ad insertion for both livestream events and video-on-demand (VOD) content managed via Google Ad Manager.

What it does

  • Initializes the IMA DAI SDK for platform-specific video players.
  • Supports livestream event requests using asset keys.
  • Supports VOD stream requests using CMS IDs and video IDs.
  • Provides event listeners for stream management and ad playback tracking.
  • Handles timed metadata forwarding for seamless ad transitions.
  • Facilitates resource cleanup to ensure stable application performance.

When to use it

  • When implementing server-side ad insertion for HLS or DASH video streams.
  • When managing ad-supported livestreams configured in Google Ad Manager.
  • When integrating VOD content with dynamic ads into mobile, web, or TV applications.
  • When building custom video player experiences that require Google DAI functionality.

Advantages

  • Enables seamless, server-side ad insertion for improved playback stability.
  • Provides consistent integration patterns across multiple platforms.
  • Supports both live and on-demand video content workflows.
  • Integrates directly with Google Ad Manager infrastructure.

Usage examples

“How do I initialize the IMA DAI SDK in an Android application?”
The agent provides the steps to use ImaSdkFactory to create and initialize ImaSdkSettings, followed by building an AdsLoader for the ExoPlayer instance.
“What parameters are needed to request a VOD stream on a Cast receiver?”
The agent explains that a VODStreamRequest requires the network code, content source ID (CMS ID), and video ID from Google Ad Manager.

Install

  1. Download the skill as a ZIP:

    https://mp-staging.autogineer.com/agent-skills/google/ima-dai-sdk/download

  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip ima-dai-sdk.zip -d .agents/skills

Documentation by Google LLC

IMA DAI SDK

Use the IMA DAI SDK to load HLS or DASH streams into the app for:

  • Livestream events configured in Google Ad Manager.

  • Video on demand (VOD) content ingested into Google Ad Manager.

Prerequisites

Review the platform-specific integration guides for the target platforms:

Quick start (general workflow)

  1. Import the SDK

  2. Initialize the SDK

  3. Add stream event listeners

  4. Set up timed metadata forwarding

  5. Make a stream request

  6. Clean up SDK resources when the stream fails or the user leaves the stream.

Files

references/ios-IMAStreamRequest-guide.md

Google IMA DAI SDK iOS/tvOS - IMAStreamRequest Guide

For Google full-service DAI, use IMALiveStreamRequest to request a livestream and IMAVODStreamRequest to request a VOD stream.

Table of Contents

  • Dependencies (Line 19)

    • Use Swift Package Manager (Line 21)

  • SDK Initialization (Line 35)

  • UI Setup & Video Player (Line 51)

  • Make stream requests (Line 68)

    • Request a livestream (Line 72)

    • Request a VOD stream (Line 92)

  • Listen to Stream Load Events (Line 116)

  • Listen to Stream and Ad Events (Line 119)

  • Reference Implementation (Line 182)

Dependencies

Use Swift Package Manager

For iOS, add this package:

https://github.com/googleads/swift-package-manager-google-interactive-media-ads-ios

For tvOS, add this package:

https://github.com/googleads/swift-package-manager-google-interactive-media-ads-tvos

SDK Initialization

Initialize the IMAAdsLoader early, such as in ViewController.viewDidLoad event.

import GoogleInteractiveMediaAds

class ViewController {
  override func viewDidLoad() {
    super.viewDidLoad()
    adsLoader = IMAAdsLoader(settings: IMASettings())
  }
}

UI Setup & Video Player

Create IMAAdDisplayContainer object using the videoView containing the AVPlayer. Ad UI components will be rendered within the videoView over the player.

adDisplayContainer = IMAAdDisplayContainer(adContainer: videoView)

Create IMAAVPlayerVideoDisplay with the AVPlayer instance so that the IMA DAI SDK can listen to the video player for timed metadata during ad breaks.

imaVideoDisplay = IMAAVPlayerVideoDisplay(avPlayer: videoPlayer)

Make stream requests

Reuse the same AdsLoader instance to make stream requests.

Request a livestream

Instantiate IMALiveStreamRequest with the asset key and network code:

let request = IMALiveStreamRequest(
  assetKey: <ASSET_KEY_PLACEHOLDER>,
  networkCode: <NETWORK_CODE_PLACEHOLDER>,
  adDisplayContainer: adDisplayContainer,
  videoDisplay: imaVideoDisplay,
  userContext: nil)
adsLoader.requestStream(with: request)

Provide the following parameters:

  • <NETWORK_CODE_PLACEHOLDER>: The Google Ad Manager network code.

  • <ASSET_KEY_PLACEHOLDER>: The livestream asset key configured in Google Ad Manager.

Request a VOD stream

Instantiate IMAVODStreamRequest with content source ID (CMS ID) and video ID:

let request = IMAVODStreamRequest(
  contentSourceID: <CONTENT_SOURCE_ID_PLACEHOLDER>,
  videoID: <VIDEO_ID_PLACEHOLDER>,
  networkCode: <NETWORK_CODE_PLACEHOLDER>,
  adDisplayContainer: adDisplayContainer,
  videoDisplay: imaVideoDisplay,
  userContext: nil)
adsLoader.requestStream(with: request)

Provide the following parameters:

  • <NETWORK_CODE_PLACEHOLDER>: The Google Ad Manager network code.

  • <CONTENT_SOURCE_ID_PLACEHOLDER>: The CMS ID in Google Ad Manager.

  • <VIDEO_ID_PLACEHOLDER>: The video ID in the CMS.

For testing purposes, use values of DAI sample streams from https://developers.google.com/ad-manager/dynamic-ad-insertion/streams.md.txt?utm_source=agent-skills&utm_medium=content&utm_campaign=adr-ss-ai&utm_content=ima-dai-sdk

Listen to Stream Load Events

Implement IMAAdsLoaderDelegate to handle stream initialization or failure:

func adsLoader(_ loader: IMAAdsLoader, adsLoadedWith adsLoadedData: IMAAdsLoadedData) {
  print("DAI session ID: \(adsLoadedData.streamManager!.streamId!)")
  adsLoadedData.streamManager.initialize(with: nil)
}

func adsLoader(_ loader: IMAAdsLoader, failedWith adErrorData: IMAAdLoadingErrorData) {
  print("Failed to load DAI stream. Error: \(adErrorData.adError.message ?? "")")
  playBackupStream()
}

Listen to Stream and Ad Events

Implement IMAStreamManagerDelegate to receive stream events, ad lifecycle events, and errors:

func streamManager(_ streamManager: IMAStreamManager, didReceive event: IMAAdEvent) {
  print("Ad event: \(event.typeString)")
  switch event.type {
  case IMAAdEventType.STARTED:
    if let ad = event.ad {
      let extendedAdPodInfo = String(
        format: "Showing ad %zd/%zd, bumper: %@, title: %@, "
          +   "description: %@, contentType:%@, pod index: %zd, "
          +   "time offset: %lf, max duration: %lf.",
        ad.adPodInfo.adPosition,
        ad.adPodInfo.totalAds,
        ad.adPodInfo.isBumper ? "YES" : "NO",
        ad.adTitle,
        ad.adDescription,
        ad.contentType,
        ad.adPodInfo.podIndex,
        ad.adPodInfo.timeOffset,
        ad.adPodInfo.maxDuration)
      print("\(extendedAdPodInfo)")
    }
    break
  case IMAAdEventType.AD_BREAK_STARTED:
    print("Ad break started.")
    break
  case IMAAdEventType.AD_BREAK_ENDED:
    print("Ad break ended.")
    break
  case IMAAdEventType.AD_PERIOD_STARTED:
    print("Ad period started.")
    break
  case IMAAdEventType.AD_PERIOD_ENDED:
    print("Ad period ended.")
    break
  default:
    break
  }
}

func streamManager(_ streamManager: IMAStreamManager, didReceive error: IMAAdError) {
  print("Failed to play DAI stream. Error: \(error.message ?? "Unknown Error")")
  playBackupStream()
}

Reference Implementation

BasicExample:

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Created by
Google LLC
Publisher
Google (Official)
Source
google/skills · skills/ads/ima-dai-sdk · commit 2194d3b
Licence
Apache License 2.0 (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by Google LLC or Google.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download ima-dai-sdk.zip