Parámetros de información del cliente

Los parámetros de información del cliente son un conjunto de identificadores de usuario que se comparten junto con la información de un evento. Para obtener más información sobre los parámetros obligatorios y recomendados, consulta Prácticas recomendadas de la API de conversiones: Enviar parámetros obligatorios y recomendados.

En la versión 13.0 de la API Graph se introdujeron nuevos requisitos relativos a las combinaciones de parámetros de información de clientes que se consideran válidas. Consulta las prácticas recomendadas para asegurarte de que las integraciones de la API de conversiones no se interrumpen.

Consulta la guía de uso de datos y privacidad de Meta para obtener información sobre los datos que se envían al utilizar la API de conversiones.

Nuestros sistemas están diseñados para no aceptar información del cliente que incluya datos de contacto que no se hayan cifrado con hash, excepto en los casos que se indican a continuación. La información de contacto es información de identificación personal, como nombres, direcciones de correo electrónico y números de teléfono, que usamos únicamente con el propósito de establecer coincidencias. Si utilizas el Meta Business SDK, la aplicación de algoritmos hash se realiza automáticamente.

Comparación del píxel

Puedes enviar muchos de los parámetros de información del cliente mediante el píxel de Meta, aunque algunos de ellos (client_user_agent, por ejemplo) se envían automáticamente como parte del funcionamiento de internet. Por ejemplo, para enviar el parámetro external_id mediante el píxel, debes usar el código siguiente:

fbq('init', 'PIXEL_ID', {'external_id': 12345});

Obtén información sobre los otros parámetros que puedes pasar con el píxel en la documentación de coincidencias avanzadas.

A la inversa, asegúrate de aplicar en el servidor el mismo conjunto de parámetros de información del cliente que el sistema comparte actualmente en el navegador.

Formato de los parámetros `user_data`

Debes proporcionar al menos uno de los siguientes parámetros user_data con el formato correcto en la solicitud.

Nota: Si usas la biblioteca del Administrador de parámetros, el formato contendrá un apéndice adicional al final de cada parámetro. Para obtener más información, consulta la página de la biblioteca del Administrador de parámetros.

Descarga este archivo CSV

para obtener ejemplos de datos cifrados con hash y normalizados correctamente para los parámetros siguientes.

Descargar (Haz clic con el botón derecho > Guardar enlace como)

Parámetro	Descripción
`em` Correo electrónico Cadena o lista <string>	Se requieren algoritmos hash. Elimina los espacios del principio y del final. Convierte todos los caracteres a minúsculas. Ejemplo: Entrada: John_Smith@gmail.com Formato normalizado: john_smith@gmail.com Salida esperada del algoritmo hash SHA256: 62a14e44f765419d10fea99367361a727c12365e2520f32218d505ed9aa0f62f
`ph` Número de teléfono Cadena o lista <string>	Se requieren algoritmos hash. Elimina los símbolos, las letras y los ceros del principio. Los números de teléfono deben incluir un código de país que se usará para establecer las coincidencias (p. ej., los números de teléfono de Estados Unidos deben ir precedidos del número 1). Incluye siempre el código de país en los números de teléfono de los clientes, aunque todos los datos pertenezcan al mismo país. Ejemplo: Entrada: número de teléfono de EE. UU. (650)555-1212 Formato normalizado: 16505551212 Salida esperada del algoritmo hash SHA256: e323ec626319ca94ee8bff2e4c87cf613be6ea19919ed1364124e16807ab3176
`fn` Nombre Cadena o lista <string>	Se requieren algoritmos hash. Se recomienda utilizar caracteres del alfabeto latino (a-z). Solo minúsculas, sin signos de puntuación. Si se usan caracteres especiales, el texto debe codificarse en formato UTF-8. Ejemplo: Entrada: Mary Formato normalizado: mary Salida esperada del algoritmo hash SHA256: 6915771be1c5aa0c886870b6951b03d7eafc121fea0e80a5ea83beb7c449f4ec Entrada: 정 Formato normalizado: carácter “정” en formato UTF-8 Salida esperada del algoritmo hash SHA256: 8fa8cd9c440be61d0151429310034083132b35975c4bea67fdd74158eb51db14 Entrada: Valéry Formato normalizado: valéry Salida esperada del algoritmo hash SHA256: 08e1996b5dd49e62a4b4c010d44e4345592a863bb9f8e3976219bac29417149c
`ln` Apellidos Cadena o lista <string>	Se requieren algoritmos hash. Se recomienda utilizar caracteres del alfabeto latino (a-z). Solo minúsculas, sin signos de puntuación. Si se usan caracteres especiales, el texto debe codificarse en formato UTF-8. Consulta Nombre (`fn`) para obtener ejemplos.
`db` Fecha de nacimiento Cadena o lista <string>	Se requieren algoritmos hash. Se acepta el formato AAAAMMDD para posibilitar un gran número de combinaciones de días, meses y años, con o sin puntuación. Año: usa el formato AAAA, desde 1900 hasta el año actual. Mes: usa el formato MM, de 01 a 12. Fecha: usa el formato DD, de 01 a 31. Ejemplo: Entrada: 16/02/1997 Formato normalizado: 19970216 Salida esperada del algoritmo hash SHA256: 01acdbf6ec7b4f478a225f1a246e5d6767eeab1a7ffa17f025265b5b94f40f0c
`ge` Género Cadena o lista <string>	Se requieren algoritmos hash. Se acepta el valor de género en forma de inicial en minúscula. Ejemplo: f para mujeres m para hombres
`ct` Ciudad Cadena o lista <string>	Se requieren algoritmos hash. Se recomienda utilizar caracteres del alfabeto latino (a-z). Solo minúsculas y sin signos de puntuación, caracteres especiales ni espacios. Si se usan caracteres especiales, el texto debe codificarse en formato UTF-8. Ejemplo: paris london newyork
`st` Estado Cadena o lista <string>	Se requieren algoritmos hash. Utiliza el código de abreviatura ANSI de dos caracteres en minúsculas. Normaliza los estados de fuera de EE. UU. en minúsculas y sin signos de puntuación, caracteres especiales ni espacios. Ejemplo: az ca
`zp` Código postal Cadena o lista <string>	Se requieren algoritmos hash. Utiliza minúsculas, sin espacios ni guiones. En el caso de los códigos postales de EE. UU., usa solo los cinco primeros dígitos. Para Reino Unido, utiliza el formato de área, distrito y sector. Ejemplo: Código postal de EE. UU.: 94035 Código postal de Australia: 1987 Código postal de Francia: 75018 Código postal de Reino Unido: m11ae
`country` País Cadena o lista <string>	Se requieren algoritmos hash. Utiliza códigos de país de dos letras en minúsculas en formato ISO 3166-1 alpha-2. Nota importante: Incluye siempre los países de tus clientes aunque todos los códigos de país pertenezcan al mismo país. Como las coincidencias se establecen a escala global, este sencillo paso nos ayuda a establecer coincidencias con el mayor número posible de cuentas del Centro de cuentas de tu lista. Ejemplo: Entrada: Estados Unidos Formato normalizado: us Salida esperada del algoritmo hash SHA256: 79adb2a2fce5c6ba215fe5f27f532d4e7edbac4b6a5e09e1ef3a08084a904621
`external_id` Identificador externo Cadena o lista <string>	Se recomiendan algoritmos hash. Cualquier identificador único del anunciante, como los identificadores de solicitudes de miembros de fidelidad, de usuario y de cookies externas. Puedes enviar uno o varios identificadores externos para un evento determinado. Si un identificador externo se envía a través de otros canales, debe estar en el mismo formato que cuando se envía mediante la API de conversiones.
`client_ip_address` Dirección IP de cliente Cadena	No aplicar algoritmos hash. La dirección IP del navegador correspondiente al evento debe ser una dirección IPV4 o IPV6 válida. En el caso de los usuarios que pueden usar las direcciones IPV6, se prefieren estas direcciones frente a las IPV4. Nunca se deben aplicar algoritmos hash al parámetro de datos del usuario `client_ip_address`. No se deben incluir espacios. Proporciona siempre la dirección IP real para garantizar que los informes de eventos sean adecuados. Nota: Esta información se añade automáticamente a los eventos enviados mediante el navegador, pero se debe configurar manualmente para los eventos enviados mediante el servidor. Ejemplo: IPV4: 168.212.226.204 IPV6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
`client_user_agent` Agente de usuario de cliente Cadena	No aplicar algoritmos hash. Agente de usuario del navegador correspondiente al evento. El parámetro `client_user_agent` es obligatorio para los eventos del sitio web compartidos mediante la API de conversiones. Enviar los parámetros `client_ip_address` y `client_user_agent` para todos los eventos enviados mediante la API de conversiones puede contribuir a mejorar las coincidencias de eventos y la entrega de anuncios para las campañas publicitarias que se optimicen con los eventos enviados mediante esta API. Nota: Esta información se añade automáticamente a los eventos enviados mediante el navegador, pero se debe configurar manualmente para los eventos enviados mediante el servidor. Ejemplo: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4280.141 Safari/537.36
`fbc` Identificador del clic Cadena	No aplicar algoritmos hash. El valor del identificador de clic de Meta se almacena en la cookie `_fbc` del navegador en tu dominio. Si necesitas información sobre cómo obtener este valor o cómo generarlo a partir de un parámetro de consulta `fbclid`, visita la documentación sobre la administración de los parámetros `fbc` y `fbp`. El formato es el siguiente: fb.${subdomain_index}.${creation_time}.${fbclid}. Nota: Si usas la biblioteca del Administrador de parámetros, el formato contendrá un apéndice adicional al final de cada parámetro. Para obtener más información, consulta la página de la biblioteca del Administrador de parámetros. Ejemplo: `fb.1.1554763741205.AbCdEfGhIjKlMnOpQrStUvWxYz1234567890`
`fbp` Identificador del navegador Cadena	No aplicar algoritmos hash. El valor del identificador de navegador de Meta se almacena en la cookie `_fbp` del navegador en tu dominio. Si necesitas información sobre cómo obtener este valor, consulta la documentación sobre la administración de los parámetros `fbc` y `fbp`. El formato es `fb.${subdomain_index}.${creation_time}.${random_number}`. Nota: Si usas la biblioteca del Administrador de parámetros, el formato contendrá un apéndice adicional al final de cada parámetro. Para obtener más información, consulta la página de la biblioteca del Administrador de parámetros. Ejemplo: fb.1.1596403881668.1116446470
`subscription_id` Identificador de la suscripción Cadena	No aplicar algoritmos hash. Se trata del identificador de la suscripción del usuario en esta transacción, que es similar al identificador del pedido de un producto individual.
`fb_login_id` Identificador del inicio de sesión con Facebook Entero	No aplicar algoritmos hash. Identificador que emite Meta cuando una persona inicia sesión en una instancia de una aplicación por primera vez. También se conoce como identificador de usuario específico de la aplicación.
`lead_id` Identificador del cliente potencial Entero	No aplicar algoritmos hash. Identificador asociado con un cliente potencial que generan los anuncios para clientes potenciales de Meta.
`anon_id` Cadena	No aplicar algoritmos hash. Identificador de instalación. Este campo representa instancias únicas de instalación de aplicaciones. Nota: Este parámetro es solo para eventos de la aplicación
`madid` Cadena	El identificador del anunciante en móviles, del anunciante de un dispositivo Android o del anunciante de un dispositivo Apple (IDFA).
`page_id` Cadena	No aplicar algoritmos hash. Identificador de la página. Especifica el identificador de la página asociado al evento. Usa el identificador de la página de Facebook asociado al bot.
`page_scoped_user_id` Cadena	No aplicar algoritmos hash. Especifica el identificador de usuario específico de la página asociado al bot de Messenger que registra el evento. Usa el identificador de usuario específico de la página proporcionado al webhook.
`ctwa_clid` Cadena	No aplicar algoritmos hash. Identificador del clic generado por Meta para anuncios de clic a WhatsApp.
`ig_account_id` Cadena	No aplicar algoritmos hash. Identificador de la cuenta de Instagram que está asociado a la empresa.
`ig_sid` Cadena	No aplicar algoritmos hash. Los usuarios que interactúan con Instagram se identifican mediante identificadores de usuario específicos de Instagram (IGSID). El IGSID se puede obtener de este webhook.

Parámetros de información del cliente

Comparación del píxel

Formato de los parámetros user_data

Más información

Formato de los parámetros `user_data`