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, codificación y hash para cada elemento de datos, de modo que tus datos se reciban y procesen correctamente.

• UserData: Son los datos proporcionados por el usuario, como una dirección de correo electrónico o un número de teléfono.

• IpData: Son los datos de IP, como una dirección IP y las marcas de tiempo asociadas.

• PairData: IDs de Conciliación de Identidades de Publicador y Anunciante (PAIR).

• MobileData: Son datos que identifican un dispositivo móvil.

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 Convertir a minúsculas Si la dirección de correo electrónico tiene el dominio gmail.com o googlemail.com, haz lo siguiente: 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: [e-mail] → [e-mail] 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: [e-mail] → [e-mail] Espacio en blanco Recorta los espacios en blanco iniciales, finales y entre palabras. Hashing Genera un hash con el algoritmo SHA-256 y codifica los bytes del hash.
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. [phone] debe tener el formato y la normalización [phone]. Espacio en blanco Quita los espacios en blanco iniciales y finales. Hashing Genera un hash con el algoritmo SHA-256 y codifica los bytes del hash.
address	Objeto AddressInfo Consulta la especificación de formato de AddressInfo.

Formato AddressInfo

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

AddressInfo
given_name	Formato string Convertir 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 y codifica los bytes del hash.
family_name	Formato string Convertir 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 y codifica los bytes del hash.
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 uses 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 todos los demás países, no uses extensiones de código postal. Espacio en blanco Quita los espacios en blanco iniciales y finales. Hashing No uses el algoritmo hash para postal_code.
address_line	Formato string Solo se usa para Google Analytics. La calle y el número de la dirección del usuario. Convertir a minúsculas Quita los caracteres de símbolos. Espacio en blanco Quita los espacios en blanco iniciales y finales. Hashing Genera un hash con el algoritmo SHA-256 y codifica los bytes del hash.
city	Formato string Se usa solo para Google Analytics. Es la ciudad de la dirección del usuario. Convertir a minúsculas Quita los caracteres de símbolos. Espacio en blanco Quita los espacios en blanco iniciales y finales. Hashing No uses un hash para city.
administrative_area	Formato string Solo se usa para Google Analytics. Es el área administrativa (estado o provincia) de la dirección del usuario. Usa la abreviatura de dos letras (por ejemplo, ca) o el nombre completo (por ejemplo, california). Convertir a minúsculas Quita los caracteres de símbolos. Espacio en blanco Quita los espacios en blanco iniciales y finales. Hashing No uses el algoritmo hash para administrative_area.

Requisitos de IpData

Un objeto IpData tiene los siguientes atributos.

IpData
ip_address	Formato string Dirección IPv4 o IPv6. En el caso de las direcciones IPv6, no importa si se usan mayúsculas o minúsculas. Espacio en blanco Quita los espacios en blanco iniciales y finales. Hashing No uses un hash para ip_address.

Requisitos de PairData

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

1. Genera un hash para los datos de IIP proporcionados por la sala limpia con el algoritmo SHA-256.

2. Encripta los bytes de hash con un algoritmo de cifrado conmutativo de EC usando la clave del publicador para la lista de usuarios de PAIR.

3. Codifica los datos encriptados con la 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. 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 estaba 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 estaba 9 horas por delante 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 el seconds y, de forma opcional, el nanos cuando construyas el Timestamp. Estos son los valores 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

Los requisitos de codificación varían según si encriptas los datos del usuario:

• Datos del usuario sin encriptar: Codifica los bytes de hash SHA-256 con la codificación hexadecimal (hex) o la codificación Base64.

• Datos del usuario encriptados: Si encriptas los datos del usuario, debes codificar en Base64 los bytes de hash sin procesar antes de la encriptación. No se admite la codificación hexadecimal para el hash previo a la encriptación. Luego, puedes codificar el texto cifrado resultante con la codificación hexadecimal o Base64.

Nota: El uso de mayúsculas o minúsculas en el resultado de la codificación no importa cuando se usa la codificación hexadecimal.