--- title: "Seguimiento en Telegram Ads: macros y postbacks de conversión" description: "Cómo hacer seguimiento de campañas de Telegram Ads en AdsGram: macros para enlaces web, postbacks de conversión mediante la API de confirmación de conversión y eventos automáticos en Goal 1 para Mini Apps, bots y canales." outline: [2,4] --- # Seguimiento en Telegram Ads Para un seguimiento más detallado del rendimiento de las campañas de Telegram Ads y una atribución correcta de las fuentes de acciones de destino, se recomienda usar un **sistema de analítica**. ## Macros compatibles con enlaces web en Telegram Ads Para un seguimiento detallado, use macros. AdsGram las reemplazará automáticamente por datos reales en su enlace de seguimiento. - `{campaign_id}` - `{banner_id}` - `{publisher_id}` - `{useragent}` - `{click_id}` - `{ip}` - `{campaign}` — nombre de la campaña > [!IMPORTANT] IMPORTANTE > Esta compatibilidad se aplica únicamente a los enlaces web en Telegram Ads. Las macros de AdsGram siguen sin ser compatibles con los enlaces que llevan a Telegram Mini Apps (TMA), bots o canales de Telegram en las campañas de Telegram Ads. ::: warning ATENCIÓN Para que la API de confirmación de conversión funcione correctamente con enlaces web en campañas de Telegram Ads, la URL de la campaña debe incluir la macro `{campaign_id}`. Si falta la macro obligatoria, el seguimiento de conversiones no funcionará. En las campañas de Telegram Ads, las macros de AdsGram no son compatibles con los enlaces que llevan a Telegram Mini Apps (TMA), bots o canales. Por ello, la API de confirmación de conversión no puede usarse para registrar conversiones de estos enlaces en campañas de Telegram Ads. Para más información, consulte más abajo [Seguimiento de conversiones para enlaces dentro de Telegram en campañas de Telegram Ads](#seguimiento-de-conversiones-para-enlaces-dentro-de-telegram-en-campanas-de-telegram-ads). ::: > [!IMPORTANT] IMPORTANTE > La macro `{publisher_id}` se revela solo como un identificador único del editor, sin especificar su nombre u otra información de identificación. Ejemplo de URL de campaña: ``` https://your-tracker.com/?campaign={campaign_id}&banner={banner_id}&pub={publisher_id}&clickid={click_id} ``` El panel resalta las macros agregadas al enlace Added macros y las que faltan Missed macros. ![Macros seleccionadas](../../advertiser/images/selected_macroses.webp =500x) ## 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. 1. Haga clic en su perfil en la esquina superior derecha. 1. Busque el parámetro `token` y haga clic en el botón de copiar Copy para copiarlo. ![Copiar macros](../../advertiser/images/copy_macros.webp =200x) - `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 de la macro cuando el 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. 1. Asigne las etapas a los valores de goaltype: - 1. Registro - 2. Primer depósito/compra - 3. Depósito/compra repetido 1. Configure el seguimiento de conversiones para las etapas relevantes del recorrido del usuario. 1. Agregue el parámetro goaltype a su solicitud de API al enviar datos de conversión. 1. 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. 1. **Configure el enlace de seguimiento.** Asegúrese de que contenga el macro `{campaign_id}`. 1. **Obtenga su token.** Copie su token único desde el panel de AdsGram. 1. **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. 1. **Especifique el tipo de conversión.** Establezca el valor de `goaltype` adecuado si desea distinguir entre etapas del embudo. 1. **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}`. 1. **Espere los clics.** Espere hasta que los usuarios hayan hecho clic varias veces en el enlace de seguimiento. 1. **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`. 1. **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. ## 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.