Formatowanie danych użytkownika

Interfejs Data Manager API obsługuje przesyłanie wielu typów danych użytkownika. Aby mieć pewność, że Twoje dane zostaną odebrane i poprawnie przetworzone, postępuj zgodnie z wymaganiami dotyczącymi formatowania, szyfrowania i kodowania każdego elementu danych.

Wymagania UserData

Obiekt UserData to kolekcja obiektów UserIdentifier. Każdy element UserIdentifier ma dokładnie 1 z tych atrybutów wymienionych w tabeli poniżej.

UserIdentifier
email_address
Format
string
Konwertuj na małe litery.
Odstęp Usuń spacje na początku, końcu i w środku ciągu znaków.
Haszowanie Skrót za pomocą algorytmu SHA-256. Zakoduj bajty hasz za pomocą kodowania heksadecymalnego lub Base64.
phone_number
Format
string
Dodaj znak plusa (+) i kod kraju.
Odstęp Usuń spacje na początku i na końcu ciągu.
Haszowanie Skrót za pomocą algorytmu SHA-256. Zakoduj bajty skrótu za pomocą kodowania heksadecymalnego lub Base64.
address
Zapoznaj się ze specyfikacją formatu AddressInfo.

Format: AddressInfo

Aby utworzyć atrybut address elementu UserIdentifier, zastosuj te wskazówki dotyczące 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.
Haszowanie Skrót za pomocą algorytmu SHA-256. Koduj bajty skrótu za pomocą kodowania heksadecymalnego lub Base64.
family_name
Format
string
Konwertuj na małe litery.
Nie używaj sufiksów, takich jak Jr.
Odstęp Usuń spacje na początku i na końcu ciągu.
Haszowanie Skrót za pomocą algorytmu SHA-256. Koduj bajty skrótu za pomocą kodowania heksadecymalnego 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.
Haszowanie Nie szyfruj za pomocą funkcji haszującej 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 i 4-cyfrowego rozszerzenia. 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.
Haszowanie Nie szyfruj za pomocą funkcji postal_code.

Wymagania PairData

Wypełnij pole pair_ids obiektu PairData listą identyfikatorów. Aby sformatować każdy element na liście, wykonaj te czynności:

  1. Zaszyfruj dane umożliwiające identyfikację przesłane przez czystą przestrzeń za pomocą algorytmu SHA-256.
  2. Szyfruj bajty hasha za pomocą szyfru komutacyjnego EC, używając klucza wydawcy na liście użytkowników PAIR.
  3. Zakoduj zaszyfrowane dane za pomocą kodowania heksadecymalnego lub Base64.

Wymagania MobileData

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

Dalsze kroki