Da formato a los datos del usuario

La API de Data Manager admite la carga de varios tipos de datos del usuario. Sigue los requisitos de formato, hash y codificación para cada elemento de datos, de modo que tus datos se reciban y procesen correctamente.

Requisitos de UserData

Un objeto UserData es una colección de objetos UserIdentifier. Cada UserIdentifier tiene exactamente uno de los atributos de la siguiente tabla.

UserIdentifier
email_address
Formato
string
Convierte el texto a minúsculas.
Espacio en blanco Quita los espacios en blanco iniciales, finales e intermedios.
Hashing Genera un hash con el algoritmo SHA-256. Codifica los bytes del hash con codificación hexadecimal o Base64.
phone_number
Formato
string
Incluye el signo más (+) y el código de país.
Espacio en blanco Quita los espacios en blanco iniciales y finales.
Hashing Genera un hash con el algoritmo SHA-256. Codifica los bytes del hash con codificación hexadecimal o Base64.
address
Objeto AddressInfo
Consulta la especificación del formato de AddressInfo.

Formato AddressInfo

Usa los siguientes lineamientos de formato para crear el atributo address de un UserIdentifier.

AddressInfo
given_name
Formato
string
Convierte el texto a minúsculas.
No incluyas prefijos como Mrs..
Espacio en blanco Quita los espacios en blanco iniciales y finales.
Hashing Genera un hash con el algoritmo SHA-256. Codifica los bytes del hash con codificación hexadecimal o Base64.
family_name
Formato
string
Convierte el texto a minúsculas.
No incluyas sufijos como Jr..
Espacio en blanco Quita los espacios en blanco iniciales y finales.
Hashing Genera un hash con el algoritmo SHA-256. Codifica los bytes del hash con codificación hexadecimal o Base64.
region_code
Formato
string
Es un código ISO-3166-1 alfa-2 de dos caracteres.
Espacio en blanco Quita los espacios en blanco iniciales y finales.
Hashing No apliques hash a region_code.
postal_code
Formato
string
Se permite el uso tanto de códigos postales estadounidenses como internacionales.
En el caso de las direcciones de EE.UU., usa 5 dígitos o 5 dígitos seguidos de una extensión de 4 dígitos. Usar una extensión de 4 dígitos puede mejorar tu porcentaje de coincidencias.
Para todos los demás países, no uses extensiones de códigos postales.
Espacio en blanco Quita los espacios en blanco iniciales y finales.
Hashing No apliques hash a postal_code.

Requisitos de PairData

Propaga el campo pair_ids de un objeto PairData con una lista de IDs. Para dar formato a cada elemento de la lista, sigue estos pasos:

  1. Genera un hash para los datos de PII proporcionados por la sala limpia con el algoritmo SHA-256.
  2. Encripta los bytes del hash con un cifrado conmutativo de CE usando la clave del publicador para la lista de usuarios de PAIR.
  3. Codifica los datos encriptados con codificación hexadecimal o Base64.

Requisitos de MobileData

Propaga el campo mobile_ids de un objeto MobileData con una lista de IDs de dispositivos móviles. No generes un hash para los IDs de dispositivos móviles.

Formato de marca de tiempo

Si usas el formato JSON para los campos Timestamp, como timestamp y last_updated_timestamp de Event, usa el formato RFC 3339.

Si usas el formato de búfer de protocolo, establece seconds y, de forma opcional, nanos cuando construyas Timestamp.

Próximos pasos