Skip to main content
这是 5 分钟接入的完整流程。开始之前,请确认你已经完成 安装

1. 安装插件

KontextAdsPlugin 会初始化一个会话,应用内的任意组件都可以通过 useAds() composable 访问到它。
如果你想把会话限定在组件树的某一部分,可以改用 <AdsProvider>——它接受与插件相同的选项。

2. 向 SDK 喂消息

SDK 会根据新的聊天消息预加载广告。无论是用户消息还是助手消息,每出现一条就用 useAds() 返回的 addMessage() 通知 SDK。

3. 挂载 <InlineAd>

广告位(ad slot)是 UI 中专门用来渲染广告的区域,通常出现在助手消息下方。 <InlineAd /> 放在希望广告出现的位置,并传入对应助手消息的 messageId

订阅事件

通过插件或 <AdsProvider>onEvent prop 订阅广告生命周期事件。每个事件都有稳定的 name 和类型化的 payload
每个与广告位相关的事件(ad.filledad.viewedad.clickedad.render-*video.*reward.granted)的顶层还携带一个 code 字段,标识匹配到的广告位——配置了多个 enabledPlacementCodes 的发布方可以据此区分。会话级事件(ad.no-fillad.error)则不带这个字段。 接入期间若需查看 SDK 内部诊断信息,可以再传入 onDebugEvent 回调——它会对 SDK 的每一个内部步骤回调 (name, data?)