Formatowanie danych użytkownika

Interfejs Data Manager API umożliwia przesyłanie różnych typów danych użytkowników. Postępuj zgodnie z wymaganiami dotyczącymi formatowania, haszowania i kodowania każdego elementu danych, aby dane zostały prawidłowo odebrane i przetworzone.

Wymagania UserData

Obiekt UserData to zbiór obiektów UserIdentifier. Każdy element UserIdentifier ma dokładnie jeden z atrybutów w tabeli poniżej.

UserIdentifier
email_address
Format
string
Konwertuj na małe litery.
Odstęp Usuń spacje na początku, na końcu i w środku.
Szyfrowanie Zaszyfruj je za pomocą algorytmu SHA-256. Zakoduj bajty skrótu za pomocą kodowania szesnastkowego lub Base64.
phone_number
Format
string
Dołącz znak plusa (+) i kod kraju.
Odstęp usuń spacje na początku i na końcu ciągu,
Szyfrowanie Zaszyfruj je za pomocą algorytmu SHA-256. Zakoduj bajty skrótu za pomocą kodowania szesnastkowego lub Base64.
address

Format: AddressInfo

Aby utworzyć atrybut address elementu UserIdentifier, postępuj zgodnie z tymi wytycznymi dotyczącymi formatowania.

AddressInfo
given_name
Format
string
Konwertuj na małe litery.
Nie dodawaj prefiksów, takich jak Mrs.
Odstęp usuń spacje na początku i na końcu ciągu,
Szyfrowanie Zaszyfruj je za pomocą algorytmu SHA-256. Zakoduj bajty skrótu za pomocą kodowania szesnastkowego lub Base64.
family_name
Format
string
Konwertuj na małe litery.
Nie dodawaj sufiksów, takich jak Jr.
Odstęp usuń spacje na początku i na końcu ciągu,
Szyfrowanie Zaszyfruj je za pomocą algorytmu SHA-256. Zakoduj bajty skrótu za pomocą kodowania szesnastkowego lub Base64.
region_code
Format
string
Dwuznakowy kod ISO-3166-1 alfa-2.
Odstęp usuń spacje na początku i na końcu ciągu,
Szyfrowanie Nie używaj hasha region_code.
postal_code
Format
string
Dopuszczalne są zarówno amerykańskie, jak i międzynarodowe kody pocztowe.
W przypadku adresów w Stanach Zjednoczonych użyj 5 cyfr lub 5 cyfr, po których następuje 4-cyfrowe rozszerzenie. Użycie 4-cyfrowego rozszerzenia może poprawić współczynnik dopasowania.
W przypadku wszystkich innych krajów nie używaj rozszerzeń kodu pocztowego.
Odstęp usuń spacje na początku i na końcu ciągu,
Szyfrowanie Nie używaj hasha postal_code.

Wymagania PairData

Wypełnij pole pair_ids obiektu PairData listą identyfikatorów. Sformatuj każdy element na liście, wykonując te czynności:

  1. Zahaszuj dane umożliwiające identyfikację udostępnione przez clean room za pomocą algorytmu SHA-256.
  2. Zaszyfruj bajty skrótu za pomocą przemiennego szyfru EC przy użyciu klucza wydawcy na potrzeby listy użytkowników PAIR.
  3. Zakoduj zaszyfrowane dane za pomocą kodowania szesnastkowego lub Base64.

Wymagania MobileData

Wypełnij pole mobile_ids obiektu MobileData listą identyfikatorów urządzeń mobilnych. Nie szyfruj identyfikatorów urządzeń mobilnych.

Format sygnatury czasowej

Jeśli używasz formatu JSON w przypadku pól Timestamp, takich jak timestamp i last_updated_timestamp w Event, użyj formatu RFC 3339.

Jeśli używasz formatu bufora protokołu, podczas tworzenia klasy Timestamp ustaw wartość seconds i opcjonalnie nanos.

Dalsze kroki