Snapchat Conversions API

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

¿Cuándo se envían los eventos?

AdTarget envía un evento a Snapchat solo para uniones atribuidas — es decir, uniones donde AdTarget puede vincular la unión a Telegram con un clic específico en un anuncio en tu página de destino. Esto requiere que el invite_link esté presente en el webhook de Telegram.

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

Los eventos NO se envían para uniones orgánicas — usuarios que encuentran tu canal a través de 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 de la API de Telegram, incluso los usuarios que hacen clic en tu enlace rastreado 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. Saber más →

Tipos de eventos disponibles

AdTarget mapea sus tipos de eventos a los eventos estándar de Snapchat:

Evento AdTarget	Evento Snapchat	Ideal para	Optimización Snapchat
Lead	SIGN_UP	Campañas de generación de leads	Optimiza para registros
Purchase	PURCHASE	Campañas enfocadas en compras	Optimiza para acciones de compra
CompleteRegistration	SIGN_UP	Campañas enfocadas en registros	Optimiza para registros
Subscribe	SUBSCRIBE	Campañas de suscripción	Optimiza para intención de suscripción
Custom	CUSTOM_EVENT_1	Seguimiento especializado	Optimización personalizada

Elegir el evento correcto

¿Ejecutando anuncios de generación de leads? Usa Lead (se mapea al SIGN_UP de Snapchat) — Esto le dice a Snapchat “esta persona se registró / se convirtió en lead”.

¿Vendiendo un producto o servicio? Usa Purchase (se mapea a PURCHASE) — Ideal cuando quieres que Snapchat optimice para compradores. Combínalo con un value y currency en la configuración de conversión de tu canal para optimización basada en valor.

¿Ejecutando campañas de registro? Usa CompleteRegistration (se mapea a SIGN_UP) — Señala una acción de registro completada.

¿Promoviendo una suscripción a un canal? Usa Subscribe (se mapea a SUBSCRIBE) — Coincide con la acción del usuario (unirse = suscribirse).

¿Necesitas un evento no estándar? Usa Custom (se mapea a CUSTOM_EVENT_1) — 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 Snapchat Ads Manager para mejores resultados.

Configuración de eventos

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

Para cambiar el tipo de evento de un canal:

Ve a los Settings 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 de eventos

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

Parámetros obligatorios

Parámetro	Descripción
`event_type`	El nombre del evento Snapchat (SIGN_UP, PURCHASE, etc.)
`timestamp`	Marca de tiempo ISO 8601 de la unión (milisegundos)
`event_tag`	Etiqueta para categorización de eventos

Parámetros de atribución

Parámetro	Descripción
`sc_click_id`	El Snapchat Click ID (`ScCid`) del clic en el anuncio

Datos de usuario

Parámetro	Fuente	¿Hasheado?
`hashed_external_id`	ID de usuario de Telegram	Sí (SHA-256)
`hashed_ip_address`	IP de la visita a la página de destino	No (enviado tal cual)
`user_agent`	Navegador de la visita a la página de destino	No (enviado tal cual)

El external_id (ID de usuario de Telegram) se hashea con SHA-256 antes de enviarlo, como requiere Snapchat. La dirección IP y el user agent se envían tal cual según las especificaciones de la Conversions API de Snapchat.

Campos personalizados

Parámetro	Descripción
`price`	Valor del evento (si está configurado por canal)
`currency`	Código de moneda (por defecto `"USD"`)
`description`	Título del canal o nombre personalizado de la config 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.

Prueba de eventos

Prueba en producción

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

Haz clic en tu propio anuncio de Snapchat (o usa un anuncio de prueba)
Visita tu página de destino
Únete a tu canal de Telegram a través del enlace de invitación rastreado
Revisa el Snapchat Events Manager en 5-10 minutos

Verificar en Snapchat Ads Manager

Ve a Events Manager
Selecciona tu píxel
Busca tu tipo de evento con marcas de tiempo recientes
Verifica que el evento muestre como “Received”

Coincidencia de eventos

Snapchat hace coincidir tus eventos con usuarios para la atribución. Mayor calidad de coincidencia significa mejor optimización.

Factores de calidad de coincidencia

Factor	Impacto
ScCid presente	Alto - Atribución directa por clic
User agent + IP	Medio - Coincidencia probabilística
External ID	Medio - Coincidencia entre dispositivos

Mejorar la calidad de coincidencia

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

Configuraciones comunes de eventos

Generación de leads


AdTarget Event: Lead → Snapchat Event: SIGN_UP
When: User joins channel
Use Case: "Get subscribers" campaigns

Seguimiento de compras


AdTarget Event: Purchase → Snapchat Event: PURCHASE
When: User joins channel
Use Case: "Buy now" campaigns with value-based optimization

Suscripción a contenido


AdTarget Event: Subscribe → Snapchat Event: SUBSCRIBE
When: User joins channel
Use Case: "Subscribe to channel" campaigns

Solución de problemas

¿Los eventos no coinciden?

Verifica que el ScCid esté en la URL de la página de destino
Verifica que el Snapchat Pixel también esté en la página de destino
Asegúrate de que las cookies no estén bloqueadas

¿Baja tasa de coincidencia de eventos?

Reduce el tiempo entre clic y conversión
Verifica que el ScCid se esté capturando de la URL
Asegúrate de que IP y user agent estén disponibles

¿Eventos duplicados?

AdTarget maneja la deduplicación automáticamente vía event_id
Si ves duplicados, contacta al soporte

Mejores prácticas

Haz coincidir el tipo de evento con el objetivo de campaña para mejor optimización
Usa el mismo tipo de evento consistentemente dentro de una campaña
Monitorea la entrega de eventos en Snapchat Events Manager regularmente
Prueba antes de escalar el gasto publicitario

Próximos pasos

¡Tu integración con Snapchat está completa! Comienza a ejecutar anuncios y observa cómo tus conversiones llegan a Snapchat.

¿Necesitas ayuda para optimizar? Contacta a nuestro equipo de soporte.