跳转到主要内容

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.

​
TCF 是什么

IAB Transparency and Consent Framework（TCF） 是欧盟 / 英国广告技术领域用于收集与传递 GDPR consent 的标准。发布方展示同意弹窗，用户选择允许的内容，结果被编码为一个 TCF v2.2 consent 字符串。下游所有广告合作方——包括 Kontext——都会读取该字符串，据此判断可以如何使用用户的数据。

​
CMP 是什么

CMP（Consent Management Platform，同意管理平台） 是负责展示同意弹窗并产出 TCF 字符串的工具。CMP 会把该字符串写入一个所有兼容 TCF 的 SDK 都能读取的标准存储位置。 如果你的应用面向欧盟或英国用户，你需要一个 CMP：
  • GDPR 与英国数据保护法要求获得明确的同意 才能进行个性化广告投放。没有 CMP，你就无法合法地收集这种同意。
  • 没有有效的 TCF 字符串会导致填充率下降。 大多数 DSP 不会对没有 consent 信号的流量出价——或者只会以最低价做纯上下文相关广告。
  • 这是发布方的责任，不是 SDK 的责任。 Kontext SDK 不自带同意弹窗，需要你自己接入一个 CMP。
任何在 IAB 注册的 CMP 都可以——OneTrust、Sourcepoint、CookieBot / Usercentrics、Didomi 等。

​
SDK 自动读取 TCF

一旦你接入了兼容 TCF 的 CMP 并且用户完成了同意流程，SDK 会通过各平台的标准 IAB 接口读取 consent 字符串：
  • iOS —— UserDefaults 中的标准 key（IABTCF_TCString、IABTCF_gdprApplies 等）
  • Android —— SharedPreferences 中的同名 key
  • Web —— CMP 暴露的 __tcfapi window 函数
你不需要手动转发——gdpr 与 gdprConsent 会在每次 /preload 时被自动带上。

​
手动覆盖：regulatory 对象

如果你还没有接入 CMP、想要覆盖 SDK 自动读取的值、或者需要设置 TCF 范围之外的字段（COPPA、GPP、US Privacy），可以使用 session 上的 regulatory 对象。完整字段见 合规。常见场景：
  • 暂未接入 CMP —— 在你接入 CMP 之前手动传入 gdpr 与 gdprConsent。
  • COPPA —— 面向儿童的流量请设置 coppa: 1。TCF 不覆盖这个信号。
  • 美国隐私 / GPP —— 针对美国州法可传入 usPrivacy、gpp 或 gppSid。