TCF 同意字符串编码器
从 CMP 设置、目的同意、特殊功能和厂商 id 构建一个 IAB TCF v2.2 Transparency & Consent(TC)字符串——在你的浏览器中编码。
TCF 同意字符串编码器完全在你的浏览器中运行。你的 CMP 设置、目的选择和厂商 id 都在你的设备上编码,不抓取任何 Global Vendor List,也不会有任何内容上传到 ArrayKit。
打开 TCF 同意解码器
关于 TCF 同意字符串编码器
TCF 同意字符串编码器从一个表单构建一个 IAB TCF v2.2 Transparency & Consent(TC)字符串:设置你的 CMP ID、CMP 版本、同意屏幕、同意语言、vendor list 版本和 TCF 政策版本,然后切换目的同意(1-11)、目的合法权益、特殊功能选择加入以及一份厂商同意 id 列表。它组装出一个有效的 TCModel,并生成 base64url TC 字符串,你可以把它粘贴到 CMP 装置、Prebid 配置、广告请求或 QA 测试中。当 ad-ops 工程师和 CMP 开发者需要一个确定性的字符串来复现某个同意场景,或调试某个需求方为何被丢弃时,它很有用。每个字段都在你的设备上编码——不调用任何 CMP API,也不从网络抓取任何 global vendor list,因此测试同意数据绝不离开你的浏览器。
功能特性
- 从简单字段设置 CMP ID、CMP 版本、同意屏幕和同意语言
- 选择 vendor list 版本、TCF 政策版本以及服务特定与全局范围
- 切换全部 11 个已注册目的的同意和合法权益
- 选择加入两个特殊功能(精确地理位置、设备扫描)
- 把逗号分隔的厂商同意 id 列表编码进厂商段
- 输出一个可一键复制的 base64url TC 字符串
- 确定性编码,因此相同选择总是产生相同字符串
- 完全在你的浏览器中运行,不从网络抓取任何 vendor list
如何使用 TCF 同意字符串编码器
- 输入你的 CMP ID、CMP 版本、同意屏幕和两字母同意语言
- 设置 vendor list 版本、TCF 政策版本和存储范围开关
- 勾选用户已选择加入的目的、合法权益和特殊功能
- 把厂商同意 id 输入为逗号分隔列表
- 复制编码后的 TC 字符串,放入你的 CMP、广告请求或测试装置
示例
输入
cmpId: 300, cmpVersion: 1, lang: EN
purposeConsents: 1,2,3,4,7
vendorConsents: 1,8,755
输出
COzTVhaOzTVhaGvAAAENAiCIAP_AAH_AAAAAAAAA... (base64url TC string)
所选目的和厂商 id 被打包进一个 TCF v2.2 核心字符串。
常见错误与故障排除
- 解码字符串时,你添加的某个厂商 id 缺失了。 — TCF 编码会对照 vendor list 校验厂商同意。本工具声明你输入的每个 id 以确保其留存——在此处或 TCF 同意解码器中解码输出,以确认厂商位已被置位。
- 解码后的同意语言不是你输入的那个。 — TCF v2.2 强制同意语言为两字母大写(EN、FR、DE)。请恰好输入两个字母;工具会在编码前将其大写。
- 下游 CMP 因 cmpId 错误拒绝该字符串。 — CMP ID 为 0 和 1 是保留值,许多解码器会拒绝它们。请使用真实的 IAB 分配的 CMP ID(大于 1 的整数)。
- 解码字符串中的 vendor list 版本与你的输入不同。 — 编码的 vendor list 版本和 TCF 政策版本来自你在元数据字段中输入的值——请把它们设为与你的 CMP 正运行的 GVL 相匹配。
常见问题
- 什么是 TCF 同意字符串编码器?
- 它是一款工具,把 CMP 设置和用户同意选择——目的、合法权益、特殊功能和厂商 id——变成一个 IAB TCF v2.2 Transparency & Consent(TC)字符串,即 CMP 传给厂商和广告请求的 base64url 值。
- 该编码器生成哪个 TCF 版本?
- 它构建 TCF v2.2 核心字符串。你控制 TCF 政策版本和 vendor list 版本字段,输出是一个标准的 base64url TC 字符串,可被支持 TCF 的 CMP 和解码器读取。
- 我如何向字符串添加厂商同意?
- 把 IAB 厂商 id 输入到厂商同意字段,作为逗号或空格分隔的列表(例如 1, 8, 755)。每个 id 都会被编码进 TC 字符串的厂商同意段。
- 为什么同意语言必须是两个字母?
- TCF 规范将同意语言存储为两字符 ISO-639-1 码。编码器会将你的输入大写并校验,因此请输入如 EN、FR 或 DE 的码,而非完整语言名称。
- 编码会从服务器抓取 Global Vendor List 吗?
- 不会。为了完全留在你的浏览器中,工具会从你输入的 id 构建一个最小的内存 vendor list,而不下载 GVL。你的 CMP 设置和厂商 id 绝不会发送到任何地方。
- 我能解码在这里构建的字符串吗?
- 可以。把编码输出粘贴到 TCF 同意解码器中,检查 CMP 字段、目的和厂商,确认字符串如预期般往返。
相关工具
全部 ArrayKit 工具