KontextAds.createSession(...)
SessionOptions 创建并返回一个新的 Session,并在后台触发 /init。请传入 context.applicationContext,避免 session 与单个 Activity 绑定。
SessionOptions
隐私 / 同意信号。如果你接入了符合 TCF 的 CMP,SDK 会自动收集 TCF(
gdpr / gdprConsent)——仅在需要传 COPPA、GPP 或 US Privacy 时手动设置。可选的诊断事件流——内部所有 SDK 事件(preload 开始/结束、iframe 生命周期、几何更新等)都会触发。集成期间很有用,生产环境可保持为 null。
Session
追加一条 当
Message 到对话中。同步返回(不是 suspend)。用户消息会触发防抖后的预加载;助手消息让 SDK 把匹配到的广告绑定到广告位上。trackOnly = true 时,预加载会照常发送(用于上报分析数据),但不会生成广告。动态更新会话级别的可变字段。见 实践指南 → 动态更新会话选项。
MutablePublisherOptions
session.updateOptions(...) 接受的 SessionOptions 子集。所有字段均为可选——非 null 会覆盖原值,null 表示保持不变。
Message
AdOptions
AddMessageOptions
UI
InlineAd(Compose,推荐)
messageId 挂载广告。内部会调用 session.createAd(...),挂载一个池化的 WebView,并把容器几何信息上报给 iframe。可以安全地放在 LazyColumn 中——底层 Ad 和 WebView 会在重组与滚动复用中保持存活。
另一个重载直接接收已经解析好的 Ad:
InlineAdView(View 互操作)
bind(messageId, session);订阅 onHeightChange 来撑开外层容器(例如 RecyclerView 行)。
AdEvent
AdEvent 是 sealed class,每个 case 携带一个强类型的 payload。可以通过 event.name 拿到稳定的字符串标识。
AdEvent.Filled — wire name ad.filled
返回了一个广告并绑定到了广告位。
AdEvent.NoFill — wire name ad.no-fill
广告位没有返回广告(服务端 skip)。
AdEvent.AdHeight — wire name ad.height
iframe 上报了新的高度。用于撑开 RecyclerView 行的高度。InlineAd composable 会自动处理这件事。