Configuración de postbacks de conversión para enlaces de destino web

ATENCIÓN

Las instrucciones de esta sección no se aplican a las campañas de Telegram Ads. Para configurar postbacks de conversión para enlaces web en 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.

  

• record — un valor único para cada clic o impresión, correspondiente al macro {record_data}. AdsGram inserta automáticamente este valor en el enlace de seguimiento.

• 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 de seguimiento. Asegúrese de que contenga el macro {record_data}.
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&record=7f3a1b6c5d2e4f8a&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 7f3a1b6c5d2e4f8a por el valor real de {record_data} del enlace de seguimiento.

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 de seguimiento según la documentación y asegúrese de que contenga el macro {record_data}.
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. Indique un token válido en el parámetro token y, en el parámetro record, el valor real de {record_data} del enlace de seguimiento en el que se hizo clic.
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, record 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.