跳转到主要内容

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.

Kontext 按照发布方、广告主与平台方对一个现代广告 SDK 的标准期望进行构建。本页总结我们当前的合规状况,以及每个 SDK 的进度。

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 个月内完成。
如果你需要更快拿到某个具体平台的可见性能力,请联系 support@kontext.so

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 对象上的 gdpr1 / 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
  • 你提供的 publisherTokenuserIdconversationId
  • 标准的设备、应用与网络属性(机型、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 沙箱中渲染。
本页未涵盖的内容,请联系 support@kontext.so