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

データマネージャー API は、複数の種類のユーザーデータのアップロードをサポートしています。データが正常に受信され、処理されるように、各データ要素の形式、ハッシュ化、エンコードの要件に沿って対応してください。

UserData の要件

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

UserIdentifier
email_address
形式
string
小文字に変換します。
メールアドレスに gmail.com ドメインまたは googlemail.com ドメインが含まれている場合は、@ 記号の前のすべてのドット（.）を削除します。
空白文字 先頭、末尾、中間にある空白文字を削除します。
ハッシュ化 SHA-256 アルゴリズムを使用してハッシュ化します。16 進数または Base64 エンコードを使用してハッシュ バイトをエンコードします。
phone_number
形式
string
E.164 形式を使用します。
プラス記号（+）と国コードを含めてください。プラス記号の後の文字はすべて数字である必要があります。
たとえば、米国の電話番号 (800)555-0100 は、+18005550100 にフォーマットされ、正規化される必要があります。
空白文字 先頭と末尾の空白文字を削除します。
ハッシュ化 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 をハッシュ化しないでください。

タイムスタンプの形式

Timestamp フィールド（Event の timestamp や last_updated_timestamp など）に JSON 形式を使用する場合は、RFC 3339 形式を使用します。2025 年 8 月 8 日午後 5 時 18 分 44 秒 291 ミリ秒の UTC 時間の RFC 3339 形式とさまざまなタイムゾーンの例を次に示します。

  • UTC タイムゾーン: 2025-08-08T17:18:44.291Z
  • EDT タイムゾーン（当時は UTC の 4 時間前）: 2025-08-08T13:18:44.291-04:00
  • PDT タイムゾーン（当時の UTC の 7 時間前）: 2025-08-08T10:18:44.291-07:00
  • UTC より 9 時間進んでおり、夏時間を採用していない日本の東京のタイムゾーン: 2025-08-08T22:18:44.291+09:00

プロトコル バッファ形式を使用する場合は、Timestamp を構築するときに seconds と（必要に応じて）nanos を設定します。2025 年 8 月 8 日午後 5 時 18 分 44 秒 291 ミリ秒の UTC 時間の seconds と nanos の値は次のとおりです。

  • seconds: 1754683124
  • nanos: 291000000

エンコード

データをエンコードする際は、次の点に注意してください。

  • 16 進数エンコード（hex）を使用する場合、エンコード出力の大文字と小文字は区別されません。
  • Base64 エンコードを使用する場合、エンコード出力の大文字と小文字は区別されます。

次のステップ