ユーザーデータのフォーマット

Data Manager API は、複数種類のユーザーデータのアップロードをサポートしています。各データ要素の形式設定、ハッシュ化、エンコードの要件に従って、データが正常に受信および処理されるようにします。

UserData の要件

UserData オブジェクトは、UserIdentifier オブジェクトのコレクションです。各 UserIdentifier には、次の表の属性を 1 つだけ指定します。

UserIdentifier
email_address
形式
string
小文字に変換します。
空白文字 先頭、末尾、中間の空白文字を削除します。
ハッシュ化 SHA-256 アルゴリズムを使用してハッシュ化します。ハッシュバイトを 16 進数または Base64 エンコードでエンコードします。
phone_number
形式
string
E.164 形式を使用します。
プラス記号（+）と国コードを含めてください。
空白文字 先頭と末尾の空白文字を削除します。
ハッシュ化 SHA-256 アルゴリズムを使用してハッシュ化します。ハッシュバイトを 16 進数または Base64 エンコードでエンコードします。
address
AddressInfo オブジェクト
AddressInfo 形式の仕様をご覧ください。

AddressInfo 形式

UserIdentifier の address 属性を作成するには、次の形式のガイドラインを使用します。

AddressInfo
given_name
形式
string
小文字に変換します。
Mrs. などの接頭辞は含めないでください。
空白文字 先頭と末尾の空白文字を削除します。
ハッシュ化 SHA-256 アルゴリズムを使用してハッシュ化します。ハッシュバイトを 16 進数または Base64 エンコードでエンコードします。
family_name
形式
string
小文字に変換します。
Jr. などの接尾辞は含めないでください。
空白文字 先頭と末尾の空白文字を削除します。
ハッシュ化 SHA-256 アルゴリズムを使用してハッシュ化します。ハッシュバイトを 16 進数または Base64 エンコードでエンコードします。
region_code
形式
string
2 文字の ISO-3166-1 alpha-2 コード。
空白文字 先頭と末尾の空白文字を削除します。
ハッシュ化 region_code をハッシュしないでください。
postal_code
形式
string
米国の郵便番号と国際郵便番号の両方を使用できます。
米国の住所の場合は、5 桁または 5 桁の後に 4 桁の番号を追加します。4 桁の拡張コードを使用すると、一致率が向上する可能性があります。
それ以外の国では、郵便番号の拡張コードを使用しないでください。
空白文字 先頭と末尾の空白文字を削除します。
ハッシュ化 postal_code をハッシュしないでください。

PairData の要件

PairData オブジェクトの pair_ids フィールドに ID のリストを入力します。リスト内の各要素を次の手順でフォーマットします。

  1. クリーンルームで提供された PII データを SHA-256 アルゴリズムを使用してハッシュ化します。
  2. PAIR ユーザーリストのパブリッシャー鍵を使用して、EC 交換暗号でハッシュバイトを暗号化します。
  3. 暗号化されたデータを 16 進数または Base64 エンコードでエンコードします。

MobileData の要件

MobileData オブジェクトの mobile_ids フィールドに、モバイル ID のリストを入力します。モバイル ID をハッシュ化しないでください。

次のステップ