Data Manager API では、複数の種類のユーザーデータのアップロードがサポートされています。データが正常に受信、処理されるように、各データ要素の形式、ハッシュ化、エンコードの要件に従ってください。
UserData オブジェクトは、UserIdentifier オブジェクトのコレクションです。各 UserIdentifier には、次の表の属性のいずれか 1 つが含まれます。
| UserIdentifier |
email_address |
| 形式 |
string
- 小文字に変換します。
- メールアドレスのドメインが
gmail.com または
googlemail.com の場合:
-
記号の前のすべてのドット（
.）を削除します。@
- ローカルパートからプラス記号（
+）を削除し、その後のすべての文字を削除します。
- 例:
cloudy.sanfrancisco+shopping@gmail.com →
cloudysanfrancisco@gmail.com
- メールアドレスのドメインが
gmail.com または googlemail.com 以外の場合は、ドットやプラス記号を削除しないでください。
- 例:
user.name+NYC@Example.com →
user.name+nyc@example.com
|
| 空白文字 |
先頭、末尾、中間にある空白文字を削除します。 |
| ハッシュ化 |
SHA-256 アルゴリズムを使用してハッシュ化します。
ハッシュ バイトを 16 進数または Base64 エンコードでエンコードします。
|
|
phone_number |
| 形式 |
string
プラス記号（+）と国
コードを含めます。プラス記号の後の文字はすべて数字にする必要があります。
たとえば、米国の電話番号
(800)555-0100
は、+18005550100にフォーマットして正規化する必要があります。
|
| 空白文字 |
先頭と末尾の空白文字を削除します。 |
| ハッシュ化 |
SHA-256 アルゴリズムを使用してハッシュ化します。
ハッシュ バイトを 16 進数または Base64 エンコードでエンコードします。
|
|
address |
|
次のフォーマット ガイドラインを使用して、UserIdentifier の address 属性を作成します。
| AddressInfo |
given_name |
| 形式 |
string
小文字に変換します。
Mrs. などの接頭辞は含めないでください。
|
| 空白文字 |
先頭と末尾の空白文字を削除します。 |
| ハッシュ化 |
SHA-256 アルゴリズムを使用してハッシュ化します。
ハッシュ バイトを 16 進数または Base64 エンコードでエンコードします。
|
|
family_name |
| 形式 |
string
小文字に変換します。
Jr. などの接尾辞は含めないでください。
|
| 空白文字 |
先頭と末尾の空白文字を削除します。 |
| ハッシュ化 |
SHA-256 アルゴリズムを使用してハッシュ化します。
ハッシュ バイトを 16 進数または Base64 エンコードでエンコードします。
|
|
region_code |
| 形式 |
string
|
| 空白文字 |
先頭と末尾の空白文字を削除します。 |
| ハッシュ化 |
region_code はハッシュ化しないでください。 |
|
postal_code |
| 形式 |
string
米国の郵便番号と国際郵便番号の両方を使用できます。
米国の住所の場合は、5 桁または 5 桁の後に
4 桁の拡張コードを使用します。4 桁の拡張コードを使用すると、一致率が向上する可能性があります
。
それ以外のすべての国については、郵便番号の拡張コード部分
は含めないでください。
|
| 空白文字 |
先頭と末尾の空白文字を削除します。 |
| ハッシュ化 |
postal_code はハッシュ化しないでください。 |
|
IpData オブジェクトには次の属性があります。
| IpData |
ip_address |
| 形式 |
string
IPv4 または IPv6 アドレス。
IPv6 アドレスでは、大文字と小文字は区別されません。
|
| 空白文字 |
先頭と末尾の空白文字を削除します。 |
| ハッシュ化 |
ip_address はハッシュ化しないでください。 |
|
PairData オブジェクトの pair_ids フィールドに ID のリストを入力します。
リスト内の各要素は、次の手順でフォーマットします。
- クリーンルームから提供された PII データを SHA-256 アルゴリズムを使用してハッシュ化します。
- PAIR ユーザーリストのパブリッシャー鍵を使用して、EC 可換暗号でハッシュ バイトを暗号化します。
- 暗号化されたデータを 16 進数または Base64 エンコードでエンコードします。
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: 1754683124nanos: 291000000
エンコード
データをエンコードする際は、次の点に留意してください。
