TCF 同意字符串解码器
在你的浏览器中解码一个 IAB TCF v2.2 同意字符串,查看 CMP 元数据、目的与厂商网格,以及发布商限制。
TCF 同意字符串解码器完全在你的浏览器中运行。你粘贴的同意字符串在你的设备上解码,绝不会上传到 ArrayKit,也不会联系任何 Global Vendor List 或远程端点。
打开 TCF 同意字符串编码器
关于 TCF 同意字符串解码器
TCF 同意字符串解码器把一个 IAB Transparency & Consent(TC)字符串拆解开来,让 ad-ops 和隐私工程师能准确看到某个 CMP 记录了什么。粘贴 base64url 字符串,它会在本地解码核心段:CMP id 和版本、采集选择时所在的屏幕和语言、创建与最后更新时间戳、Global Vendor List 版本,以及 TCF 政策版本。随后它把每个位字段展开为可读的 id 列表——目的同意、目的合法权益、特殊功能选择加入、厂商同意、厂商合法权益,以及任何发布商限制。用它来调试失败的同意握手、审计一个标签实际存储了什么,或在某个值到达你的广告服务器前确认它。该字符串在你的浏览器中解码,绝不离开你的设备。
功能特性
- 解码 IAB TCF v2.2 核心段元数据:CMP id、版本、屏幕和同意语言
- 把目的同意和目的合法权益展开为可读的 id 列表
- 在厂商同意和合法权益网格旁显示特殊功能选择加入
- 呈现发布商目的限制及其限制类型和受影响厂商
- 显示创建与最后更新时间戳以及 Global Vendor List 版本
- 标出服务特定与全局范围、非标准文本以及 OOB 支持
- 将任意 id 列表复制为逗号分隔字符串,用于缺陷报告或工单
- 完全在你的浏览器中运行——同意字符串绝不会上传
如何使用 TCF 同意字符串解码器
- 从 CMP cookie、__tcfapi 回调或 OpenRTB user.ext.consent 字段中复制 TC 字符串
- 把它粘贴到解码器,或点击「示例」加载一个示例 TC 字符串
- 查看 CMP 元数据,然后扫视目的、特殊功能和厂商网格
- 复制任意 id 列表,与你的团队分享精确的同意状态
示例
输入
COvFyGBOvFyGBAbAAAENAPCAAOAAAAAAAAAAAEEUACCKAAA
输出
CMP 27 · policy v2 · language EN · GVL 15
purposeConsents: 1, 2, 3
vendorConsents: 2, 6, 8
一个仅含核心段的 TC 字符串被解码为其 CMP 元数据和同意网格。
常见错误与故障排除
- 解码器报告该字符串不是有效的 TC 字符串。 — 请粘贴完整的 base64url TC 字符串,不带外围引号或换行。被截断的核心段或经 URL 编码的副本(用 %3D 代替 =)都会解码失败。
- 目的或厂商列表看起来比预期短。 — TC 字符串只存储 CMP 明确设置的 id。缺失的 id 表示未获得同意。请确认你粘贴的是完整字符串,而不仅是第一个句点之前的段。
- 时间戳看起来相差数小时。 — TCF 时间戳以天级 UTC 精度存储。解码器以 UTC 显示它们,因此在与本地日志比较前请换算到你的本地时区。
- 你期望看到厂商名称,却只看到数字。 — 厂商和目的名称来自 IAB Global Vendor List,本工具不抓取它。请用元数据中显示的 Global Vendor List 版本来对照数字 id。
常见问题
- 什么是 IAB TCF 同意字符串?
- TCF(Transparency & Consent Framework)字符串是一条紧凑的 base64url 记录,由一个 Consent Management Platform 写入以存储用户的 ad-tech 同意选择——他们允许了哪些目的、特殊功能和厂商。广告标签和 OpenRTB 请求携带它,好让下游厂商知道自己可以做什么。
- 为什么解码器显示厂商和目的的数字而非名称?
- 厂商和目的名称存在于 IAB Global Vendor List 中,它需通过网络加载。本工具只解码你粘贴的字符串且不发起任何网络调用,因此它精确显示编码中的数字 id。请在当前 Global Vendor List 中查找某个 id 以获取厂商名称。
- 我在哪里找到要粘贴的 TC 字符串?
- 它存储在 euconsent-v2 cookie 中,由 CMP 的 __tcfapi('getTCData', ...) 调用返回,并在 OpenRTB 竞价请求中作为 user.ext.consent 传递。复制这些 base64url 值中的任意一个并粘贴到解码器即可。
- 服务特定范围与全局范围有什么区别?
- isServiceSpecific 位记录同意是为某一个站点或服务存储(true),还是存储在共享的全局 consensu.org 范围(false)。解码器会呈现此位,让你判断该信号在不同资产间的可移植程度。
- 解码一个 TC 字符串会更改或重新签名它吗?
- 不会。解码是只读的——它解释现有的位而不重新编码、重新签名或更改字符串。你的原始 TC 字符串保持不变,且只会在你的浏览器中本地读取。
- 它能读取发布商限制和额外段吗?
- 可以。它完整解码核心段,并列出发布商目的限制及其限制类型和受影响厂商。字符串未包含的字段——例如缺失的可选段——会直接显示为空。
相关工具
- TCF 同意字符串编码器 — 从 CMP 设置、目的同意、特殊功能与厂商 id 构建 IAB TCF v2.2 TC 字符串。
- GPP 字符串解码器 — 解码 IAB GPP 同意字符串的头部、gpp_sid 与每个内嵌段的可读字段。
- US Privacy 字符串解码器 — 解码 4 字符的 CCPA us_privacy 字符串,读取通知、销售选择退出与 LSPA 标志。
- OpenRTB 竞价请求生成器 — 从表单构建符合规范的 OpenRTB 2.5 与 2.6 竞价请求并复制 JSON。
- VAST 宏展开器 — 在跟踪 URL 中展开 IAB VAST 4.x 宏并预览触发的请求,附可搜索参考。
- ads.txt 校验器 — 逐行校验 ads.txt 或 app-ads.txt 的字段数量、DIRECT/RESELLER 关系与重复项。
全部 ArrayKit 工具