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 dati vengano ricevuti ed elaborati correttamente.

Requisiti di 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 gmail.com o googlemail.com dominio, rimuovi tutti i punti (.) prima del simbolo @.
Spazio vuoto Rimuovi gli spazi vuoti iniziali, finali e intermedi.
Hashing Esegui l'hashing utilizzando l'algoritmo SHA-256. Codifica i byte di 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 Rimuovi gli spazi vuoti iniziali e finali.
Hashing Esegui l'hashing utilizzando l'algoritmo SHA-256. Codifica i byte di 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'address attributo di un UserIdentifier.

AddressInfo
given_name
Formato
string
Converti in minuscolo.
Non includere prefissi come Mrs..
Spazio vuoto Rimuovi gli spazi vuoti iniziali e finali.
Hashing Esegui l'hashing utilizzando l'algoritmo SHA-256. Codifica i byte di hash utilizzando la codifica esadecimale o Base64.
family_name
Formato
string
Converti in minuscolo.
Non includere suffissi come Jr.
Spazio vuoto Rimuovi gli spazi vuoti iniziali e finali.
Hashing Esegui l'hashing utilizzando l'algoritmo SHA-256. Codifica i byte di hash utilizzando la codifica esadecimale o Base64.
region_code
Formato
string
Un codice alfa-2 ISO-3166-1 di due caratteri.
Spazio vuoto Rimuovi gli spazi vuoti iniziali e finali.
Hashing Non eseguire l'hashing di region_code.
postal_code
Formato
string
Sono consentiti i codici postali internazionali e 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 di 4 cifre può migliorare il tasso di corrispondenza.
Per tutti gli altri paesi, non utilizzare le estensioni del codice postale.
Spazio vuoto Rimuovi gli spazi vuoti iniziali e finali.
Hashing Non eseguire l'hashing di postal_code.

Requisiti di 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 clean room utilizzando l'algoritmo SHA-256.
  2. Cripta i byte di hash con una crittografia commutativa EC utilizzando la chiave del publisher per l'elenco utenti PAIR.
  3. Codifica i dati criptati utilizzando la codifica esadecimale o Base64.

Requisiti di 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. Ecco alcuni esempi dell'ora UTC dell'8 agosto 2025 alle 17:18:44.291 nel formato RFC 3339 e in diversi fusi orari:

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

Se utilizzi il formato del buffer di protocollo, imposta seconds e, facoltativamente, il nanos durante la creazione di Timestamp. Ecco i valori 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:

  • Quando si utilizza la codifica esadecimale (hex), la distinzione tra maiuscole e minuscole dell'output di codifica non ha importanza.
  • Quando si utilizza la codifica Base64 encoding, la distinzione tra maiuscole e minuscole dell'output di codifica ha importanza.
Indietro
Configura destinazioni e intestazioni
Avanti
Cripta i dati utente