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.
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
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 y entre palabras. |
| Hashing |
Genera un hash con el algoritmo SHA-256.
Codifica los bytes de hash con codificación hexadecimal o Base64.
|
|
phone_number |
| Formato |
string
Utiliza 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 |
|
Usa los siguientes lineamientos de formato para crear 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.
Codifica los bytes de hash con codificación hexadecimal o Base64.
|
|
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.
Codifica los bytes de hash con codificación hexadecimal o Base64.
|
|
region_code |
| Formato |
string
|
| 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 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 generes un hash para postal_code. |
|
address_line |
| Formato |
string
Se usa solo para Google Analytics.
La calle y el número de la dirección del usuario
Convertir a minúsculas
Quita los caracteres simbólicos.
|
| 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.
|
|
city |
| Formato |
string
Se usa solo para Google Analytics.
La ciudad de la dirección del usuario
Convertir a minúsculas
Quita los caracteres simbólicos.
|
| Espacio en blanco |
Quita los espacios en blanco iniciales y finales. |
| Hashing |
No generes un hash para city. |
|
administrative_area |
| Formato |
string
Se usa solo para Google Analytics.
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 simbólicos.
|
| Espacio en blanco |
Quita los espacios en blanco iniciales y finales. |
| Hashing |
No generes un hash para administrative_area. |
|
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. |
|
Propaga el campo pair_ids de un objeto PairData con una lista de IDs.
Para formatear cada elemento de la lista, sigue estos pasos:
- Genera un hash en los datos de IIP proporcionados por la clean room con el algoritmo SHA-256.
- Encripta los bytes de hash con un cifrado conmutativo EC 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 un hash para los IDs de dispositivos móviles.
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: 1754683124nanos: 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.
