onEvent —— 公开的广告生命周期
onEvent 会触发少量公开的广告生命周期事件:ad.filled、ad.no-fill、ad.viewed、ad.clicked、ad.error,以及视频和奖励相关事件。这些通常用来驱动你的 UI 与分析。
完整列表与 payload 见 广告生命周期事件。
onDebugEvent —— 详细的内部日志
onDebugEvent 会触发 SDK 内部的每一个步骤——预加载请求的开始与完成、message id 配对、重试尝试、iframe 加载里程碑等等。它内容非常多,且在 SDK 版本之间不保证稳定;请把它当作诊断日志使用,不要当作 API。
只在排查问题时打开它,之后在生产环境记得关掉:
出现异常时
如果广告没有出现、触发了错误的事件、或 SDK 表现不符合预期:- 在你的构建中重新打开
onDebugEvent。 - 复现问题。
- 把完整的
onDebugEvent输出发送给我们:support@kontext.so。
skipCode 参考
当 ad.no-fill 事件触发时,其 payload 会携带一个 skipCode,说明为何没有返回广告。可能出现的值: