Seguimiento de conversiones en campañas de Telegram Ads

Seguimiento de conversiones para enlaces dentro de Telegram en campañas de Telegram Ads

En las campañas de Telegram Ads, los macros de AdsGram no son compatibles con los enlaces que llevan a destinos dentro de Telegram y no se transmiten a estos enlaces publicitarios. Por ello, la API de confirmación de conversión no puede usarse para registrar conversiones de enlaces que llevan a Telegram Mini Apps (TMA), bots o canales.

Para los enlaces dentro de Telegram en campañas de Telegram Ads, los siguientes eventos objetivo se registran automáticamente como Goal 1 de forma predeterminada:

• TMA — inicio de la TMA;
• Bots — inicio del bot;
• Canales — suscripción al canal.

Las conversiones se registran automáticamente, por lo que no se requiere ninguna configuración adicional.

Configuración de postbacks de conversión para enlaces web en Telegram Ads

Parámetros:

• token — un token único asociado con su cuenta. Está disponible en el panel de AdsGram y se puede regenerar si es necesario.

  Cómo obtener su token:

  1. Abra el panel de AdsGram.
  2. Haga clic en su perfil en la esquina superior derecha.
  3. Busque el parámetro token y haga clic en el botón de copiar para copiarlo.

  

• campaignid — el ID de la campaña publicitaria de AdsGram a la que pertenece la conversión. Corresponde al valor del macro {campaign_id} transmitido en el enlace publicitario. AdsGram sustituye el valor del macro cuando un usuario hace clic en el enlace.

• goaltype — un parámetro que especifica el tipo de conversión (etapa del embudo), ayudando a segmentar varias acciones del usuario. Acepta valores enteros del 1 al 3.

  Uso de goaltype:

  1. Defina las etapas del embudo en su producto o servicio.
  2. Asigne las etapas a los valores de goaltype:
     • 1. Registro
     • 2. Primer depósito/compra
     • 3. Depósito/compra repetido
  3. Configure el seguimiento de conversiones para las etapas relevantes del recorrido del usuario.
  4. Agregue el parámetro goaltype a su solicitud de API al enviar datos de conversión.
  5. Use este parámetro en su analítica para realizar un análisis de rendimiento detallado por tipo de conversión.

Cómo configurar el seguimiento de conversiones:

1. Seleccione una campaña de Telegram Ads. Use una campaña activa existente o cree una nueva.
2. Configure el enlace de seguimiento. Asegúrese de que contenga el macro {campaign_id}.
3. Obtenga su token. Copie su token único desde el panel de AdsGram.
4. Configure el envío de postbacks. Configure su servidor para enviar una solicitud de API a AdsGram cada vez que un usuario complete una acción objetivo.
5. Especifique el tipo de conversión. Establezca el valor de goaltype adecuado si desea distinguir entre etapas del embudo.
6. Pruebe la integración. Siga los pasos de la sección Prueba de la integración a continuación y verifique que las conversiones aparezcan en las estadísticas de AdsGram.

Ejemplo de solicitud de API al registrarse una conversión:

GET
https://api.adsgram.ai/confirm_conversion?token=YOUR_UNIQUE_TOKEN&campaignid=72156&goaltype=2

En este ejemplo, goaltype=2 representa una conversión como un primer depósito o una compra.

Sustituya YOUR_UNIQUE_TOKEN por el token de su cuenta y 72156 por el ID de su campaña publicitaria.

Respuesta esperada: 200 OK — la conversión se ha registrado correctamente.

Prueba de la integración

Para probar el seguimiento de conversiones, siga estos pasos:

1. Cree o seleccione una campaña. Cree o seleccione una campaña de Telegram Ads y configure el enlace de seguimiento según la documentación. Asegúrese de que el enlace incluya el macro {campaign_id}.
2. Espere los clics. Espere hasta que los usuarios hayan hecho clic varias veces en el enlace de seguimiento.
3. Envíe manualmente un postback de prueba con el parámetro goaltype=1. Use un token válido y el ID de la campaña de prueba en el parámetro campaignid.
4. Compruebe el resultado. Verifique que la solicitud se haya procesado correctamente y que la conversión aparezca en las estadísticas de AdsGram de la campaña seleccionada.

Solución de problemas

• La conversión aparece en las estadísticas: la integración está configurada correctamente y funciona en el escenario probado.
• El servidor devuelve un error: compruebe la URL de la solicitud y los valores de los parámetros token, campaignid y goaltype.
• La solicitud se procesa correctamente, pero la conversión no aparece: las estadísticas se actualizan una vez por hora. Si la conversión sigue sin aparecer después de una hora, contacte con el soporte de AdsGram o con su gestor de cuenta. Asegúrese de adjuntar los registros de la solicitud y la respuesta.