# Postbacks: para qué sirven y cómo construir la URL

Un postback es un mensaje automático del sistema de afiliados a tu tracker. En cuanto un trader que trajiste genera un evento —registro, depósito, retiro—, el sistema envía una petición a tu dirección con los datos del evento.

- **Resultado:** Una URL de postback lista para cada evento que necesites: con tus propios nombres de parámetros, los macros correctos y una estructura ya verificada.
- **Duración:** 15–20 minutos

## 01. Para qué sirve un postback

Sin postback solo ves clics: lo que pasó después hay que exportarlo a mano y cuadrarlo por fechas. El postback cierra ese hueco: el tracker se entera del evento segundos después de que ocurra.

> El postback no crea nada y no influye en los pagos. Solo le cuenta a tu tracker algo que ya ocurrió.

- **Los datos llegan solos.** Sin exportaciones ni cuadres manuales. El evento va al tracker automáticamente, en el momento en que el sistema lo registra.
- **Se ve qué fuente paga.** El evento llega con tus propias etiquetas: click_id, sub_id, campaña, sitio. Así se ve qué combinación se paga sola y cuál solo gasta presupuesto.
- **Optimiza por dinero, no por clics.** Tu tracker y tu cuenta publicitaria reciben conversiones con importes y aprenden de ellas. Optimizas las campañas por depósitos y comisión.

## 02. Dos tipos de postback

Hay dos niveles de configuración. No entran en conflicto: si una campaña tiene su propio postback, ese gana sobre el global.

### Global — Postback global

Se configura a nivel de la cuenta de partner y funciona por defecto en todas las campañas. Es la opción base: lo configuras una vez y los eventos llegan de todo tu tráfico.

- Nivel de cuenta
- Funciona por defecto

### Campaign (Local) — Postback de campaña

Se configura para una campaña concreta, por Campaign ID (cid) y nombre de campaña. Úsalo cuando una campaña va a un tracker aparte o necesita otro conjunto de parámetros.

- Nivel de campaña
- Anula el global

> Cuando una campaña tiene un postback local, el global no se dispara para ella. Comprueba esto primero cuando busques conversiones «perdidas».

## 03. Eventos

Al configurarlo eliges qué eventos disparan una petición. Cada evento suele tener su propia URL, con su propio valor del parámetro event y su propio conjunto de macros.

| Evento | Cuándo se envía |
| --- | --- |
| Registro | El trader se ha registrado. |
| Confirmación de email | El trader confirmó su correo. |
| Primer depósito | El trader hizo su primer depósito (FTD). |
| Depósito repetido | El trader hizo un depósito repetido, procesado y acreditado. |
| Retiro | El trader inició un retiro. Estados posibles: pending, canceled, success. |
| Comisión | Al partner se le acreditó comisión por la actividad del trader. Se calcula una vez al día por el día anterior, con un postback aparte por cada trader. |
| Nuevo retiro (alternativa) | El trader creó una solicitud de retiro: el estado pending como evento propio. |
| Retiro cancelado (alternativa) | La solicitud de retiro se canceló: el estado canceled como evento propio. |
| Retiro exitoso (alternativa) | El retiro se procesó y se pagó: el estado success como evento propio. |

Los tres eventos con el estado en el nombre son una alternativa al evento general de Retiro, para trackers que no pueden dividir un evento por el valor de {status}. Elige uno u otro: activar a la vez el evento general y la división por estados envía dos postbacks por el mismo retiro.

La comisión se calcula una vez al día por el día anterior, y se envía un postback aparte por cada trader con comisión acreditada. No la esperes en la misma hora en que el trader estuvo activo.

## 04. Reglas de la URL

La configuración vive en dos sitios, y eso es lo que conviene recordar. El campo URL lleva el endpoint de tu tracker. Los macros no van ahí: se indican en los campos de parámetros que hay debajo, y los valores se sustituyen solo desde esos campos.

1. **La dirección va en el campo URL, los macros en los campos de abajo.** El campo URL lleva el endpoint que te dio tu tracker y, si hace falta, una etiqueta fija del evento como event=ftd. Los pares «nombre de parámetro = macro» se rellenan en los campos de debajo: a la izquierda el nombre que espera tu tracker, a la derecha nuestro macro. Un macro escrito en la propia URL no llegará a tu tracker como valor.
2. **Introduce cada macro exactamente como en la referencia.** Entre llaves, con las mismas mayúsculas y minúsculas y sin espacios dentro: {click_id}, {sumdep}. Una llave que falta o un espacio de más hace que el tracker reciba texto plano en lugar de un valor real.
3. **El primer parámetro tras ?, el resto tras &.** Un solo signo de interrogación por URL. Si tu tracker te dio un endpoint que ya contiene un ?, cada parámetro siguiente se une con &.
4. **Envía solo lo que uses.** Los parámetros de más no rompen la petición, pero complican la depuración. Empieza por click_id, la campaña y el importe del evento; añade el resto cuando lo necesites.

**Así se ve la petición terminada:**

```
https://tracker.example.com/postback?event=ftd&subid={click_id}&cid={cid}&payout={sumdep}
```

Así queda al enviarse. Tú la armas de otra manera: el endpoint y event=ftd van en el campo URL, y subid, cid y payout con sus macros van en los campos de parámetros de debajo.

## Partner Postback Bot

Postbacks sin tracker, directos a Telegram. El bot es el tracker. Elige los eventos, recibe las URL ya armadas con sus macros y pégalas en el panel: los registros, los depósitos y la comisión llegan a tu chat privado con el importe, la campaña y la etiqueta de la fuente.

- No necesitas un tracker propio
- Tres toques hasta las URL listas
- 9 eventos y 21 macros: la lista completa del panel
- Tu semana en un solo mensaje con /stats

[Abrir el bot en Telegram ↗](https://t.me/affpartnerpostbackbot) — Gratis. Responde en ruso, inglés, español, portugués y francés.

## 05. Constructor de postbacks

Pega el endpoint de tu tracker, marca los eventos y los parámetros, y el enlace se arma solo. Muestra cómo saldrá la petición. Pásalo al panel en dos partes: el endpoint al campo URL, y los pares «nombre = macro» a los campos de parámetros de debajo.

A la izquierda, el nombre del parámetro en tu tracker; a la derecha, el macro del sistema de afiliados. Renombra los parámetros para que encajen con tu tracker. Marca los eventos para los que necesitas postback. Cada uno recibe su propia URL, y la casilla de la derecha guarda el valor que se envía en el parámetro del evento.

## 06. Referencia de macros

La lista completa de macros disponibles. Escríbelos en la URL exactamente como aparecen aquí, llaves incluidas.

| Marcador | Qué transmite | Disponible para |
| --- | --- | --- |
| `{click_id}` | ID del clic en tu tracker | Todos los eventos |
| `{site_id}` | ID del sitio o de la fuente en tu tracker | Todos los eventos |
| `{cid}` | ID de campaña en Pocket Partners | Todos los eventos |
| `{ac}` | Nombre de la campaña en Pocket Partners | Todos los eventos |
| `{sub_id1}` | Etiqueta libre 1: cualquier valor que quieras pasar | Todos los eventos |
| `{sub_id2}` | Etiqueta libre 2: cualquier valor que quieras pasar | Todos los eventos |
| `{sub_id3}` | Etiqueta libre 3: cualquier valor que quieras pasar | Todos los eventos |
| `{sub_id4}` | Etiqueta libre 4: cualquier valor que quieras pasar | Todos los eventos |
| `{sub_id5}` | Etiqueta libre 5: cualquier valor que quieras pasar | Todos los eventos |
| `{trader_id}` | ID del trader | Todos los eventos |
| `{country}` | País del trader | Todos los eventos |
| `{device_type}` | Tipo de dispositivo: mobile, desktop o tablet | Todos los eventos |
| `{os_version}` | Sistema operativo del trader | Todos los eventos |
| `{browser}` | Navegador del trader | Todos los eventos |
| `{promo}` | Código promocional que usó el trader | Todos los eventos |
| `{link_type}` | Landing en Pocket Partners | Todos los eventos |
| `{date_time}` | Fecha y hora del evento | Todos los eventos |
| `{sumdep}` | Importe del depósito en USD | Primer depósito, Depósito repetido |
| `{wdr_sum}` | Importe del retiro en USD | Retiro, Nuevo retiro, Retiro cancelado, Retiro exitoso |
| `{status}` | Estado del retiro | Retiro, Nuevo retiro, Retiro cancelado, Retiro exitoso |
| `{commission}` | Importe de la comisión por trader | Comisión |

Las etiquetas libres {sub_id1}–{sub_id5} son tu espacio: úsalas para el creativo, el sitio, el geo o el número de test. El sistema las devuelve sin cambios.

## Auto-Postback

Nueve postbacks sin nueve pasadas por el formulario. La extensión se abre desde el icono de la barra, pregunta qué tracker usas y crea los postbacks en tu panel de partner, con los nombres de parámetro que ese tracker espera. La lista de parámetros la lee del propio panel, así que un macro añadido allí se recoge solo.

- Keitaro, Partner Postback Bot o cualquier otro receptor
- Los nombres de parámetro se ajustan a los que acepta tu tracker
- Cada URL se muestra entera antes de crear nada
- Sin servidor nuestro: nada sale del panel

[Instalar desde Chrome Web Store ↗](https://partner-bot.affpartners.io/ext/es) — Gratis. Chrome en un ordenador, con la sesión en la que tienes abierto el panel.

## 07. Comprobaciones antes del lanzamiento

Cinco minutos de comprobación ahorran una semana de discusiones sobre conversiones «perdidas». Repasa la lista antes de enviar tráfico.

- Haz una visita de prueba con tu enlace de afiliado y confirma que el tracker recibió una petición del evento que esperabas.
- Comprueba que {click_id} llega al tracker sin cambios: sin él el evento no puede vincularse a la visita.
- Si esperas eventos en el postback global, confirma que la campaña no tiene un postback local: el local anula al global.
- No envuelvas el enlace de afiliado en acortadores ni en redirecciones de terceros: parte de los parámetros después del ? se puede perder y el clic no se conectará con el evento.
- Para el evento de retiro, confirma con tu manager los valores exactos de {status}: la documentación muestra tanto pending / canceled / success como pending / approved / rejected.
- Recuerda el retraso de la comisión: llega una vez al día por el día anterior, en una petición aparte por cada trader.

Sobre el enlace de afiliado en sí y sus parámetros, mira la lección [Cómo trabajar con tu enlace de afiliado](https://playbook.affpartners.io/es/affiliate/lessons/affiliate-link-anatomy/).

## Seguridad y limitaciones

Solo para personas mayores de 21 años. Operar con instrumentos financieros implica un riesgo significativo y puede provocar la pérdida de los fondos invertidos. Los materiales de Affiliate Academy tienen fines exclusivamente educativos, no constituyen asesoramiento de inversión y no garantizan ganancias.

## Crece con GameChange Partners

[Explorar el programa de afiliados ↗](https://gamechange.partners/es?utm_source=academy&utm_medium=referral&utm_campaign=gcpacademy)