Eventos CAPI

Esta guía explica cómo configurar los eventos de Conversions API que AdTarget envía a Meta cuando los usuarios se unen a tu canal de Telegram.

¿Cuándo se envían los eventos CAPI?

AdTarget envía un evento CAPI a Meta solo para uniones atribuidas — es decir, uniones donde AdTarget puede vincular la unión de Telegram a un clic de anuncio específico en tu landing page. Esto requiere que el invite_link esté presente en el webhook de Telegram.

Los eventos CAPI se envían cuando un usuario hace clic en tu enlace de invitación rastreable y Telegram lo reporta en el webhook (confiable para canales privados).

Los eventos CAPI NO se envían para uniones orgánicas — usuarios que encuentran tu canal a través de la búsqueda, enlaces directos o mensajes reenviados. Estas uniones aún aparecen en tu panel de AdTarget pero se marcan como “orgánicas”.

Limitación de canales públicos: Debido a una limitación del API de Telegram, incluso los usuarios que hacen clic en tu enlace rastreable pueden ser tratados como uniones orgánicas en canales públicos. La app de Telegram (especialmente Android) a menudo convierte las uniones por enlace de invitación en “uniones directas” para canales públicos, eliminando los datos de atribución. Más información →

Tipos de eventos disponibles

AdTarget puede enviar estos eventos estándar de Meta:

Evento	Ideal para	Optimización de Meta
Lead	Campañas de generación de leads	Optimiza para intención de lead
Purchase	Campañas enfocadas en compras	Optimiza para acciones de compra
CompleteRegistration	Campañas enfocadas en registros	Optimiza para acciones de registro
Subscribe	Campañas de suscripción	Optimiza para intención de suscripción
Custom	Nombre de evento personalizado	Para necesidades de seguimiento especializadas

Elegir el evento correcto

¿Ejecutas anuncios de generación de leads? Usa Lead — Esto le dice a Meta “esta persona se convirtió en un lead”.

¿Vendes un producto o servicio? Usa Purchase — Es mejor cuando quieres que Meta optimice para compradores. Combínalo con value y currency en la configuración de conversión de tu canal para la optimización basada en valor.

¿Ejecutas campañas de registro? Usa CompleteRegistration — Señala una acción de registro completada.

¿Promocionas una suscripción al canal? Usa Subscribe — Coincide con la acción del usuario (unirse = suscribirse).

¿Necesitas un evento no estándar? Usa Custom — Te permite definir tu propio customEventName para escenarios de seguimiento especializados que no encajan en los tipos estándar.

Consejo: Haz coincidir tu tipo de evento con el objetivo de tu campaña en el Administrador de anuncios para obtener mejores resultados.

Configurar eventos

Los tipos de eventos se configuran por canal. Cada canal tiene como predeterminado Lead cuando se detecta por primera vez.

Para cambiar el tipo de evento de un canal:

Ve a la Configuración de tu sitio → pestaña Channels
Haz clic en Setup (o Edit) en la fila del canal
Selecciona tu tipo de evento en el diálogo
Haz clic en Save

Parámetros del evento

Cada evento que AdTarget envía incluye estos parámetros:

Parámetros obligatorios

Parámetro	Descripción
`event_name`	El tipo de evento (Lead, etc.)
`event_time`	Marca de tiempo Unix de la unión
`action_source`	Siempre “website”

Parámetros de atribución

Parámetro	Descripción
`fbc`	Cookie de seguimiento de clic (contiene el `fbclid` del clic del anuncio, formateado como `fb.1.{timestamp}.{fbclid}`)
`fbp`	Valor de cookie de seguimiento del navegador (ID de navegador de Meta)

Datos de usuario

Si están disponibles, AdTarget envía datos de usuario para la coincidencia:

Parámetro	Fuente	¿Hasheado?
`external_id`	ID de usuario de Telegram	Sí (SHA-256)
`client_ip_address`	IP de la visita a la landing page	No (enviado tal cual)
`client_user_agent`	Navegador de la visita a la landing page	No (enviado tal cual)

El external_id (ID de usuario de Telegram) se hashea con SHA-256 antes de enviarlo, como recomienda Meta. Otros parámetros como la dirección IP y el user agent se envían tal cual, lo cual es consistente con las especificaciones de CAPI de Meta para estos campos.

Datos personalizados

AdTarget también envía estos campos dentro del objeto custom_data de cada evento CAPI:

Parámetro	Descripción
`event_source_url`	URL de la landing page (construida a partir del dominio del sitio + ruta de la visita)
`value`	Valor del evento (si está configurado por canal)
`currency`	Código de moneda (por defecto `"USD"`)
`content_name`	Título del canal o nombre personalizado de la configuración del canal

Deduplicación de eventos

AdTarget incluye un event_id único con cada evento para prevenir duplicados:


event_id: "adtarget_{conversion_id}"

Esto asegura que la misma conversión no se cuente dos veces, incluso si se reintenta.

Probar eventos

Evento de prueba de validación

Cuando guardas tu pixel durante la configuración, AdTarget envía automáticamente un evento de prueba PageView con el código ADTARGET_TEST. Puedes verlo en el Administrador de eventos de Meta en la pestaña Eventos de prueba — confirma que tu pixel ID y token de acceso están funcionando.

Probar en producción

La forma más confiable de probar de extremo a extremo:

Haz clic en tu propio anuncio (o usa un anuncio de prueba)
Visita tu landing page
Únete a tu canal de Telegram a través del enlace de invitación rastreable
Revisa el Administrador de eventos en 5 minutos

Coincidencia de eventos

Meta vincula tus eventos a usuarios para la atribución. Mayor calidad de coincidencia = mejor optimización.

Factores de calidad de coincidencia

Factor	Impacto
fbc presente (contiene fbclid)	Alto - Atribución directa del clic
User agent + IP	Medio - Coincidencia probabilística
External ID	Medio - Coincidencia entre dispositivos

Mejorar la calidad de coincidencia

Captura el fbclid: Asegúrate de que la URL de tu landing page preserve el parámetro fbclid
Envía eventos rápidamente: Menor tiempo entre el clic y la conversión mejora la coincidencia
Recorrido del usuario consistente: Mantén a los usuarios en tu dominio antes de redirigir a Telegram

Configuraciones comunes de eventos

Generación de leads


Event Type: Lead
When: User joins channel
Use Case: "Get subscribers" campaigns

Seguimiento de compras


Event Type: Purchase
When: User joins channel
Use Case: "Buy now" campaigns with value-based optimization

Suscripción de contenido


Event Type: Subscribe
When: User joins channel
Use Case: "Subscribe to channel" campaigns

Configuración multi-canal


Channel A (free content): Lead
Channel B (premium): Purchase
Channel C (subscription): Subscribe

Solución de problemas

¿Los eventos no coinciden?

Verifica que el fbclid esté en la URL de la landing page
Comprueba que Meta Pixel también esté en la landing page
Asegúrate de que las cookies no estén bloqueadas

¿La puntuación de calidad del evento es deficiente?

Aumenta los datos que envías (IP, user agent)
Reduce el tiempo entre el clic y la conversión
Verifica que el fbclid se esté capturando

¿Eventos duplicados?

AdTarget gestiona la deduplicación automáticamente
Si ves duplicados, contacta con soporte

Mejores prácticas

Haz coincidir el tipo de evento con el objetivo de la campaña para mejor optimización
Usa el mismo tipo de evento consistentemente dentro de una campaña
Monitorea la calidad del evento en el Administrador de eventos semanalmente
Prueba antes de escalar el gasto en anuncios

Siguientes pasos

¡Tu integración con Meta está completa! Empieza a ejecutar anuncios y observa tus conversiones fluir hacia Meta.

¿Necesitas ayuda optimizando? Contacta con nuestro equipo de soporte.