TCF 同意文字列デコーダー
IAB TCF v2.2 同意文字列をブラウザ内でデコードし、CMP メタデータ、目的とベンダーのグリッド、パブリッシャー制限を確認します。
TCF 同意文字列デコーダーは、すべてブラウザ内で動作します。貼り付けた同意文字列はデバイス上でデコードされ、ArrayKit にアップロードされることはなく、Global Vendor List やリモートエンドポイントに接続されることもありません。
TCF 同意文字列エンコーダーを開く
TCF 同意文字列デコーダー について
TCF 同意文字列デコーダーは、IAB Transparency & Consent(TC)文字列を展開し、広告オペレーションとプライバシーのエンジニアが CMP の記録内容を正確に確認できるようにします。base64url 文字列を貼り付けると、コアセグメントをローカルでデコードします: CMP id とバージョン、選択が取得された画面と言語、作成と最終更新のタイムスタンプ、Global Vendor List のバージョン、TCF ポリシーバージョンです。次に、すべてのビットフィールドを読みやすい id リストに展開します — 目的への同意(purpose consents)、目的の正当な利益(purpose legitimate interests)、特別機能のオプトイン、ベンダーへの同意(vendor consents)、ベンダーの正当な利益、およびパブリッシャー制限です。失敗する同意ハンドシェイクのデバッグ、タグが実際に保存した内容の監査、広告サーバーに届く前の値の確認に使えます。文字列はブラウザ内でデコードされ、デバイスから離れることはありません。
機能
- IAB TCF v2.2 のコアセグメントメタデータ(CMP id、バージョン、画面、同意言語)をデコード
- purpose consents と purpose legitimate interests を読みやすい id リストに展開
- 特別機能のオプトインを、ベンダーの同意と正当な利益のグリッドと並べて表示
- パブリッシャーの目的制限を、制限タイプと対象ベンダーとともに可視化
- 作成と最終更新のタイムスタンプ、および Global Vendor List のバージョンを表示
- service-specific か global スコープか、非標準テキスト、OOB サポートを指摘
- 任意の id リストを、バグレポートやチケット用にカンマ区切り文字列としてコピー
- すべてブラウザ内で動作 — 同意文字列がアップロードされることはありません
TCF 同意文字列デコーダー の使い方
- CMP の cookie、__tcfapi コールバック、または OpenRTB の user.ext.consent フィールドから TC 文字列をコピーする
- デコーダーに貼り付けるか、Sample をクリックして例の 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)文字列は、Consent Management Platform がユーザーの広告技術に関する同意選択 — どの目的、特別機能、ベンダーを許可したか — を保存するために書き込む、コンパクトな base64url 記録です。広告タグや OpenRTB リクエストがそれを運び、下流のベンダーが何をしてよいかを知ります。
- デコーダーがベンダーと目的の名前ではなく番号を表示するのはなぜですか?
- ベンダーと目的の名前は IAB Global Vendor List にあり、これはネットワーク経由で読み込まれます。このツールは貼り付けた文字列のみをデコードしネットワーク呼び出しを行わないので、エンコードされた通りの数値 id を表示します。ベンダー名を得るには、現在の Global Vendor List で id を調べてください。
- 貼り付ける TC 文字列はどこで見つかりますか?
- euconsent-v2 cookie に保存され、CMP の __tcfapi('getTCData', ...) 呼び出しで返され、OpenRTB ビッドリクエストで user.ext.consent として渡されます。これらの base64url 値のいずれかをコピーしてデコーダーに貼り付けてください。
- service-specific と global スコープの違いは何ですか?
- isServiceSpecific ビットは、同意が 1 つのサイトやサービスのために保存されたか(true)、共有の consensu.org グローバルスコープに保存されたか(false)を記録します。デコーダーはこのビットを可視化するので、シグナルがプロパティ間でどれだけ移植可能かがわかります。
- TC 文字列をデコードすると変更されたり再署名されたりしますか?
- いいえ。デコードは読み取り専用です — 既存のビットを解釈するだけで、再エンコード、再署名、文字列の変更は行いません。元の TC 文字列は変更されず、ブラウザ内でローカルに読まれるだけです。
- パブリッシャー制限や追加セグメントを読めますか?
- はい。コアセグメントを完全にデコードし、パブリッシャーの目的制限を制限タイプと対象ベンダーとともに列挙します。文字列に含まれないフィールド — 存在しない任意セグメントなど — は単に空として表示されます。
関連ツール
すべての ArrayKit ツール