Data Manager API는 여러 유형의 사용자 데이터 업로드를 지원합니다. 데이터가 수신되고 성공적으로 처리되도록 각 데이터 요소의 형식 지정, 해싱, 인코딩 요구사항을 따르세요.
UserData: 이메일 주소 또는 전화번호와 같이 사용자가 제공한 데이터입니다.PairData: 게시자 광고주 ID 조정 (PAIR) ID입니다.MobileData: 모바일 기기를 식별하는 데이터입니다.
UserData 요구사항
A UserData 객체는 UserIdentifier 객체의 모음입니다. 각 UserIdentifier에는 다음 표의 속성 중 하나가 정확히 포함됩니다.
| UserIdentifier | |||||||
|---|---|---|---|---|---|---|---|
email_address |
|
||||||
phone_number |
|
||||||
address |
AddressInfo
객체 |
||||||
AddressInfo 형식
다음 형식 지정 가이드라인을 사용하여 UserIdentifier의 address 속성을 구성합니다.
| AddressInfo | |||||||
|---|---|---|---|---|---|---|---|
given_name |
|
||||||
family_name |
|
||||||
region_code |
|
||||||
postal_code |
|
||||||
PairData 요구사항
ID 목록으로 PairData 객체의 pair_ids 필드를 채웁니다.
다음 단계에 따라 목록의 각 요소 형식을 지정합니다.
- SHA-256 알고리즘을 사용하여 클린룸에서 제공한 PII 데이터를 해싱합니다.
- PAIR 사용자 목록의 게시자 키를 사용하여 EC 가환 암호로 해시 바이트를 암호화합니다.
- 16진수 또는 Base64 인코딩을 사용하여 암호화된 데이터를 인코딩합니다.
MobileData 요구사항
모바일 ID 목록으로 MobileData 객체의 mobile_ids 필드를 채웁니다. 모바일 ID를 해싱하지 마세요.
타임스탬프 형식
Event의
timestamp 및 last_updated_timestamp와 같은 Timestamp 필드에 JSON 형식을 사용하는 경우 RFC
3339 형식을 사용합니다. 다음은 RFC 3339 형식과 다양한 시간대의 2025년 8월 8일 오후 5시 18분 44.291초의 UTC 시간 예입니다.
- 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)을 사용하는 경우 인코딩 출력의 대소문자는 중요하지 않습니다. 16진수 인코딩 (hex).
- Base64 인코딩을 사용하는 경우 인코딩 출력의 대소문자가 중요합니다.