Módulo 11 · Postbacks
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.
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.
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.
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 retiroAlternativa | El trader creó una solicitud de retiro: el estado pending como evento propio. |
| Retiro canceladoAlternativa | La solicitud de retiro se canceló: el estado canceled como evento propio. |
| Retiro exitosoAlternativa | 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.
- La dirección va en el campo URL, los macros en los campos de abajoEl 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.
- Introduce cada macro exactamente como en la referenciaEntre 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.
- 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 &.
- Envía solo lo que usesLos 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.
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.
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.
EventosMarca 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.
Parámetros de la peticiónA 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.
Pega tu endpoint y aquí aparecerán las URL terminadas.
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 | Eventos de depósito |
{wdr_sum} | Importe del retiro en USD | Todos los eventos de retiro |
{status} | Estado del retiro | Todos los eventos de retiro |
{commission} | Importe de la comisión por trader | Evento de 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.
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.
Sobre el enlace de afiliado en sí y sus parámetros, mira la lección Cómo trabajar con tu enlace de afiliado.