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.
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:
cloudy.sanfrancisco+shopping@gmail.com →
cloudysanfrancisco@gmail.com
- Se l'indirizzo email ha un dominio diverso da
gmail.com o googlemail.com, non
rimuovere punti o segni più.
- Esempio:
user.name+NYC@Example.com →
user.name+nyc@example.com
|
| Spazio vuoto |
Taglia gli spazi vuoti iniziali, finali e intermedi. |
| Hashing |
Esegui l'hashing utilizzando l'algoritmo SHA-256.
Codifica i byte dell'hash utilizzando la codifica esadecimale o Base64.
|
|
phone_number |
| Formato |
string
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 dell'hash utilizzando la codifica esadecimale o Base64.
|
|
address |
|
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 dell'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 dell'hash utilizzando la codifica esadecimale o Base64.
|
|
region_code |
| Formato |
string
|
| Spazio vuoto |
Taglia 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 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 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 caratteri dei simboli.
|
| Spazio vuoto |
Taglia gli spazi vuoti iniziali e finali. |
| Hashing |
Esegui l'hashing utilizzando l'algoritmo SHA-256.
Codifica i byte dell'hash utilizzando la codifica esadecimale o Base64.
|
|
city |
| Formato |
string
Utilizzato solo per Google Analytics.
La città indicata nell'indirizzo dell'utente.
Converti in minuscolo.
Rimuovi i caratteri dei simboli.
|
| Spazio vuoto |
Taglia gli spazi vuoti iniziali e finali. |
| 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 caratteri dei simboli.
|
| Spazio vuoto |
Taglia gli spazi vuoti iniziali e finali. |
| Hashing |
Non eseguire l'hashing di administrative_area. |
|
Un oggetto IpData ha i seguenti attributi.
| IpData |
ip_address |
| Formato |
string
Indirizzo IPv4 o IPv6.
Per gli indirizzi IPv6, la distinzione tra maiuscole e minuscole non è importante (possono essere utilizzate sia le maiuscole che le minuscole).
|
| Spazio vuoto |
Taglia gli spazi vuoti iniziali e finali. |
| Hashing |
Non eseguire l'hashing di ip_address. |
|
Compila il campo pair_ids di un oggetto PairData con un elenco di ID.
Formatta ogni elemento dell'elenco seguendo questi passaggi:
- Esegui l'hashing dei dati PII forniti dalla cleanroom utilizzando l'algoritmo SHA-256.
- Cripta i byte hash con una cifratura commutativa EC utilizzando la chiave del publisher
per l'elenco utenti PAIR.
- Codifica i dati criptati utilizzando la codifica esadecimale o Base64.
Compila il campo mobile_ids di un oggetto MobileData con un elenco di
ID mobile. Non eseguire l'hashing degli ID
mobile.
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 era 9 ore avanti rispetto al fuso orario UTC e non osservava
l'ora legale:
2025-08-08T22:18:44.291+09:00
Se utilizzi il formato buffer di protocollo, 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: 1754683124nanos: 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 utilizzi la
codifica esadecimale (hex).
- La distinzione tra maiuscole e minuscole dell'output di codifica è importante quando si utilizza la codifica
Base64.
