Formattare i dati utente

L'API Data Manager supporta il caricamento di più tipi di dati utente. Segui i requisiti di formattazione, hashing e codifica per ogni elemento di dati in modo che i tuoi dati vengano ricevuti ed elaborati correttamente.

Requisiti per UserData

Un oggetto UserData è una raccolta di oggetti UserIdentifier. Ogni UserIdentifier ha esattamente uno degli attributi nella tabella seguente.

UserIdentifier
email_address
Formato
string
Converti in minuscolo.
Se l'indirizzo email ha il dominio gmail.com o googlemail.com, rimuovi tutti i punti (.) prima del simbolo @.
Spazio vuoto Taglia gli spazi vuoti iniziali, finali e intermedi.
Hashing Esegui l'hashing utilizzando l'algoritmo SHA-256. Codifica i byte hash utilizzando la codifica esadecimale o Base64.
phone_number
Formato
string
Utilizza il formato E.164.
Includi il segno più (+) e il codice paese. Tutti i caratteri dopo il segno più devono essere cifre.
Ad esempio, il numero di telefono statunitense (800)555-0100 deve essere formattato e normalizzato in +18005550100.
Spazio vuoto Taglia gli spazi vuoti iniziali e finali.
Hashing Esegui l'hashing utilizzando l'algoritmo SHA-256. Codifica i byte hash utilizzando la codifica esadecimale o Base64.
address
AddressInfo oggetto
Fai riferimento alla AddressInfo specifica del formato.

Formato AddressInfo

Utilizza le seguenti linee guida per la formattazione per creare l'attributo address di un UserIdentifier.

AddressInfo
given_name
Formato
string
Converti in minuscolo.
Non includere prefissi come Mrs.
Spazio vuoto Taglia gli spazi vuoti iniziali e finali.
Hashing Esegui l'hashing utilizzando l'algoritmo SHA-256. Codifica i byte hash utilizzando la codifica esadecimale o Base64.
family_name
Formato
string
Converti in minuscolo.
Non includere suffissi come Jr.
Spazio vuoto Taglia gli spazi vuoti iniziali e finali.
Hashing Esegui l'hashing utilizzando l'algoritmo SHA-256. Codifica i byte hash utilizzando la codifica esadecimale o Base64.
region_code
Formato
string
Un codice ISO-3166-1 alpha-2 di due caratteri.
Spazio vuoto Taglia gli spazi vuoti iniziali e finali.
Hashing Non usare l'hash region_code.
postal_code
Formato
string
Sono consentiti sia i codici postali internazionali che quelli degli Stati Uniti.
Per gli indirizzi statunitensi, utilizza 5 cifre o 5 cifre seguite da un'estensione di 4 cifre. L'utilizzo di un'estensione a 4 cifre può migliorare il tasso di corrispondenza.
Per tutti gli altri paesi, non utilizzare le estensioni del codice postale.
Spazio vuoto Taglia gli spazi vuoti iniziali e finali.
Hashing Non usare l'hash postal_code.

Requisiti per PairData

Compila il campo pair_ids di un oggetto PairData con un elenco di ID. Formatta ogni elemento dell'elenco seguendo questi passaggi:

  1. Esegui l'hashing dei dati PII forniti dalla cleanroom utilizzando l'algoritmo SHA-256.
  2. Cripta i byte hash con una cifratura commutativa EC utilizzando la chiave del publisher per l'elenco utenti PAIR.
  3. Codifica i dati criptati utilizzando la codifica esadecimale o Base64.

Requisiti per MobileData

Compila il campo mobile_ids di un oggetto MobileData con un elenco di ID mobile. Non eseguire l'hashing degli ID mobile.

Formato del timestamp

Se utilizzi il formato JSON per i campi Timestamp, come timestamp e last_updated_timestamp di Event, utilizza il formato RFC 3339. Di seguito sono riportati alcuni esempi dell'ora UTC dell'8 agosto 2025 alle 17:18:44.291 nel formato RFC 3339 e in fusi orari diversi:

  • Fuso orario UTC: 2025-08-08T17:18:44.291Z
  • Fuso orario EDT, che all'epoca era 4 ore prima dell'UTC: 2025-08-08T13:18:44.291-04:00
  • Fuso orario PDT, che all'epoca era 7 ore prima dell'UTC: 2025-08-08T10:18:44.291-07:00
  • Fuso orario di Tokyo, Giappone, che è 9 ore avanti rispetto al fuso orario UTC e non osserva l'ora legale: 2025-08-08T22:18:44.291+09:00

Se utilizzi il formato Protocol Buffer, imposta seconds e, facoltativamente, nanos durante la creazione di Timestamp. Ecco i valori di seconds e nanos per l'ora UTC dell'8 agosto 2025 alle 17:18:44.291:

  • seconds: 1754683124
  • nanos: 291000000

Codifica

Tieni presente quanto segue durante la codifica dei dati:

  • La distinzione tra maiuscole e minuscole dell'output di codifica non ha importanza quando si utilizza la codifica esadecimale (hex).
  • La distinzione tra maiuscole e minuscole nell'output di codifica è importante quando si utilizza la codifica Base64.

Passaggi successivi