Configuración de postbacks de conversión para enlaces de destino del ecosistema de Telegram

ATENCIÓN

Las instrucciones de esta sección no se aplican a las campañas de Telegram Ads. Para obtener más información sobre el seguimiento de conversiones para enlaces dentro de Telegram en campañas de Telegram Ads, consulte esta sección.

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.

  

• tgid — el ID de Telegram del usuario que hizo clic en el enlace publicitario.

• 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. Use una campaña activa existente o cree una nueva.
2. Configure el enlace publicitario. 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&tgid=98110997&goaltype=2&campaignid=72156

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

Sustituya los valores del ejemplo por sus datos reales:

• YOUR_UNIQUE_TOKEN — el token de su cuenta de AdsGram;
• 98110997 — el ID de Telegram del usuario que hizo clic en el enlace publicitario;
• 72156 — 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. Configure el enlace publicitario según la documentación y asegúrese de que contenga el macro {campaign_id}.
2. Espere los clics. Espere hasta que los usuarios hayan hecho clic varias veces en el enlace publicitario.
3. Obtenga el ID de Telegram del usuario. Obtenga el tgid de un usuario que haya hecho clic en el enlace de la campaña seleccionada.
4. Envíe manualmente un postback de prueba. Establezca goaltype=1 e indique un token válido, el ID de Telegram del usuario en el parámetro tgid y el ID de la campaña de prueba en el parámetro campaignid.
5. 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, tgid, 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.