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.
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.
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 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 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.

Se utilizzi il formato Protocol Buffer, imposta seconds e, facoltativamente, nanos durante la creazione di Timestamp.

Passaggi successivi