Da formato a los datos del usuario

La API de Data Manager admite la carga de varios tipos de datos de usuario. Sigue los requisitos de formato, hashing 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 a minúsculas.
Si la dirección de correo electrónico tiene el gmail.com o googlemail.com dominio, 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 de 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 formatearse y normalizarse a +18005550100.
Espacio en blanco Quita los espacios en blanco iniciales y finales.
Hashing Genera un hash con el algoritmo SHA-256. Codifica los bytes de hash con codificación hexadecimal o Base64.
address

Formato AddressInfo

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

AddressInfo
given_name
Formato
string
Convierte 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 de hash con codificación hexadecimal o Base64.
family_name
Formato
string
Convierte 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 de hash con codificación hexadecimal o Base64.
region_code
Formato
string
Un código ISO-3166-1 alfa-2 de dos caracteres.
Espacio en blanco Quita los espacios en blanco iniciales y finales.
Hashing No generes un hash para region_code.
postal_code
Formato
string
Se permite el uso tanto de códigos postales estadounidenses como internacionales.
Para 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 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 generes un hash para postal_code.

Requisitos de PairData

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

  1. Genera un hash en los datos de IIP proporcionados por la clean room con el algoritmo SHA-256.
  2. Encripta los bytes de hash con una clave de cifrado conmutativa EC 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 Timestamp campos, como timestamp y last_updated_timestamp de Event, usa el formato RFC 3339. Estos son 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 de la UTC en ese momento: 2025-08-08T13:18:44.291-04:00
  • Zona horaria PDT, que era 7 horas antes de la UTC en ese momento: 2025-08-08T10:18:44.291-07:00
  • Zona horaria de Tokio, Japón, que era 9 horas antes de la 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, configura los seconds y, de manera opcional, los nanos cuando crees el 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:

  • El uso de mayúsculas y minúsculas en el resultado de la codificación no es importante cuando se usa la codificación hexadecimal (hex).
  • El uso de mayúsculas y minúsculas en el resultado de la codificación es importante cuando se usa la codificación Base64.
Anterior
Configura destinos y encabezados
Siguiente
Encripte datos del usuario