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.
摘要
- 用途
- 它協助在數位產品中整合 Google IMA SDK，以請求並管理串流影片與音訊廣告。
- 使用時機
- 在網站、應用程式、電視或其他平台透過 VAST 或 VMAP 實作用戶端廣告請求時使用；不適用於 DAI、SSAI 或 SGAI。
- 輸出結果
- 它提供涵蓋 SDK 設定、廣告請求、載入與播放事件及錯誤處理，以及 AdsManager 清理的一般流程，並提供平台專屬指南供實作參考。
上游變更（5 筆，最新收錄 2026-08-11）
80513f4 Renames IMA SDK basics skill from ima-sdk-basics to ima-sdk-client-side. 將技能重新命名為 `ima-sdk-client-side`，修訂其 IMA 用戶端說明，並將中繼資料版本從 1.0.0 升至 1.0.1。 703f8d2 Move ads skills from per-product subdirectories to top-level skills/ads/ directory. 將技能檔案從 `interactive-media-ads` 子目錄移至 `skills/ads/ima-sdk-basics`，未變更檔案內容。 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 在技能中繼資料下新增 `category: GoogleAds`，並移除了標題前的空白行。 28d90a3 Add new skill for Interactive Media Ads SDK basics. 新增 `ima-sdk-basics` 技能，說明 IMA 用戶端的使用方式、連結各平台指南，並概述一般廣告整合流程。 npx skills add "lettucebo/Skills#v2.2.0@ima-sdk-client-side" --full-depth ⚠ v2.2.0 發布後即可使用
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.