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.
    • Quita el signo más (+) de la parte local y todos los caracteres que le siguen.
    • Ejemplo: cloudy.sanfrancisco+shopping@gmail.com → cloudysanfrancisco@gmail.com
  • Si la dirección de correo electrónico tiene un dominio que no es gmail.com ni googlemail.com, no quites los puntos ni los signos más.
    • Ejemplo: user.name+NYC@Example.com → user.name+nyc@example.com
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.
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.
En el caso de 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 generes un hash para postal_code.

Requisitos de IpData

Un IpData objeto tiene los siguientes atributos.

IpData
ip_address
Formato
string
Dirección IPv4 o IPv6.
En el caso de las direcciones IPv6, no se distingue entre mayúsculas y minúsculas (se pueden usar ambas).
Espacio en blanco Quita los espacios en blanco iniciales y finales.
Hashing No generes un hash para ip_address.

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 para los datos de IIP proporcionados por la clean room con el algoritmo SHA-256.
  2. Encripta los bytes de hash con un cifrado conmutativo 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, establece 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:

  • No se distingue entre mayúsculas y minúsculas en el resultado de la codificación cuando se usa la codificación hexadecimal (hex).
  • _Sí_ se distingue entre mayúsculas y minúsculas en el resultado de la codificación cuando se usa la codificación Base64 encoding.
Anterior
Configura destinos y encabezados
Siguiente
Encripte datos del usuario