¿Qué son los postbacks?

Un postback es una solicitud HTTP automática enviada desde nuestro sistema (Affiliate TOP) a su herramienta de monitoreo de rendimiento (por ejemplo, Keitaro, Voluum, RedTrack) o CRM cuando un usuario realiza una acción: se registra, hace un depósito, retira fondos, instala una aplicación, realiza una negociación, etc.

Con los postbacks, todos los datos de conversión llegan a su herramienta de seguimiento sin ningún esfuerzo manual.

Los postbacks le permiten:

• Analizar el tráfico en tiempo real

• Ajustar rápidamente sus anuncios y estrategias para mejorar los resultados de la campaña y aumentar las ganancias

• Encontrar y escalar paquetes y fuentes de tráfico rentables más rápido

¿Qué es la URL de Postback?

Es un enlace especial al que nuestro sistema envía datos de conversión. Contiene parámetros, "celdas", que se llenan con valores durante un evento: ID del clic, monto del depósito, ID del trader, ID de la campaña, etc. Cuando ocurre un evento, nuestro sistema envía automáticamente una solicitud a esta URL con los datos.

¿Dónde encontrar una URL de Postback?

Tómela de su herramienta de monitoreo de rendimiento o CRM (Keitaro, Voluum, RedTrack, etc.). Consulte su documentación o interfaz bajo la configuración de postback / seguimiento S2S.

Ejemplos de URL de Postback de los 3 principales rastreadores

Descubra cómo se ven generalmente y familiarícese con cómo agregar nuestros parámetros.

Keitaro

Ejemplo de URL de Postback: http://su-keitaro.com/postback?clickid={click_id}&status=approved&payout={sumdep}

El nombre del parámetro clickid proviene de la documentación de Keitaro
{click_id}, {sumdep} son nuestros marcadores de posición

Voluum

Ejemplo de URL de Postback: https://su-voluum.com/postback?cid={click_id}&payout={sumdep}

El nombre del parámetro cid es el nombre estándar del ID de clic para el rastreador Voluum
{click_id}, {sumdep} son nuestros marcadores de posición

RedTrack

Ejemplo de URL de Postback:

https://su-redtrack.com/postback?clickid={click_id}&revenue={sumdep}&status=approved

Los nombres de los parámetros clickid y revenue provienen de la documentación de RedTrack
{click_id}, {sumdep} son nuestros marcadores de posición

Importante: Los nombres de los parámetros (clickid, cid, revenue) deben coincidir exactamente con los requisitos de su rastreador. Los marcadores de posición entre llaves ({click_id}, {sumdep}) son nuestros.

Cómo funcionan la URL de Postback y los Parámetros

Cada parámetro consta de dos partes:

nombre del parámetro: lo que su rastreador / CRM espera (tomado de su documentación)
nuestro marcador de posición: entre llaves, lo que insertamos automáticamente.

Ejemplo: visitor_id={click_id}

Donde:

visitor_id – nombre del parámetro de la documentación del rastreador. Enviado tal cual. Este es el nombre exacto que su rastreador espera que se envíen los datos
{click_id} – nuestro marcador de posición. Reemplazado con el verdadero Click ID durante el evento.

Lado izquierdo (visitor_id, campaign_id, sub_id) – requisitos del rastreador.
Lado derecho ({click_id}, {campaign_id}) – datos de AffiliateTop.

Dónde obtener la URL de Postback y los nombres de los parámetros

Inicie sesión en su herramienta de monitoreo de rendimiento (rastreador o CRM)
Encuentre la sección Postback / Seguimiento Servidor-a-Servidor (S2S)
Copie la URL base de Postback y los nombres de los parámetros de la interfaz o documentación
Pegue la URL en nuestra configuración y agregue nuestros marcadores de posición: visitor_id={click_id}, amount={sumdep}, etc.

Ejemplo de Estructura Completa de URL de Postback

Antes del evento (con marcadores de posición) – https://su-tracker.com/postback?visitor_id={click_id}&site_id={site_id}&trader={trader_id}&amount={deposit_amount}&campaign_id={campaign_id}

Después del evento (valores reales) – https://su-tracker.com/postback?visitor_id=1234567&site_id=4458&trader=902134&amount=23.22&campaign_id=YT_BR_01

Parámetros de Postback: Formato, Ejemplos y Propósito

1. Id del Clic

Nuestro marcador de posición: {click_id}
En la URL del rastreador: visitor_id={click_id} → visitor_id=1234567
Propósito: Vincula la conversión a un clic publicitario específico. El rastreador sabe qué fuente de tráfico convirtió
Significado: Número de clic único recibido de su rastreador cuando ocurrió el clic

2. ID del sitio

Nuestro marcador de posición: {site_id}
En la URL: site_id={site_id} → site_id=4458
Propósito: Muestra qué sitio / ubicación generó tráfico que convierte. Ayuda a optimizar compras de tráfico
Significado: ID del sitio web o ubicación en su red publicitaria

3. ID del trader

Nuestro marcador de posición: {trader_id}
En la URL: trader={trader_id} → trader=902134
Propósito: Vincula todas las acciones de un usuario (múltiples cuentas, depósitos, negociaciones) en estadísticas unificadas
Significado: Identificador permanente del trader emitido al momento del primer registro

4. ID de su cuenta

Nuestro marcador de posición: {a}
En la URL: account={a} → account=a182haj2nn
Propósito: Identifica su enlace de afiliación. Útil si gestiona múltiples cuentas
Significado: Su código de referencia como afiliado. Generalmente uno por afiliado

5. Monto del depósito

Nuestro marcador de posición: {sumdep}
En la URL: amount={sumdep} → amount=23.22
Propósito: Muestra los montos de depósito exactos (primeros o recurrentes). Para el cálculo de ROI y análisis de LTV
Significado: Monto del depósito en la moneda seleccionada ($ o ¢). Solo aparece en eventos de depósito, como FTD o Re-depósito

6. ID de la transacción:

Nuestro marcador de posición: {transaction}
En URL: tx_id={transaction} → tx_id=81283192873
Propósito: Identifica de manera única cada conversión. Previene duplicados y permite una atribución precisa
Significado: ID interno del evento específico (depósito, retiro, etc.)

7. ID de campaña publicitaria

Nuestro marcador de posición: {ac}
En URL: campaign_id={ac} → campaign_id=YT_BR_01
Propósito: Separa estadísticas a través de diferentes campañas (geo, creativos, aterrizajes)
Significado: Nombre o ID de su campaña publicitaria del enlace de referencia

8. ID del postback de la subcuenta

Nuestro marcador de posición: {sa}
En URL: sub_id={sa} → sub_id=teaser_01
Propósito: Sus análisis adicionales (tipo de tráfico, creativo, webmaster)
Significado: Cualquier valor de su enlace de referencia (sub1, sub2, etc.)

9. Ganancia

Nuestro marcador de posición: {profit}
En URL: profit={profit} → profit=15.75
Propósito: Muestra el monto de ganancia/pérdida de trading para operaciones reales. Esencial para el seguimiento de ingresos y análisis de rendimiento
Significado: Ganancia neta (positiva o negativa) de la actividad de trading real del usuario. Disponible en eventos de trading en la cuenta real

Eventos de activación para Postbacks

Affiliate TOP admite postbacks para las acciones de usuario que se enumeran a continuación. Un postback = un evento. Decida qué evento desea rastrear y escriba o haga clic en los parámetros necesarios para agregarlos a su URL de Postback.

Registro: el usuario completa el registro de su cuenta
Confirmación de correo electrónico: el usuario verifica la dirección de correo electrónico
Primer depósito (FTD): el primer depósito del usuario
Re-depósito: cualquier depósito posterior (depósitos repetidos)
Aplicación instalada: el usuario instala la aplicación móvil
Primera negociación demo: la primera negociación del usuario en la cuenta demo
Retiro: el usuario completa el retiro de fondos
Negociación real: el usuario ejecuta una negociación en la cuenta de trading real

Cada evento tiene su propio conjunto de parámetros disponibles que se mencionaron anteriormente.

Cómo configurar el postback (Guía de interfaz)

Haga clic en “Agregar” para iniciar el proceso de configuración de postback y complete los campos requeridos según sus preferencias.

Nombre del postback: ingrese un nombre claro y único para cada uno de sus postbacks para evitar confusiones. (p. ej., "FTD_YT_BR")
Evento: seleccione del menú desplegable (Registro, Primer depósito, etc.)
URL de postback: pegue la URL de su rastreador (ver ejemplos anteriores)
Parámetros: haga clic en los ajustes preestablecidos azules debajo del campo “URL de postback” ("ID de clic", "Monto del depósito") para agregar parámetros automáticamente
Método: GET (predeterminado)
Moneda: seleccione $ o ¢ para montos

7. Filtros de segmentación

Esta configuración le permite decidir cuándo se debe enviar el postback, dependiendo de la campaña o subcuenta a la que está vinculado. Puede llenar uno o ambos campos.

¿Por qué usar filtros de segmentación?

Le ayudan a administrar el tráfico de forma más precisa:

Optimice las diferentes fuentes de tráfico de forma independiente: si utiliza más de una herramienta de monitoreo de rendimiento, puede enviar eventos básicos a uno y eventos con parámetros adicionales a otro.
Ejecute pruebas A/B: la segmentación le ayuda a ver qué fuentes traen más conversiones y cómo funcionan las diferentes campañas, creatividades o páginas de aterrizaje.
Pruebe o migre herramientas de manera segura: puede comenzar a enviar postbacks a una nueva herramienta de monitoreo de rendimiento en paralelo con la anterior y comparar los números antes de cambiar completamente.

Cómo el sistema decide cuándo enviar el postback:

Ni la campaña ni la subcuenta están especificadas
El postback se envía para el evento activador seleccionado, independientemente de la campaña o subcuenta.
Solo se especifica la campaña
El postback se envía para el evento activador solo si el enlace de seguimiento del trader incluye esa campaña específica.
Solo se especifica la subcuenta
El postback se envía solo si el enlace de seguimiento del trader incluye esa subcuenta específica, sin importar a qué campaña pertenezca.
Se especifican tanto la campaña como la subcuenta
El postback se envía solo cuando ambos valores en el enlace del trader coinciden con la campaña y la subcuenta que introdujo.

(Nota de activación: una vez activado el postback, se envía en un plazo de 15 segundos siempre que se cumplan el evento y las condiciones seleccionadas).

8. Actívelo si es necesario y haga clic en "Agregar"

Estados del Postback

Los postbacks pasan por varios estados durante su ciclo de vida. Aquí está lo que significa cada uno y qué desencadena los cambios de estado:

Verificando (~15 segundos): examinamos su postback en busca de problemas cuando se crea, edita o copia por primera vez
- Si el postback es correcto → se convierte en Activo.
- Si tiene errores → el postback cambia a estado Inactivo con un mensaje de error mostrado en la interfaz.
- El postback no se puede editar o pausar, solo se puede eliminar
Activo: el postback está funcionando correctamente y recopilando datos.
- Si se edita → vuelve temporalmente al estado Verificando.
- Si recibe 10 errores HTTP 3xx/4xx consecutivos → se desactiva automáticamente, muestra un error en la interfaz, y envía una notificación por correo electrónico.
Inactivo: el postback está deshabilitado debido a un fallo de validación, desactivación manual o umbral de error alcanzado. Debe ser corregido y revalidado para volver a ser Activo.

Comportamientos clave:

Después de 10 intentos de validación fallidos, la activación requiere asistencia del gerente
Los postbacks Activos se auto-monitorean y protegen contra fallos de entrega persistentes

Registros de Postback

Aquí puede encontrar todos los postbacks realizados en los últimos 30 días. Le ayuda a identificar problemas de configuración y entender qué necesita ser corregido, por ejemplo.

Lista de posibles errores:

Cuando los postbacks fallan, verifique la sección de Registros para obtener el código de estado.

Error 3xx: Errores de redirección

El servidor dice: "Vaya a esta otra dirección en su lugar."

Resultado: Su postback se envía a otro lugar.

Causas principales:

- La URL de postback redirige automáticamente (HTTP→HTTPS, www/no-www, enlaces de seguimiento)

- El servidor o rastreador reenvía solicitudes a otra dirección

- Su servidor cambia secretamente la URL en el camino

¿Cómo solucionarlo?

1. Copie su URL de postback

2. Péguela en la barra de direcciones de un navegador y presione Intro

3. Espere a que se cargue (o deje de redirigir)

4. Copie lo que ve en la barra de direcciones ahora, esta es su URL de postback

Error 4xx: Errores del cliente

El servidor dice: "Algo está mal con su solicitud."

Resultado: Generalmente es un problema de configuración.

Causas principales:

- 404: La URL de postback no existe (error tipográfico en la ruta, dominio o parámetros)

- 400/422: Parámetros faltantes o inválidos (clickid, estatus, monto)

- 403/401: El servidor bloquea la solicitud (cortafuegos, lista blanca de IP, autenticación requerida)

¿Cómo solucionarlo?

Copie su URL de postback completa (con todos los parámetros como clickid)
Verifíquelo carácter por carácter contra la configuración de su servidor
Intente abrirlo en un navegador, ¿muestra "página no encontrada"?
Corrija la parte incorrecta (dominio, ruta o información faltante) y actualícela