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.
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.
- 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 |
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 |
|
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 |
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
|
| 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. |
|
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 simbolo.
|
| 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.
|
|
city |
| Formato |
string
Utilizzato solo per Google Analytics.
La città indicata nell'indirizzo dell'utente.
Converti in minuscolo.
Rimuovi i caratteri simbolo.
|
| Spazio vuoto |
Rimuovi 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 es. ca) o
il nome completo (ad es. california).
Converti in minuscolo.
Rimuovi i caratteri simbolo.
|
| Spazio vuoto |
Rimuovi gli spazi vuoti iniziali e finali. |
| Hashing |
Non eseguire l'hashing di administrative_area. |
|
Un IpData oggetto ha i seguenti attributi.
| IpData |
ip_address |
| Formato |
string
Indirizzo IPv4 o IPv6.
Per gli indirizzi IPv6, le maiuscole/minuscole non fanno differenza (puoi utilizzare maiuscole o minuscole).
|
| Spazio vuoto |
Rimuovi 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 clean room utilizzando l'algoritmo SHA-256.
- Cripta i byte di hash con una crittografia 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. 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, 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: 1754683124nanos: 291000000
Codifica
Tieni presente quanto segue durante la codifica dei dati:
- Le maiuscole/minuscole dell'output di codifica non fanno differenza quando si utilizza la codifica
esadecimale (esadecimale).
- Le maiuscole/minuscole dell'output di codifica fanno differenza quando si utilizza la codifica Base64
encoding.
