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

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

• UserData: メールアドレスや電話番号など、ユーザー提供データ。
• IpData: IP アドレスや関連するタイムスタンプなどの IP データ。
• PairData: パブリッシャー広告主 ID 照合（PAIR）ID。
• MobileData: モバイル デバイスを識別するデータ。

UserData の要件

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

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

IpData の要件

IpData オブジェクトには次の属性があります。

IpData
ip_address	形式 string IPv4 または IPv6 アドレス。 IPv6 アドレスの場合、大文字と小文字は区別されません（大文字と小文字のどちらでも使用できます）。 空白文字 先頭と末尾の空白文字を削除します。 ハッシュ化 ip_address はハッシュ化しないでください。

PairData の要件

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

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

MobileData の要件

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

タイムスタンプの形式

Event の timestamp や last_updated_timestamp など、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 エンコードを使用する場合、エンコード出力の大文字と小文字は区別されます。Base64 エンコード