KontextAds.createSession(_:)
SessionOptions 创建并返回一个新的 Session,并在后台触发 /init。
SessionOptions
隐私 / consent 信号。如果集成了兼容 TCF 的 CMP,TCF 字段(
gdpr / gdprConsent)会被自动收集——只有 COPPA、GPP、US Privacy 才需要手动设置。Session
实时更新与预加载相关的字段。详见 实践指南 → 会话选项的实时更新。
MutablePublisherOptions
session.updateOptions(_:) 接受的 SessionOptions 子集。所有字段都是可选的——非 nil 会覆盖原值,nil 保持不变。
Message
AdOptions
AddMessageOptions
AdEvent
AdEvent 是一个枚举,每个 case 携带类型化的 payload。每个 case 都有稳定的字符串标识,可通过 event.name 访问。
.filled(FilledData) —— wire name ad.filled
广告位拿到了一条广告。
.noFill(NoFillData) —— wire name ad.no-fill
广告位没有返回广告(服务端跳过)。
.adHeight(AdHeightData) —— wire name ad.height
广告 iframe 上报了新的高度。可用于调整外层容器的尺寸(在 UIKit UITableView / UICollectionView cell 中尤其有用)。