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.
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
- Se convierte 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 quita 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 sea
gmail.com o 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 |
Recorta los espacios en blanco iniciales, finales y entre palabras. |
| 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. 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 normalizarse a +18005550100.
|
| Espacio en blanco |
Recorta 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 |
|
Usa los siguientes lineamientos de formato para crear el atributo address de un UserIdentifier.
| AddressInfo |
given_name |
| Formato |
string
Se convierte a minúsculas.
No incluyas prefijos como Mrs..
|
| Espacio en blanco |
Recorta 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
Se convierte a minúsculas.
No incluyas sufijos, como Jr..
|
| Espacio en blanco |
Recorta 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
|
| Espacio en blanco |
Recorta 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ódigo postal.
|
| Espacio en blanco |
Recorta los espacios en blanco iniciales y finales. |
| Hashing |
No apliques hash a postal_code. |
|
address_line |
| Formato |
string
Se usa solo para Google Analytics.
Calle y número de la dirección del usuario.
Se convierte a minúsculas.
Quita los caracteres de símbolos.
|
| Espacio en blanco |
Recorta 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.
|
|
city |
| Formato |
string
Se usa solo para Google Analytics.
Ciudad de la dirección del usuario
Se convierte a minúsculas.
Quita los caracteres de símbolos.
|
| Espacio en blanco |
Recorta los espacios en blanco iniciales y finales. |
| Hashing |
No apliques hash a city. |
|
administrative_area |
| Formato |
string
Se usa solo 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).
Se convierte a minúsculas.
Quita los caracteres de símbolos.
|
| Espacio en blanco |
Recorta los espacios en blanco iniciales y finales. |
| Hashing |
No apliques hash a administrative_area. |
|
Un objeto IpData tiene los siguientes atributos.
| IpData |
ip_address |
| Formato |
string
Es la 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 |
Recorta los espacios en blanco iniciales y finales. |
| Hashing |
No apliques hash a ip_address. |
|
Completa 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:
- Genera un hash para los datos de IIP proporcionados por la sala limpia con el algoritmo SHA-256.
- Encripta los bytes del hash con un cifrado conmutativo de CE usando la clave del publicador para la lista de usuarios de PAIR.
- Codifica los datos encriptados con codificación hexadecimal o Base64.
Propaga el campo mobile_ids de un objeto MobileData con una lista de IDs de dispositivos móviles. No generes hash para los IDs de dispositivos móviles.
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: 1754683124nanos: 291000000
Codificación
Ten en cuenta lo siguiente cuando codifiques datos:
