SDK 架構
本指南將概略說明 SDK 生命週期,以及影片播放器、IMA SDK 和廣告伺服器之間的互動情形。
基本互動
下圖說明影片播放器、IMA SDK 和廣告伺服器之間的互動情形,並標示相關資訊。廣告伺服器可以使用 Ad Manager、AdSense 影片廣告 (AFV) 或 Ad Exchange (AdX)。

網頁或應用程式會使用以下方式載入 IMA SDK:
- HTML5 的嵌入式指令碼標記
- Android、Google Cast、iOS 或 tvOS 版應用程式
IMA SDK 會針對廣告伺服器上的特定廣告單元,要求 VAST 回應。系統會根據廣告代碼網址決定要呼叫的廣告伺服器 (可能是 Ad Manager、AFV 或 AdX)。
廣告伺服器會選取最適合的廣告,並將 VAST 回應傳送至 IMA SDK。系統會使用下列任一方法選取廣告:
- Ad Manager 廣告單元篩選委刊項候選項目
- AdSense 或 Ad Exchange 執行競價
IMA SDK 會剖析 VAST 回應,根據環境決定正確的媒體類型,並將內嵌影片廣告素材 (以及隨播廣告,如有需要) 提交至網頁或應用程式。
影片播放器會與 IMA SDK 協商播放詳細資料,然後播放廣告。
IMA SDK 會視需要觸發曝光偵測和 VAST 追蹤事件。
生命週期
下圖顯示 IMA SDK 的完整生命週期。建構函式和方法呼叫會以藍色醒目顯示,事件則會以紅色醒目顯示,錯誤狀態則會以紅色連接點和紅色文字顯示。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-03-07 (世界標準時間)。
[null,null,["上次更新時間:2025-03-07 (世界標準時間)。"],[[["This guide outlines the lifecycle of the Interactive Media Ads (IMA) SDK and how it interacts with your video player and an ad server (Ad Manager, AdSense for Video, or Ad Exchange)."],["The process involves the IMA SDK requesting and parsing ad responses, delivering ads to the player, and managing playback and tracking events."],["Ad selection is handled either through Ad Manager's Ad Unit filters or via auctions in AdSense or Ad Exchange."],["Developers integrate the IMA SDK using script tags for HTML5 or dedicated apps for various platforms including Android, iOS, and tvOS."],["The guide also highlights potential error conditions within the SDK lifecycle."]]],[]]