TCF 同意文字列エンコーダー
CMP 設定、purpose consents、特別機能、ベンダー 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 バージョン、同意画面、同意言語、ベンダーリストバージョン、TCF ポリシーバージョンを設定し、purpose consents(1-11)、purpose legitimate interests、特別機能のオプトイン、ベンダー同意 id のリストを切り替えます。有効な TCModel を組み立て、CMP フィクスチャ、Prebid 設定、広告リクエスト、QA テストに貼り付けられる base64url の TC 文字列を生成します。広告オペレーションエンジニアと CMP 開発者が、同意シナリオを再現したり、需要パートナーがなぜドロップされるかをデバッグしたりするために決定論的な文字列を必要とするときに便利です。すべてのフィールドはデバイス上でエンコードされます — CMP API は呼び出されず、Global Vendor List はネットワークからフェッチされないので、テスト同意データがブラウザから離れることはありません。
機能
- CMP ID、CMP バージョン、同意画面、同意言語をシンプルなフィールドから設定
- ベンダーリストバージョン、TCF ポリシーバージョン、service-specific と global スコープを選択
- 登録済みの全 11 目的について、consent と legitimate interest を切り替え
- 2 つの特別機能(正確な位置情報、デバイススキャン)にオプトイン
- カンマ区切りのベンダー同意 id リストを vendor セクションにエンコード
- ワンクリックでコピーできる base64url の TC 文字列を出力
- 決定論的なエンコード — 同じ選択は常に同じ文字列を生成
- すべてブラウザ内で動作 — ベンダーリストはネットワークからフェッチされません
TCF 同意文字列エンコーダー の使い方
- CMP ID、CMP バージョン、同意画面、2 文字の同意言語を入力する
- ベンダーリストバージョン、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 エンコーダーはベンダー同意をベンダーリストに照らして検証します。このツールは入力した各 id を宣言するので id は生き残ります — 出力をここまたは TCF 同意デコーダーでデコードして、ベンダービットが設定されているか確認してください。
- デコードされた同意言語が入力したものと違う。 — TCF v2.2 は同意言語を 2 文字の大文字(EN、FR、DE)に強制します。ちょうど 2 文字を入力してください。ツールはエンコード前に大文字化します。
- 下流の CMP が cmpId エラーで文字列を拒否する。 — CMP ID の 0 と 1 は予約済みで、多くのデコーダーが拒否します。実際の IAB 割り当て CMP ID(1 より大きい整数)を使ってください。
- デコードされた文字列のベンダーリストバージョンが入力と異なる。 — エンコードされるベンダーリストバージョンと TCF ポリシーバージョンは、メタデータフィールドに入力した値に由来します — CMP が実行している GVL に一致するよう設定してください。
よくある質問
- TCF 同意文字列エンコーダーとは何ですか?
- CMP 設定とユーザーの同意選択 — 目的、正当な利益、特別機能、ベンダー id — を IAB TCF v2.2 の Transparency & Consent(TC)文字列に変換するツールです。この base64url の値を CMP がベンダーや広告リクエストに渡します。
- このエンコーダーはどの TCF バージョンを生成しますか?
- TCF v2.2 のコア文字列を構築します。TCF ポリシーバージョンとベンダーリストバージョンのフィールドを制御でき、出力は TCF 対応の CMP やデコーダーが読める標準の base64url TC 文字列です。
- 文字列にベンダー同意をどう追加しますか?
- IAB ベンダー id を vendor consent フィールドにカンマまたはスペース区切りのリストとして入力してください(例: 1, 8, 755)。各 id は TC 文字列の vendor-consent セクションにエンコードされます。
- なぜ同意言語は 2 文字でなければならないのですか?
- TCF 仕様は同意言語を 2 文字の ISO-639-1 コードとして保存します。エンコーダーは入力を大文字化して検証するので、言語の正式名称ではなく EN、FR、DE のようなコードを入力してください。
- エンコードはサーバーから Global Vendor List をフェッチしますか?
- いいえ。完全にブラウザ内に留まるため、ツールは GVL をダウンロードする代わりに、入力した id から最小限のインメモリベンダーリストを構築します。CMP 設定とベンダー id がどこかに送られることはありません。
- ここで構築した文字列をデコードできますか?
- はい。エンコードされた出力を TCF 同意デコーダーに貼り付けて、CMP フィールド、目的、ベンダーを検査し、文字列が期待通りに往復するか確認してください。
関連ツール
すべての ArrayKit ツール