/preload 的那一刻,一直到用户点击为止。你通过 onEvent(或各平台等价的接口——Swift 上是 Combine publisher,Kotlin 上是 Flow,等等)订阅这些事件,然后按自己应用的需求作出响应。
本页把所有事件集中列出。各平台具体 API 见 SDK 页面。
三个阶段,同一条事件流
所有事件都从同一条流中发出,但按照它所属的阶段来理解会更清晰:/preload返回之后 —— SDK 已决定当前助手消息是否会有可用的广告。会触发ad.filled、ad.no-fill或ad.error。- 广告渲染过程中 —— iframe 开始流式输出内容并完成。会触发
ad.render-started、ad.render-completed,以及ad.height(iframe 上报尺寸时)。 - 用户与广告交互时 —— 当满足 MRC 可见性标准时触发
ad.viewed,被点击时触发ad.clicked,对视频 / 奖励素材还会触发video.started、video.completed、reward.granted。
事件参考
各平台的具体字段名见对应的 SDK 页面——语义完全一致,只是按各语言的命名风格略有差异。
下一步
展示广告
这些事件在渲染流程中的位置。
节奏控制
抑制某一轮广告时,事件会发生什么变化。
合规
ad.viewed 背后的 OMID 标准与各 SDK 的认证状态。调试
onDebugEvent 与服务端 debug 转发,可获得更深入的诊断信息。