适用于 HTML5 的 Google 互动式媒体广告 (IMA) SDK 支持安全交互式媒体接口定义 (SIMID) 1.1 版。本指南介绍了 IMA SDK 支持的特定 SIMID 功能和消息。
了解广告素材向玩家传达的信息
下表列出了 SIMID 广告素材可以发送到 IMA SDK 的消息:
| 消息 | 说明 |
|---|---|
clickThru |
根据广告素材提供的 URI 处理广告点击。 |
fatalError |
终止广告会话并报告广告素材中的严重错误。 |
getMediaState |
返回媒体播放器的当前状态,包括 URI、currentTime、duration、volume 和 muted 状态。 |
log |
将广告素材日志消息转发到 IMA SDK 以进行调试。 |
reportTracking |
请求 IMA SDK 代表广告素材 ping 跟踪网址。 |
requestChangeAdDuration |
请求修改广告会话的总时长。 |
requestNavigation |
请求导航到外部 URI。 |
requestPause |
请求 IMA SDK 暂停媒体播放器。 |
requestPlay |
请求 IMA SDK 恢复或播放媒体播放器。 |
requestResize |
请求调整视频播放器的大小。如果播放器允许调整大小,IMA SDK 会调整播放器的大小。 |
requestSkip |
请求 SDK 跳过当前广告。 |
requestStop |
请求 SDK 停止广告会话。 |
handleSkipShown |
通知 IMA SDK 广告素材已显示广告跳过界面。 |
requestFocus |
请求将焦点置于广告素材的 iframe 上。 |
查看“广告素材与播放器不兼容”消息
IMA SDK 不会处理以下 CreativeMessage 类型:
requestChangeVolumerequestFullscreenrequestExitFullscreen
了解玩家到广告内容的消息
下表列出了 IMA SDK 支持向 SIMID 广告素材发送的消息:
| 消息 | 说明 |
|---|---|
init |
在会话设置期间发送,包含环境数据和广告参数。 |
startCreative |
通知广告素材初始化并显示广告素材 iframe。 |
adStopped |
通知广告会话已结束,并提供原因代码。 |
adSkipped |
通知广告素材:用户或 IMA SDK 跳过了广告。 |
resize |
在播放器或视频尺寸发生变化时通知广告素材。 |
appBackgrounded |
通知广告素材应用已进入后台。 |
appForegrounded |
通知广告素材应用已返回前台。 |
fatalError |
向广告素材通知播放器端错误。 |
log |
将日志消息从播放器发送到广告素材。 |
focusIn |
通知广告素材已获得焦点。 |
查看媒体状态更新
IMA SDK 会针对以下事件向广告素材发送 mediaStateUpdate 消息:
playpausestalled(正在缓冲)seekingseekedendeddurationchangetimeupdate,定期。volumechange,包括忽略状态。