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 poszczególnych elementów 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
  • Przekształć 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 plusa.
    • Przykład: user.name+NYC@Example.com → user.name+nyc@example.com
Odstęp Usuń spacje na początku, na końcu i w środku ciągu.
Szyfrowanie Zaszyfruj je za pomocą algorytmu SHA-256. Zakoduj bajty skrótu za pomocą kodowania szesnastkowego lub Base64.
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 Stanach Zjednoczonych (800)555-0100 powinien być sformatowany i znormalizowany do postaci +18005550100.
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
Przekształć 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
Przekształć 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 dodawaj rozszerzeń kodu pocztowego.
Odstęp Usuń spacje na początku i na końcu ciągu.
Szyfrowanie Nie używaj hasha postal_code.
address_line
Format
string
Używane tylko w Google Analytics.
Ulica i numer adresu użytkownika.
Przekształć na małe litery.
usuwać znaki symboli;
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.
city
Format
string
Używane tylko w Google Analytics.
Miejscowość w adresie użytkownika.
Przekształć na małe litery.
usuwać znaki symboli;
Odstęp Usuń spacje na początku i na końcu ciągu.
Szyfrowanie Nie używaj hasha city.
administrative_area
Format
string
Używane tylko w Google Analytics.
Jednostka administracyjna (stan lub prowincja) w adresie użytkownika.
Użyj dwuliterowego skrótu (np. ca) lub pełnej nazwy (np. california).
Przekształć na małe litery.
usuwać znaki symboli;
Odstęp Usuń spacje na początku i na końcu ciągu.
Szyfrowanie Nie używaj hasha administrative_area.

Wymagania 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ć wielkich lub małych liter).
Odstęp Usuń spacje na początku i na końcu ciągu.
Szyfrowanie Nie używaj hasha ip_address.

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 cleanroom 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. Oto przykłady czasu UTC 8 sierpnia 2025 r. o godzinie 17:18:44.291 w formacie RFC 3339 i w różnych strefach czasowych:

  • Strefa czasowa UTC: 2025-08-08T17:18:44.291Z
  • strefa czasowa EDT, która w tym czasie była 4 godziny przed UTC: 2025-08-08T13:18:44.291-04:00
  • strefa czasowa PDT, która w tym czasie była 7 godzin przed UTC: 2025-08-08T10:18:44.291-07:00
  • Strefa czasowa Tokio w Japonii, która jest przesunięta o 9 godzin do przodu względem czasu 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

Podczas kodowania danych pamiętaj o tych kwestiach:

  • W przypadku kodowania szesnastkowego (hex) wielkość liter w danych wyjściowych kodowania nie ma znaczenia.
  • W przypadku kodowania Base64 ma znaczenie wielkość liter w danych wyjściowych kodowania.
Wstecz
Konfigurowanie miejsc docelowych i nagłówków
Dalej
Zaszyfruj dane użytkownika