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.
Si la dirección de correo electrónico tiene el dominio gmail.com o googlemail.com, quita todos los puntos (.) antes del símbolo @.
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
Usa el formato E.164.
Incluye el signo más (+) y el código de país. Todos los caracteres después del signo más deben ser dígitos.
Por ejemplo, el número de teléfono de EE.UU. (800)555-0100 debe tener el formato y la normalización de +18005550100.
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

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 apliques codificación hash a 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. A continuación, se muestran algunos ejemplos de la hora UTC del 8 de agosto de 2025 a las 5:18:44.291 p.m. en el formato RFC 3339 y en diferentes zonas horarias:

  • Zona horaria UTC: 2025-08-08T17:18:44.291Z
  • Zona horaria EDT, que era 4 horas antes del UTC en ese momento: 2025-08-08T13:18:44.291-04:00
  • Zona horaria PDT, que era 7 horas antes de UTC en ese momento: 2025-08-08T10:18:44.291-07:00
  • Zona horaria de Tokio, Japón, que estaba 9 horas adelantada respecto del UTC y no observa el horario de verano: 2025-08-08T22:18:44.291+09:00

Si usas el formato de búfer de protocolo, establece seconds y, de forma opcional, nanos cuando construyas Timestamp. Estos son los valores de seconds y nanos para la hora UTC del 8 de agosto de 2025 a las 5:18:44.291 p.m.:

  • seconds: 1754683124
  • nanos: 291000000

Codificación

Ten en cuenta lo siguiente cuando codifiques datos:

Siguiente
Encripte datos del usuario