データ マネージャー API は、複数の種類のユーザーデータのアップロードをサポートしています。データが正常に受信され、処理されるように、各データ要素の形式、ハッシュ化、エンコードの要件に沿って対応してください。
UserData: ユーザーが提供したデータ（メールアドレス、電話番号など）。PairData: Publisher Advertiser Identity Reconciliation（PAIR）ID。MobileData: モバイル デバイスを特定するデータ。
UserData の要件
UserData オブジェクトは、UserIdentifier オブジェクトのコレクションです。各 UserIdentifier には、次の表の属性が 1 つだけ含まれます。
| UserIdentifier | |||||||
|---|---|---|---|---|---|---|---|
email_address |
|
||||||
phone_number |
|
||||||
address |
AddressInfo
オブジェクトAddressInfo 形式の仕様をご覧ください。 |
||||||
AddressInfo 形式
次の形式のガイドラインに沿って、UserIdentifier の address 属性を作成します。
| AddressInfo | |||||||
|---|---|---|---|---|---|---|---|
given_name |
|
||||||
family_name |
|
||||||
region_code |
|
||||||
postal_code |
|
||||||
PairData の要件
PairData オブジェクトの pair_ids フィールドに ID のリストを入力します。リスト内の各要素を次の手順で書式設定します。
- クリーンルームで提供された PII データを SHA-256 アルゴリズムを使用してハッシュ化します。
- PAIR ユーザーリストのパブリッシャー鍵を使用して、EC 可換暗号でハッシュバイトを暗号化します。
- 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:1754683124nanos:291000000
エンコード
データをエンコードする際は、次の点に注意してください。
- 16 進数エンコード（hex）を使用する場合、エンコード出力の大文字と小文字は区別されません。
- Base64 エンコードを使用する場合、エンコード出力の大文字と小文字は区別されます。