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.

• UserData: dati forniti dagli utenti, ad esempio un indirizzo email o un numero di telefono.

• IpData: dati IP, come un indirizzo IP e i timestamp associati.

• PairData: ID Publisher Advertiser Identity Reconciliation (PAIR).

• MobileData: dati che identificano un dispositivo mobile.

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 @. Rimuovi il segno più (+) dalla parte locale e tutti i caratteri che lo seguono. Esempio: [e-mail] → [e-mail] Se l'indirizzo email ha un dominio diverso da gmail.com o googlemail.com, non rimuovere i punti o i segni più. Esempio: [e-mail] → [e-mail] Spazio vuoto Taglia gli spazi vuoti iniziali, finali e intermedi. Hashing Esegui l'hashing utilizzando l'algoritmo SHA-256 e codifica i byte dell'hash.
phone_number	Formato string Utilizza il formato E.164. Includi il segno Più (+) e il prefisso internazionale. Tutti i caratteri dopo il segno più devono essere cifre. Ad esempio, il numero di telefono statunitense [phone] deve essere formattato e normalizzato in [phone]. Spazio vuoto Taglia lo spazio vuoto iniziale e finale. Hashing Esegui l'hashing utilizzando l'algoritmo SHA-256 e codifica i byte dell'hash.
address	Oggetto AddressInfo Consulta la specifica del formato AddressInfo.

Formato AddressInfo

Utilizza le seguenti linee guida di 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 lo spazio vuoto iniziale e finale. Hashing Esegui l'hashing utilizzando l'algoritmo SHA-256 e codifica i byte dell'hash.
family_name	Formato string Converti in minuscolo. Non includere suffissi come Jr. Spazio vuoto Taglia lo spazio vuoto iniziale e finale. Hashing Esegui l'hashing utilizzando l'algoritmo SHA-256 e codifica i byte dell'hash.
region_code	Formato string Un codice ISO-3166-1 alpha-2 di due caratteri. Spazio vuoto Taglia lo spazio vuoto iniziale e finale. 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 degli Stati Uniti, utilizza 5 cifre o 5 cifre seguite da un'estensione di 4 cifre. L'utilizzo di un'estensione a 4 cifre potrebbe migliorare il tasso di corrispondenza. Per tutti gli altri paesi, non utilizzare le estensioni del codice postale. Spazio vuoto Taglia lo spazio vuoto iniziale e finale. Hashing Non eseguire l'hashing di postal_code.
address_line	Formato string Utilizzato solo per Google Analytics. La via e il numero civico dell'indirizzo dell'utente. Converti in minuscolo. Rimuovi i simboli. Spazio vuoto Taglia lo spazio vuoto iniziale e finale. Hashing Esegui l'hashing utilizzando l'algoritmo SHA-256 e codifica i byte dell'hash.
city	Formato string Utilizzato solo per Google Analytics. La città indicata nell'indirizzo dell'utente. Converti in minuscolo. Rimuovi i simboli. Spazio vuoto Taglia lo spazio vuoto iniziale e finale. Hashing Non eseguire l'hashing di city.
administrative_area	Formato string Utilizzato solo per Google Analytics. L'area amministrativa (stato o provincia) dell'indirizzo dell'utente. Utilizza l'abbreviazione di due lettere (ad esempio ca) o il nome completo (ad esempio california). Converti in minuscolo. Rimuovi i simboli. Spazio vuoto Taglia lo spazio vuoto iniziale e finale. Hashing Non eseguire l'hashing di administrative_area.

Requisiti per IpData

Un oggetto IpData ha i seguenti attributi.

IpData
ip_address	Formato string Indirizzo IPv4 o IPv6. Per gli indirizzi IPv6, le maiuscole e le minuscole non sono importanti (è possibile utilizzare sia le maiuscole che le minuscole). Spazio vuoto Taglia lo spazio vuoto iniziale e finale. Hashing Non eseguire l'hashing di ip_address.

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 data clean room utilizzando l'algoritmo SHA-256.

2. Cripta i byte dell'hash con un algoritmo di crittografia commutativa EC utilizzando la chiave del publisher per l'elenco di 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 identità digitali. Non sottoporre ad hashing gli ID mobile.

Formato 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 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 era 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 del buffer di protocollo, imposta seconds e, facoltativamente, 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

I requisiti di codifica variano a seconda che i dati utente vengano criptati o meno:

• Dati utente non criptati:codifica i byte hash SHA-256 utilizzando la codifica esadecimale (hex) o la codifica Base64.

• Dati utente criptati:se cripti i dati utente, devi codificare in Base64 i byte di hash non elaborati prima della crittografia. La codifica esadecimale non è supportata per l'hash di pre-crittografia. Puoi quindi codificare il testo cifrato risultante utilizzando la codifica esadecimale o Base64.

Nota: il formato dell'output di codifica non è importante quando si utilizza la codifica esadecimale.