Kontext 按照发布方、广告主与平台方对一个现代广告 SDK 的标准期望进行构建。本页总结我们当前的合规状况,以及每个 SDK 的进度。Documentation Index
Fetch the complete documentation index at: https://docs.kontext.so/llms.txt
Use this file to discover all available pages before exploring further.
OMID 与可见性
Open Measurement (OMID) 是 IAB Tech Lab 制定的第三方可见性与验证标准。- Swift SDK (iOS) —— 已通过 IAB OMID 认证。
- Kotlin SDK (Android) —— 认证进行中,正在等待 IAB Tech Lab 的最终审批。
- React Native SDK 与 Flutter SDK —— 认证准备中,预计在 1–2 个月内完成。
IAB Tech Lab
SDK 支持 IAB TCF v2.2。它会从所有兼容 TCF 的 CMP 都会写入的标准 IAB 存储位置(iOS 上的UserDefaults、Android 上的 SharedPreferences、Web 上的 localStorage)自动读取 TCF consent 字符串。发布方无需手动转发。
隐私法规
SDK 在 session 上暴露一个 regulatory 对象,发布方可通过它向广告服务转发 consent 与隐私信号。所有字段都是可选的——按用户所在司法管辖区,提供适用的那些即可。- GDPR (欧盟 / 英国) —— TCF v2.2 consent 字符串会被自动收集(见上方 IAB Tech Lab)。你也可以通过 regulatory 对象上的
gdpr(1/0)和gdprConsent(TCF 字符串)显式覆盖。 - CCPA / CPRA(美国) —— 在
usPrivacy中传入 IAB US Privacy 字符串。 - GPP(Global Privacy Platform) —— 在
gpp中传入 GPP 字符串,并在gppSid中传入适用的 section ID。 - COPPA(美国) —— 当用户已知为 13 岁以下时,将
coppa设为1。SDK 与广告服务会据此把请求作为面向儿童的请求处理。
数据处理
SDK 只收集投放上下文相关广告并衡量其表现所必需的数据:- 你通过
addMessage传入的聊天消息(用于上下文定向)。 - 用户授权时的平台广告标识符(iOS 上的 IDFA、Android 上的 GAID)。
- SDK 自身生成并持久化在应用存储中的第一方
installId。 - 你提供的
publisherToken、userId与conversationId。 - 标准的设备、应用与网络属性(机型、OS 版本、应用 bundle、网络连接类型)。
平台政策
- Apple ATT(iOS 14+) —— SDK 会在读取 IDFA 之前请求 App Tracking Transparency 授权。发布方应用必须在
Info.plist中声明NSUserTrackingUsageDescription。 - Google AD_ID 权限(Android 13+) —— SDK 通过 manifest merger 自动声明
com.google.android.gms.permission.AD_ID。 - SKAdNetwork(iOS) —— 为了让安装归因正常工作,发布方应用必须把所有 DSP 的
SKAdNetworkItems列在Info.plist中。完整清单会在 onboarding 期间提供。 - Web cookies —— JavaScript 与各前端框架 SDK 自身不设置任何跟踪 cookie;广告素材在 iframe 沙箱中渲染。