Formatowanie danych użytkownika

Interfejs Data Manager API obsługuje przesyłanie wielu typów danych użytkownika. Przestrzegaj wymagań dotyczących formatowania, szyfrowania i kodowania każdego elementu danych, aby dane zostały prawidłowo odebrane i przetworzone.

Wymagania dotyczące UserData

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

UserIdentifier
email_address
Format
string
  • Zmień na małe litery.
  • Jeśli adres e-mail ma domenę gmail.com lub googlemail.com:
    • Usuń wszystkie kropki (.) przed symbolem @.
    • Usuń znak plusa (+) z części lokalnej i wszystkie znaki, które występują po nim.
    • Przykład: cloudy.sanfrancisco+shopping@gmail.com → cloudysanfrancisco@gmail.com
  • Jeśli adres e-mail ma domenę inną niż gmail.com lub googlemail.com, nie usuwaj kropek ani znaków plus.
    • Przykład: user.name+NYC@Example.com → user.name+nyc@example.com
Odstęp Usuń odstępy na początku, na końcu i w środku.
Haszowanie Zaszyfruj dane za pomocą algorytmu SHA-256 i zakoduj bajty haszowania.
phone_number
Format
string
Użyj formatu E.164.
Dołącz znak plusa (+) i kod kraju. Wszystkie znaki po znaku plus muszą być cyframi.
Na przykład numer telefonu w USA (800)555-0100 powinien być sformatowany i znormalizowany do postaci +18005550100.
Odstęp Usuń spacje na początku i na końcu.
Haszowanie Zaszyfruj dane za pomocą algorytmu SHA-256 i zakoduj bajty haszowania.
address

Format: AddressInfo

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

AddressInfo
given_name
Format
string
Zmień na małe litery.
Nie dodawaj prefiksów takich jak Mrs.
Odstęp Usuń spacje na początku i na końcu.
Haszowanie Zaszyfruj dane za pomocą algorytmu SHA-256 i zakoduj bajty haszowania.
family_name
Format
string
Zmień na małe litery.
Nie dodawaj sufiksów, takich jak Jr.
Odstęp Usuń spacje na początku i na końcu.
Haszowanie Zaszyfruj dane za pomocą algorytmu SHA-256 i zakoduj bajty haszowania.
region_code
Format
string
Dwuliterowy kod zgodny z normą ISO-3166-1 alpha-2.
Odstęp Usuń spacje na początku i na końcu.
Haszowanie Nie szyfruj 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 dodawaj rozszerzeń kodu pocztowego.
Odstęp Usuń spacje na początku i na końcu.
Haszowanie Nie szyfruj postal_code.
address_line
Format
string
Używane tylko w Google Analytics.
Ulica i numer domu użytkownika.
Zmień na małe litery.
Usuń symbole.
Odstęp Usuń spacje na początku i na końcu.
Haszowanie Zaszyfruj dane za pomocą algorytmu SHA-256 i zakoduj bajty haszowania.
city
Format
string
Używany tylko w Google Analytics.
Miejscowość w adresie użytkownika.
Zmień na małe litery.
Usuń symbole.
Odstęp Usuń spacje na początku i na końcu.
Haszowanie Nie szyfruj city.
administrative_area
Format
string
Używany tylko w Google Analytics.
Region (stan lub prowincja) w adresie użytkownika.
Użyj dwuliterowego skrótu (np. ca) lub pełnej nazwy (np. california).
Zmień na małe litery.
Usuń symbole.
Odstęp Usuń spacje na początku i na końcu.
Haszowanie Nie szyfruj administrative_area.

Wymagania dotyczące IpData

Obiekt IpData ma te atrybuty.

IpData
ip_address
Format
string
Adres IPv4 lub IPv6.
W przypadku adresów IPv6 wielkość liter nie ma znaczenia (można używać zarówno wielkich, jak i małych liter).
Odstęp Usuń spacje na początku i na końcu.
Haszowanie Nie szyfruj ip_address.

Wymagania dotyczące PairData

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

  1. Zaszyfruj dane umożliwiające identyfikację dostarczone przez centrum danych, korzystając z algorytmu SHA-256.

  2. Zaszyfruj bajty haszy za pomocą szyfru przemiennego EC, używając klucza wydawcy dla listy użytkowników PAIR.

  3. Zakoduj zaszyfrowane dane za pomocą kodowania szesnastkowego lub Base64.

Wymagania dotyczące MobileData

Wypełnij pole mobile_ids obiektu MobileData listą Mobile ID. 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. Oto kilka przykładów czasu UTC z 8 sierpnia 2025 r. o godzinie 17:18:44.291 w formacie RFC 3339 i różnych strefach czasowych:

  • Strefa czasowa UTC: 2025-08-08T17:18:44.291Z

  • Strefa czasowa EDT, która w tym czasie była o 4 godziny wcześniejsza niż UTC: 2025-08-08T13:18:44.291-04:00

  • strefa czasowa PDT, która w tym czasie była o 7 godzin wcześniejsza niż UTC: 2025-08-08T10:18:44.291-07:00

  • Strefa czasowa Tokio (Japonia), która jest o 9 godzin przed czasem UTC i nie uwzględnia czasu letniego: 2025-08-08T22:18:44.291+09:00

Jeśli używasz formatu bufora protokołu, podczas tworzenia Timestamp ustaw seconds i opcjonalnie nanos. Oto wartości seconds i nanos dla czasu UTC 8 sierpnia 2025 r. o godzinie 17:18:44.291:

  • seconds: 1754683124

  • nanos: 291000000

Kodowanie

Wymagania dotyczące kodowania różnią się w zależności od tego, czy szyfrujesz dane użytkownika:

Przepływy pracy kodowania

  • Niezaszyfrowane dane użytkownika: zakoduj bajty zaszyfrowane algorytmem SHA-256 za pomocą kodowania szesnastkowego (hex) lub kodowania Base64.

  • Zaszyfrowane dane użytkownika: jeśli szyfrujesz dane użytkownika, przed zaszyfrowaniem musisz zakodować nieprzetworzone bajty skrótu w formacie Base64. Kodowanie szesnastkowe nie jest obsługiwane w przypadku haszy przed szyfrowaniem. Następnie możesz zakodować wynikowy tekst szyfrowany za pomocą kodowania szesnastkowego lub Base64.

Wstecz
Konfigurowanie miejsc docelowych i nagłówków
Dalej
Zaszyfruj dane użytkownika