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

Normalization and Encoding

このページでは、ユーザー情報の正規化とエンコードに関する情報を提供します。UID2 を使用する際には、正規化とエンコードを正しく行うことが重要です。

Introduction

メールアドレスなどのユーザー情報を取得し、raw UID2 や UID2 Advertising Token を作成する手順に従う場合、必要な手順に正確に従うことが非常に重要です。情報を正規化する必要があろうがなかろうが、ハッシュ化する必要があろうがなかろうが、手順には正確に従ってください。そうすることで、作成した UID2 の値を、同じユーザーによる他のオンライン行動の事例と安全かつ匿名で照合できるようになります。

important
  • Raw UID2 とそれに関連する UID2 Token は、大文字と小文字を区別します。UID2 を扱う際には、大文字小文字を変えずにすべての ID とトークンを渡すことが重要です。ID が不一致の場合、ID の解析やトークンの復号化でエラーが発生する可能性があります。
  • 必要なステップのどれかを欠いた場合—たとえば、最初に正規化せずにハッシュした場合—その結果は有効な UID2 値にはなりません。
    例えば、あるデータプロバイダが Jane.Saoirse@gmail.com から UID2 を生成したいとします。これは janesaoirse@gmail.com に正規化され、ハッシュ化されて Base64 エンコードされた値は ku4mBX7Z3qJTXWyLFB1INzkyR2WZGW4ANSJUiW21iI8= となります。
    同じメールアドレスを持つパブリッシャーは正規化しません。正規化されていないメールアドレス Jane.Saoirse@gmail.com をハッシュ化し Base64 エンコードした値は f8upG1hJazYKK8aEtAMq3j7loeAf5aA4lSq6qYOBR/w= です。これら2つの異なる値は、2つの異なる UID2 になります。最初のものは正しく処理され、同じ元データから生成された他のインスタンスと一致すします。2つ目は正しく処理されていないため、一致しません。
    このシナリオでは、UID2 が同じユーザーの他のインスタンスと一致しないため、パブリッシャーはターゲティング広告から利益を得る機会を逃してしまいます。

Types of Directly Identifying Information

UID2は、以下の種類の DII (direct identifying information) をサポートしています:

  • メールアドレス
  • 電話番号

Email Address Normalization

UID2 Operator Service にハッシュ化されていないメールアドレスを送信すると、同サービスはメールアドレスを正規化してからハッシュ化します。メールアドレスを送信する前に自分でハッシュ化したい場合は、ハッシュ化する前に正規化する必要があります。

IMPORTANT: ハッシュ化する前に正規化することで、生成される UID2 値が常に同じになり、データを照合できます。ハッシュ化する前に正規化しない場合、異なる UID2 が生成され、ターゲティング広告の効果が低下する可能性があります。

メールアドレスを正規化するには、次の手順を実行します:

  1. 先頭と末尾のスペースを削除します。

  2. ASCII 文字をすべて小文字に変換します。

  3. メールアドレス (ASCII コード 46) にピリオド (.) がある場合は、削除します。
    例えば、jane.doe@example.comjanedoe@example.com に正規化します。

  4. (条件付き) gmail.com のアドレスの場合のみ、@gmail.com の前にプラス記号 (+) とその後ろに追加の文字列が表示されることがあります。この場合、メールアドレスのこの部分を削除する必要があります。これは gmail アドレスにのみ適用されます。以下を削除してください:

    1. プラス記号 (+) (ASCII code 43)。

    2. それ以降のすべての文字。

      例えば、janedoe+home@gmail.comjanedoe@gmail.com に正規化します。

さまざまなシナリオの例は、Normalization Examples for Email を参照してください。

Email Address Hash Encoding

メールアドレスハッシュは、正規化されたメールアドレスの SHA-256 ハッシュを Base64 エンコードしたものです。メールアドレスはまず正規化され、次に SHA-256 ハッシュアルゴリズムを使ってハッシュ化され、その結果のハッシュ値のバイトが Base64 エンコーディングを使ってエンコードされます。16進エンコードされた文字列表現ではなく、ハッシュ値のバイトがエンコードされることに注意してください。

TypeExampleComments and Usage
正規化メールアドレスuser@example.com正規化は常に最初のステップです。
正規化されたメールアドレスのSHA-256ハッシュb4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514この 64 文字の文字列は、32 バイトの SHA-256 を 16 進符号化したものです。
正規化されたメールアドレスの 16 進数から Base64 SHA-256 エンコーディングへの変換tMmiiTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ=この 44 文字の文字列は、32 バイトの SHA-256 を Base64 エンコードしたものです。
WARNING: 上の例の SHA-256 ハッシュ文字列は、ハッシュ値を 16 進符号化したものです。ハッシュの Raw バイトを Base64 エンコードするか、16 進エンコードされた値を入力とする Base64 エンコーダを使用する必要があります。
リクエストボディに送られる email_hash 値にはこのエンコーディングを使用します。

WARNING: Base64 エンコードを適用する場合、ハッシュの Raw バイトを必ず Base64 エンコードするか、16 進エンコードされた値を入力とする Base64 エンコーダを使用してください。

その他の例は、Normalization Examples for Email を参照してください。

Phone Number Normalization

ハッシュ化されていない電話番号を UID2 Operator Service に送信すると、同サービスは電話番号を正規化した後、ハッシュ化します。電話番号を送信する前に自分でハッシュ化したい場合は、ハッシュ化する前に電話番号を正規化する必要があります。

IMPORTANT: ハッシュ化する前に正規化することで、生成される UID2 値が常に同じになり、データを照合できます。ハッシュ化する前に正規化しない場合、異なる UID2 が生成され、ターゲティング広告の効果が低下する可能性があります。

ここでは、電話番号の正規化ルールについて説明します:

  • UID2 Operator は、E.164 形式の電話番号を受け付けます。これは、国際的に一意性を保証する国際電話番号の形式です。
  • E.164 電話番号は、最大 15 桁までです。
  • 正規化された E.164 電話番号は、スペース、ハイフン、括弧、その他の特殊文字を使用せず、以下の構文を使用します:
    [+] [country code] [subscriber number including area code] Examples:
    • US: 1 (123) 456-7890+11234567890 に正規化されます。
    • Singapore: 65 1243 5678+6512345678 に正規化されます。
    • Sydney, Australia: (02) 1234 5678 は、都市名の先頭のゼロを削除し、国コードを含むように正規化されます: +61212345678

Phone Number Hash Encoding

電話番号ハッシュは、正規化された電話番号を SHA-256 ハッシュを Base64 エンコードしたものです。電話番号はまず正規化され、次に SHA-256 ハッシュアルゴリズムを使ってハッシュ化され、その結果の 16 進値が Base64 エンコーディングを使ってエンコードされます。

以下の例は、単純な入力電話番号と、安全で不透明な URL-safe な値を得るために各ステップが適用された結果を示しています。

TypeExampleComments and Usage
正規化電話番号+12345678901正規化は常に最初のステップです。
正規化された電話番号の SHA-256 ハッシュ10e6f0b47054a83359477dcb35231db6de5c69fb1816e1a6b98e192de9e5b9eeこの64文字の文字列は、32 バイトの SHA-256 を 16 進符号化したものです。
正規化およびハッシュ化された電話番号の 16 進数から Base64 SHA-256 エンコーディングへの変換EObwtHBUqDNZR33LNSMdtt5cafsYFuGmuY4ZLenlue4=この 44 文字の文字列は、32 バイトの SHA-256 を Base64 エンコードしたものです。
NOTE: SHA-256 ハッシュは 16 進数値です。16 進値を入力とする Base64 エンコーダを使う必要があります。リクエストボディに送られる phone_hash の値にはこのエンコーディングを使います。

WARNING: Base64 エンコーディングを適用する場合は、必ず 16 進数値を入力として受け取る関数を使用してください。テキストを入力として受け取る関数を使った場合、結果は UID2 の目的には無効な長い文字列となります。

Normalization Examples for Email

以下の表は、元のメールアドレスと正規化された値、ハッシュ化された値の例を示しています。

いくつかの例では、プラス記号 (+) を含み、ドメインが異なるメールアドレスを示しています。gmail アドレスの場合、プラス記号とそれに続く文字 (@記号まで) は正規化では無視されます。その他のドメインの場合、これらの文字は正規化された値に含まれます。

Original ValueNormalizedHashed and Base64-Encoded
MyEmail@example.com
MYEMAIL@example.com
My.Email@example.com
myemail@example.comHashed: 16c18d336f0b250f0e2d907452ceb9658a74ecdae8bc94864c23122a72cc27a5
Base64-Encoded: FsGNM28LJQ8OLZB0Us65ZYp07NrovJSGTCMSKnLMJ6U=
JANESAOIRSE@example.com
JaneSaoirse@example.com
Jane.Saoirse@example.com
janesaoirse@example.comHashed: d6670e7a92007f1b5ff785f1fc81e53aa6d3d7bd06bdf5c473cdc7286c284b6d
Base64-Encoded: 1mcOepIAfxtf94Xx/IHlOqbT170GvfXEc83HKGwoS20=
JaneSaoirse+UID2@example.comjanesaoirse+uid2@example.comHashed: 6e143668c206593d5ecb8a7b2726af74d948438a5ed75febadcbf4bb58ebc427
Base64-Encoded: bhQ2aMIGWT1ey4p7JyavdNlIQ4pe11/rrcv0u1jrxCc=
JANE.SAOIRSE@gmail.com
Jane.Saoirse@gmail.com
JaneSaoirse+UID2@gmail.com
janesaoirse@gmail.comHashed: 92ee26057ed9dea2535d6c8b141d48373932476599196e00352254896db5888f
Base64-Encoded: ku4mBX7Z3qJTXWyLFB1INzkyR2WZGW4ANSJUiW21iI8=

Example Code

JavaScript でメールアドレスと電話のハッシュを生成する方法の例については、Example Code: Hashing and Base-64 Encoding を参照してください。