API de conversiones de Meta (CAPI) para formularios de leads: envía leads sin contarlos dos veces
Cómo enviar leads a Meta a través del píxel y de la API de conversiones con un mismo ID de evento, obtener un token de acceso, verificar en Probar eventos y gestionar el consentimiento para los datos de contacto con hash.
Respuesta: La API de conversiones de Meta (CAPI) envía eventos desde tu servidor en lugar del navegador del visitante. Úsala junto con el píxel y dales a ambos el mismo nombre de evento y el mismo ID de evento; así Meta conserva uno y descarta el duplicado. Los leads que el píxel pierde (bloqueadores de anuncios, límites de seguimiento del navegador, pestañas cerradas) quedan registrados igualmente por el evento del servidor.
Por qué el píxel por sí solo se queda corto
El píxel se ejecuta en el navegador del visitante. Los bloqueadores de anuncios, los límites de seguimiento de iOS y la gente que cierra la pestaña justo después de enviar hacen que se pierdan eventos. Entonces Meta reporta menos conversiones de las reales y optimiza tus anuncios con menos datos. Una copia desde el servidor cubre ese hueco.
Qué necesitas
- ID del píxel (conjunto de datos) en el Administrador de eventos de Meta → Orígenes de datos.
- Token de acceso de la API de conversiones: Administrador de eventos → tu conjunto de datos → Configuración → API de conversiones → Generar token de acceso.
- Código de evento de prueba (opcional): aparece en la pestaña Probar eventos y empieza por
TEST.
Cómo funciona la deduplicación
| Enviado desde | Nombre del evento | ID del evento |
|---|---|---|
| Píxel del navegador | Lead |
fbq('track', 'Lead', {}, {eventID: 'abc123'}) |
| Servidor (CAPI) | Lead |
"event_id": "abc123" |
Cuando llegan el mismo nombre y el mismo ID desde ambos lados, Meta conserva uno. Si los IDs son distintos, o el nombre es distinto (por ejemplo Lead frente a SubmitApplication), el lead se cuenta dos veces. Genera un único ID en el navegador en el momento del envío y pásalo a ambos.
Qué incluir en el evento del servidor
event_name(Lead),event_time,event_id,action_source: "website",event_source_urluser_data- enviados tal cual:
client_ip_address,client_user_agent,fbc(cookie del ID de clic),fbp(cookie del ID del navegador) - con hash SHA-256: teléfono (
ph, dígitos con código de país, p. ej. 821012345678), correo (em, en minúsculas), nombre
- enviados tal cual:
Más identificadores mejoran la calidad de coincidencia de eventos, pero primero resuelve el consentimiento.
Consentimiento: los datos con hash siguen siendo datos personales
Según la Personal Information Protection Act de Corea (y la mayoría de las leyes de privacidad), aplicar hash a un número de teléfono no lo vuelve anónimo, y Meta es un destinatario en el extranjero. Una configuración segura:
- Añade un consentimiento separado y opcional para la "transferencia internacional para medición publicitaria": destinatario (Meta Platforms), país, datos, finalidad, conservación.
- Incluye los datos de contacto con hash solo de las personas que aceptaron.
- Para el resto, envía el evento solo con IP, user agent e IDs de clic.
- Nunca envíes información de salud, como síntomas.
Consulta los textos de consentimiento para formularios de leads en Corea o genéralos con la herramienta gratuita de consentimiento.
Verifica
- Agrega el código de evento de prueba y envía un lead de prueba.
- En Probar eventos deberías ver un evento de navegador y uno de servidor, uno de ellos marcado como deduplicado.
- Quita el código de prueba antes de salir en vivo.
Devuelve los resultados
Cuando un lead se convierte en consulta o en venta, envía un evento personalizado desde el servidor con los mismos identificadores con hash (o un ID externo). Así Meta puede aprender qué personas van más allá de llenar el formulario.
En CutLanding
Pega el ID de tu píxel y el token de acceso en Configuración → Conectar. Después de guardar un lead, los eventos del píxel y del servidor salen con el mismo ID, los datos de contacto con hash se añaden solo para quienes dieron su consentimiento a la medición publicitaria, los datos de salud nunca se envían y los envíos fallidos se reintentan durante 24 horas.
FAQ
¿Puedo quitar el píxel y usar solo la API de conversiones?
Meta recomienda usar ambos con deduplicación. Los datos del navegador (las cookies fbp y fbc) ayudan a la coincidencia, y si un lado falla, el otro sigue registrando el lead.
Mis leads se cuentan dos veces. ¿Por qué?
Los nombres de evento o los IDs de evento no coinciden entre el píxel y el servidor. Usa un único ID por envío en ambos lados y el mismo nombre de evento.
¿Qué pasa si se filtra mi token de acceso?
Genera un token nuevo en el Administrador de eventos y reemplázalo en todos los lugares donde se usa. Guarda el token solo en el servidor, nunca en el HTML de la página.