Tellmetric
Meta CAPI

Meta Conversions API para embudos de Telegram

Cuando un clic se convierte en un miembro del grupo o en alguien que deposita, Tellmetric reporta la conversión a Meta a través de la API de conversiones (Conversions API). Así tus campañas pueden optimizar para esos resultados en lugar de para clics.

Conversiones que Meta no puede ver

El sistema de entrega de Meta depende de la retroalimentación. Muestra el anuncio, observa el resultado y ajusta la entrega en consecuencia. En un embudo de Telegram, el resultado ocurre fuera de la vista de Meta: la persona toca el anuncio, se abre Telegram y lo que pase después, ya sea un alta, una conversación o un depósito, sucede en una app donde el píxel de Meta no puede ejecutarse. La retroalimentación nunca llega. Una campaña sin datos de conversión no puede mejorar su segmentación, por mucho tiempo que esté activa, y termina conformándose con la única señal que tiene: el clic.

Qué cambia la Conversions API

La Conversions API (CAPI) es un canal de servidor a servidor. En lugar de depender de un script en el navegador, un servidor envía los eventos directamente a tu conjunto de datos de Meta. Esto permite reportar eventos que ocurren dentro de Telegram, y esos eventos no se ven afectados por bloqueadores de anuncios, restricciones de seguimiento de iOS ni pérdida de cookies.

La API en sí es solo un mecanismo de entrega. Para que un evento sea útil, además tiene que usar un nombre de evento estándar para el que Meta pueda optimizar, llevar suficientes identificadores para que Meta lo vincule con una persona que vio el anuncio, y llegar una sola vez y no varias. Tellmetric se encarga de todo esto por ti.

  • Nombres de evento estándar. Las altas se envían como CompleteRegistration, los mensajes directos como Contact, y los depósitos y pagos con Stars como Purchase, para que Meta pueda optimizar para ellos. La correspondencia se puede editar en cada espacio de trabajo.
  • Identidad del clic. El parámetro fbc se reconstruye a partir del fbclid original, lo que vincula el evento con el anuncio.
  • Parámetros de coincidencia. Se incluyen el email y el teléfono con hash y un id de usuario de Telegram con hash cuando están disponibles, junto con la dirección IP del cliente y el user agent.
  • Deduplicación. Cada evento lleva un id de evento estable, así que los reintentos y las acciones repetidas no se cuentan dos veces.

Qué eventos recibe Meta

Los nombres de evento personalizados se pueden medir en Events Manager, pero las campañas optimizan mejor con eventos estándar. Por eso Tellmetric asigna por defecto sus eventos internos a eventos estándar de Meta:

  • Alta en un grupo o canal se convierte en CompleteRegistration
  • Mensaje a tu bot se convierte en Contact cuando se puede vincular a un clic; un mensaje sin clic detrás se conserva en tus reportes pero no se envía, porque Meta no podría vincularlo con nadie
  • Depósito y primer depósito (FTD) se convierten en Purchase con valor y moneda
  • Pago con Telegram Stars se convierte en Purchase, con el importe en Stars convertido a dólares estadounidenses, porque Meta solo acepta monedas ISO
  • Los estados de postback lead, contact y reg se convierten en Lead, Contact y CompleteRegistration

En la sección Advanced de la página Connections puedes cambiar cualquiera de estas correspondencias, una línea por evento, por ejemplo Joiner=Lead. Cuando el nombre que recibe Meta es distinto del interno, el original se guarda en un campo source_event, así que dentro de Events Manager todavía puedes distinguir un depósito de un pago con Stars. Los clics, los miembros que salen del grupo y los reembolsos no se envían como conversiones.

Calidad de coincidencia: qué lleva cada evento

Meta solo puede atribuir una conversión a un anuncio si reconoce a la persona. Para ello usa parámetros de información del cliente, y cuantos más parámetros fiables lleve un evento, mejor coincide. Un embudo de Telegram ofrece menos de estos parámetros que un checkout web, así que cada uno cuenta.

  • fbc, reconstruido a partir del fbclid que Meta añade a la URL del anuncio, registrado en el momento del clic
  • fbp, el id de navegador de Meta, cuando el visitante pasó por una landing page con el snippet tracker.js
  • Dirección IP del cliente y user agent del clic, que heredan todos los eventos posteriores de la misma persona
  • País, determinado a partir del clic y enviado con hash
  • external_id, un hash SHA-256 del id de usuario de Telegram, para que un alta y un depósito posterior lleven la misma identidad
  • Email, teléfono, nombre, ciudad, código postal, fecha de nacimiento y género, cuando tu plataforma los incluye en el postback o en la llamada a la API de eventos; se les aplica hash antes de guardarlos, y los valores a los que ya hayas aplicado hash pasan sin cambios

En Pro y Agency, el panel de calidad de coincidencia del dashboard muestra la proporción de tus eventos que lleva cada identificador. Así puedes ver, por ejemplo, que los depósitos llevan fbc pero rara vez un email, y pedirle a tu plataforma que lo añada al postback.

Deduplicación y compras repetidas

Meta deduplica los eventos que comparten nombre e id de evento. Tellmetric genera ids estables para que cada acción real se cuente una sola vez:

  • El id de un postback combina el estado, el id de clic y el id de transacción. Si tu tracker reenvía el mismo depósito, se reconoce como duplicado y no se vuelve a registrar; un segundo depósito con un id de transacción nuevo es un evento nuevo.
  • Un pago con Stars usa el propio id de cobro de Telegram.
  • Los mensajes a tu bot se cuentan una vez por persona y día, sin importar cuántos mensajes envíe.
  • El id de transacción también se envía como order_id, y los depósitos repetidos se marcan como de un cliente recurrente, con una referencia a la primera compra.

Cómo se gestiona la entrega

Un proceso de entrega recoge los eventos nuevos cada 30 segundos y los envía en lotes a tu conjunto de datos. Antes de enviarlo, cada evento se comprueba contra las reglas de Meta. Meta rechaza el lote entero cuando un solo evento no es válido, así que un evento con más de siete días de antigüedad, con una moneda no admitida o con un user agent que no es de navegador se aparta por separado en lugar de bloquear al resto. Los errores temporales, como los límites de frecuencia, se reintentan con intervalos crecientes antes de marcar el evento como fallido. El tráfico que parece automatizado, como user agents de rastreadores conocidos o direcciones IP privadas, se registra pero no se envía, para que Meta aprenda de personas y no de bots.

Si tu espacio de trabajo retiene los depósitos para revisión, cada depósito espera hasta que un miembro del equipo lo aprueba y solo entonces se entrega. El estado de entrega de cada evento y la respuesta de Meta se pueden ver en la app.

Conectar Meta paso a paso

  1. En Meta Events Manager, selecciona tu conjunto de datos (píxel) y abre Configuración. Copia el id del conjunto de datos.
  2. En la sección Conversions API, genera un token de acceso y cópialo.
  3. Pega ambos en la página Connections de Tellmetric.
  4. Copia un código de evento de prueba desde la pestaña Eventos de prueba de Events Manager y agrégalo en esa misma página.
  5. Abre uno de tus enlaces de seguimiento en tu teléfono y únete al grupo. En aproximadamente un minuto, el alta aparece en Eventos de prueba como CompleteRegistration.
  6. Elimina el código de prueba para que los eventos reales cuenten para tus campañas y, después, configura como evento de conversión de la campaña la etapa para la que quieres que Meta optimice.

Ejemplo ilustrativo: qué recibe Meta

Un evento Purchase con un valor de 120 y moneda EUR; fbc, la dirección IP del cliente y el user agent del clic original; un external ID derivado de la cuenta de Telegram; el id de transacción del bróker como order_id, y un campo source_event que indica que se originó como un Deposit en tu embudo. Los códigos de evento de prueba te permiten confirmar el evento en Events Manager antes de que ninguna campaña dependa de él.

Píxel y Conversions API juntos

Si usas una landing page antes de Telegram, puede que ya tengas el píxel de Meta instalado en ella. Consérvalo. El píxel reporta lo que pasa en la página; Tellmetric reporta lo que pasa después, en Telegram y en tu sistema de depósitos. Cuando ambos podrían reportar el mismo evento, un id de evento compartido permite que Meta lo cuente una sola vez. Para una comparación más completa, lee píxel de Meta frente a Conversions API para Telegram.

Errores comunes

  • Enviar nombres de evento personalizados, que Meta mide pero no puede usar como objetivo de optimización
  • Enviar depósitos sin valor ni moneda, de modo que Meta los cuenta pero no puede ponderarlos
  • Acumular los depósitos en un lote semanal, cuando Meta acepta eventos de hasta siete días de antigüedad
  • Olvidar eliminar el código de evento de prueba tras la verificación
  • Omitir el email o el teléfono que tu plataforma ya tiene, lo que deja a los depósitos coincidiendo solo con los datos del clic

Ventajas para los anunciantes

  • Campañas optimizadas para miembros y depositantes en lugar de clics
  • Públicos similares creados a partir de personas que convirtieron
  • Columnas de conversión en Ads Manager que reflejan los resultados en Telegram
  • Reportes que siguen funcionando cuando los navegadores bloquean el seguimiento de terceros

Preguntas frecuentes

¿Qué necesito de Meta?

Un id de conjunto de datos y un token de acceso de la Conversions API, ambos disponibles sin costo en Events Manager.

¿Puedo conservar el píxel de mi sitio web?

Sí. El píxel y la Conversions API pueden funcionar juntos. Los ids de evento de Tellmetric permiten que Meta deduplique cualquier evento reportado por ambos.

¿Cómo evalúa Meta la calidad de mis datos?

En gran parte, por los parámetros de coincidencia que lleva cada evento. El panel de calidad de coincidencia muestra tu cobertura de fbc, email, teléfono y external ID, para que veas dónde mejorar.

¿Puedo cambiar el nombre de los eventos?

Sí. Cada espacio de trabajo puede asignar los eventos internos a cualquier evento estándar de Meta, por ejemplo Joiner a Lead en lugar de CompleteRegistration.

¿La Conversions API está incluida en el plan Free?

Sí. Los reportes a Meta forman parte de todos los planes, incluido Free, que cubre 1000 usuarios rastreados al mes. TikTok, Snapchat, Reddit, Spotify y Google Ads se añaden en Pro y Agency.

¿Puedo enviar eventos desde mi propio backend?

Sí. La API de eventos acepta conversiones con un id de usuario de Telegram o tu propio id de cliente, y el endpoint de postback acepta el formato que ya usan los trackers de afiliados. Ambos se describen en la página para desarrolladores.

Guías relacionadas

Mide las conversiones en Telegram de tus anuncios de Meta

El plan Free no requiere tarjeta. Pasa a Pro cuando quieras.