メインコンテンツまでスキップ

UID2 Token Validator

UID2 Token Validator は、UID2 Token をその元となる DII (directly identifying information) と照合し、トークン生成プロセスが正しいかどうかを確認するためのウェブベースのツールです。

Overview​

DII を提供することで UID2 Token を生成するパブリッシャーは、有効に見えるにもかかわらず UID2 エコシステムで使用できないトークンを受け取ることがあります。これは、正規化またはハッシュ化のステップが正しく実行されなかった場合に発生します。UID2 はトークンの導出に DII の正規化・ハッシュ化された形式を使用するため、いずれかのステップでエラーが発生すると、そのパブリッシャー固有の raw UID2 が生成されます。この不一致な raw UID2 は、他の参加者が同じ DII に対して使用するものと一致しないため、そのパブリッシャーのトークンは、他のパブリッシャー、データプロバイダー、または広告主の CRM アップロードによるトークンと一致しません。

Prerequisites​

UID2 Token Validator を使用するには、以下が必要です:

  • UID2 API Key (Client Key)
  • UID2 Client Secret

これらをお持ちでない場合は、UID2 Portal での作成手順について API Keys を参照してください。

Using the Token Validator​

Token Validation セクションの上部にあるフィールドに API Key (Client Key) と Client Secret を入力します。

検証対象の Operator（環境）を選択します。UID2 の環境については、Environments を参照してください。

Validate a Single Token​

  1. Input Mode で Single Validation を選択します。
  2. Identifier フィールドに、トークンの生成に使用した DII を入力します。以下のいずれかを入力できます:
    • 生のメールアドレス
    • 生の電話番号
    • Base64 エンコードされたメールアドレスハッシュ
    • Base64 エンコードされた電話番号ハッシュ
  3. 入力内容に一致する識別子タイプを選択します。
  4. Token フィールドに、検証する UID2 Token を貼り付けます。
  5. Validate Tokens をクリックします。

Validate Multiple Tokens (CSV)​

トークンと識別子のペアを一括検証するには:

  1. Input Mode で CSV を選択します。
  2. 次の列を持つ CSV ファイルを用意します:
    • identifier: DII（生のメールアドレス、生の電話番号、メールアドレスハッシュ、または電話番号ハッシュ）。
    • identifier_type: email、phone、email_hash、または phone_hash のいずれか。
    • token: 検証する UID2 Token。
  3. CSV ファイルをアップロードします。
  4. Validate Tokens をクリックします。

Interpret Validation Results​

Validate Tokens をクリックすると、Validation Results テーブルにトークンと識別子の各ペアの行が、以下の表に示す形式で表示されます。

ColumnDescription
Identifier入力した DII。
Identifier Typeemail、phone、email_hash、または phone_hash。
Normalized Hash正規化された DII の Base64 エンコードされた SHA-256 ハッシュ。
Token送信したトークン。
Validation検証の結果。詳細については、以下の表を参照してください。

Validation 列には POST /token/validate エンドポイントからのレスポンスが反映されます。

Validation ResultMeaning
Token matches identifierトークンが提供された DII と一致しています。これは、トークンが正しい正規化ハッシュから生成されたことを意味します。
Failed: Token does not match identifierトークンが提供された DII と一致しません。最も可能性の高い原因は、正規化またはハッシュ化の誤りです。
Failed: Invalid tokenトークンの形式が不正で、解析できません。
Failed: {"status":"unauthorized"}提供された API 認証情報が無効または許可されていません。
ヒント

結果が Failed: Token does not match identifier の場合、結果に表示される Normalized Hash と、同じ DII に対して自身の実装で生成した値を比較してください。異なる場合は、正規化またはハッシュ化のステップに問題があります。詳細については、Normalization and Encoding および Preparing Emails and Phone Numbers for Processing を参照してください。