Guía

Postbacks: qué decirle a tu gestor de afiliados

Qué es un postback

Cuando un visitante compra en el sitio del anunciante, la venta se registra en la red de afiliados, no en tu tracker. Un postback es la red avisando a tu tracker: una breve petición servidor-a-servidor como

https://track.example.com/a7f3c91e/postback?subid=0bc4ba11-688d-4de0-98b4-8b0d6e81cef&status=sale&payout=30

Dice: "el clic 0bc4ba11… convirtió, estado sale, ganas 30". Orbitra encuentra ese clic y desde entonces sabe qué campaña, flujo, oferta, país, anuncio y creativo produjo el dinero.

Sin postbacks el tracker cuenta clics pero nunca ve una sola conversión, así que ingresos, ganancia, ROI y CR se quedan en cero.

Cómo el click ID hace el viaje de ida y vuelta

1. Visitor clicks your ad → Orbitra creates click 0bc4ba11…
2. Orbitra redirects to the offer:  https://network/offer?aff=777&sub1=0bc4ba11…
                                                              ▲ added by the network's "offer parameters"
3. The network remembers sub1 for this visitor
4. Visitor buys → the network calls your postback URL and puts sub1 back:
       https://track.example.com/a7f3c91e/postback?subid=0bc4ba11…&status=sale&payout=30
5. Orbitra marks click 0bc4ba11… as a conversion

Dos ajustes lo hacen funcionar:

Si creaste la red desde una plantilla, ambas mitades ya usan los nombres correctos.

Dónde encontrar tu postback URL

La página de ajustes de postback
La página de ajustes de postback

Los parámetros que Orbitra entiende:

ParámetroObligatorioSignificado
subidsíEl click ID de Orbitra — lo que la red recibió en sub1 (o en el campo que hayas elegido)
statusnolead, sale, rejected, trash, registration, deposit, o la palabra de la propia red (approved, pending, declined…)
payoutnoCuánto ganas por esta conversión
currencynoSi la red paga en otra moneda — se convierte a la moneda del tracker
tidnoID de transacción, necesario cuando un clic puede traer varias conversiones (p. ej. depósitos repetidos)

Las palabras de la red para los estados se traducen automáticamente (approved, confirmed → sale; declined, cancelled → rejected). Puedes mapear cualquier otra palabra directamente en la URL: &sale_status=approved,paid&lead_status=pending. Las palabras que Orbitra no reconozca aparecen en ⚙ → Settings → Conversion Types → Unmapped statuses, donde puedes asignarlas.

Qué enviarle a tu gestor de afiliados

La mayoría de las redes te configuran el postback si lo pides. Envía algo así (reemplaza la URL por la tuya):

¡Hola! Por favor, configuren un postback global para mi cuenta (todas las ofertas):
https://track.example.com/a7f3c91e/postback?subid={sub1}&status={status}&payout={payout}
- Mi click ID viaja en sub1 del enlace de oferta — devuélvanlo en subid.
- Envíen postbacks de todos los estados: lead nuevo (hold/pending), aprobado, rechazado y trash, con el payout para los aprobados.
- El método GET está bien.
¿Podrían decirme también sus nombres de macro para el click ID, el estado y el payout, si difieren de {sub1}, {status}, {payout}? ¡Gracias!

Qué revisar en su respuesta:

  1. Qué campo lleva tu click ID. Si dicen "usa aff_sub", cambia los parámetros de oferta de la red en Orbitra a &aff_sub={subid} y el postback a subid={aff_sub}.
  2. Su sintaxis de macros. {sub1}, [SUB1], %sub1%, {{sub1}} — copia exactamente lo que usan.
  3. Palabras de estado. Si envían status=1/2/3 o palabras en ruso, mapea con &sale_status=…&lead_status=…&rejected_status=… o en Conversion Types.
  4. Por oferta vs global. Un postback global cubre todas las ofertas; un postback por oferta debe añadirse a cada oferta por separado.

Cómo probarlo

  1. Haz un clic real por el enlace de la campaña (o usa un clic de ⚙ → Logs → Traffic) y copia su click ID.
  2. ⚙ → Postback URL → Test Postback: pega el click ID, elige un estado, pulsa Test.
Probando un postback
Probando un postback
  1. Abre ⚙ → Conversions — la conversión está ahí y los contadores de la campaña cambian.

Muchas redes también tienen un botón de "test postback" que dispara una petición con un sub1 falso. Orbitra responde "click not found" — es lo esperado; demuestra que la URL es alcanzable.

El registro de conversiones
El registro de conversiones

⚙ → Logs → Incoming Postbacks lista cada petición que llegó, incluidas las rechazadas, con su motivo. Es el primer lugar donde mirar cuando "la red dice que envió y el tracker no muestra nada".

Devolver conversiones a la fuente de tráfico (S2S)

Algunas fuentes de tráfico (redes push y pop, TikTok, algunas redes nativas) optimizan mejor cuando reciben tus conversiones. Eso es un postback saliente, configurado en la pestaña S2S Postbacks de la campaña. Si la plantilla de la fuente de tráfico tiene una postback URL, una campaña nueva la recibe automáticamente. El botón Run test de ahí comprueba toda la cadena. Facebook y TikTok usan en su lugar su Conversions API — ver Facebook / Meta.

La pestaña S2S Postbacks de la campaña
La pestaña S2S Postbacks de la campaña

Solución de problemas

SíntomaDónde mirar
Nada en Incoming PostbacksLa red nunca te llamó: URL equivocada en su panel, o el postback está configurado por oferta para otra oferta
"Click not found"El click ID no se está pasando: revisa los parámetros de oferta de la red y la macro en el postback
"Wrong key"La URL contiene una postback key antigua. Una red creada antes de que cambiaras la clave conserva la clave vieja en su Postback URL guardada — corrige la clave en esa URL (editor de la red) y actualízala en el panel de la red
Conversión registrada con estado customLa palabra de estado de la red no está mapeada — corrígela en Conversion Types
El payout es 0La red no sustituye {payout}, o lo envía con otro nombre — añade un alias de parámetro en la página Postback

Referencia: Postbacks and conversions.

← Anterior
Ofertas y redes de afiliados
Siguiente →
Flujos: cómo se distribuye el tráfico
Ver el código en GitHub: github.com/fenjo26/Orbitra.link/wiki
Todas las guías
Guía

Guía para principiantes: empieza aquí

Un recorrido por Orbitra pantalla por pantalla: qué hace el tracker, las palabras que vas a encontrar y el orden para leer las guías.

Leer la guía →
Guía

Tu primera campaña, paso a paso

De una instalación recién hecha a un enlace de campaña funcionando y una conversión de prueba: dominio, red, oferta, fuente, campaña, postback.

Leer la guía →
Guía

Conectar un dominio

Añade un dominio, apunta el DNS al tracker, obtén un certificado SSL gratuito y qué hace cada interruptor de la página Domains.

Leer la guía →
Guía

Ofertas y redes de afiliados

Cómo se organizan las ofertas y las redes en Orbitra: plantillas, parámetros de oferta y ajustes de payout.

Leer la guía →
Guía

Postbacks: qué decirle a tu gestor de afiliados

Cómo llegan las conversiones a Orbitra: la postback URL, los estados y qué copiar y pegar a tu red.

Leer la guía →
Guía

Flujos: cómo se distribuye el tráfico

Qué es un flujo, los esquemas, la rotación y los pesos, y cómo decide Orbitra a dónde va un clic.

Leer la guía →
Guía

Filtros de flujo

País, dispositivo, ISP, bots y más: cada filtro explicado con ejemplos de configuraciones de enrutamiento habituales.

Leer la guía →
Guía

Cloaking para principiantes

Página segura vs money page, niveles de filtro, sensibilidad y cómo probar tu cloak antes de enviar tráfico real.

Leer la guía →
Guía

Landing pages

Aloja landings dentro del tracker: tipos de landing, la macro {offer}, el adaptador JS y los píxeles de tracking.

Leer la guía →
Guía

Apps PWA

Crea una PWA instalable desde una landing: icono, capturas, ficha de tienda y límites.

Leer la guía →
Guía

Notificaciones push a usuarios de PWA

Reúne suscriptores push desde landings PWA y envíales notificaciones — tráfico de re-activación gratis.

Leer la guía →
Guía

Content Gallery

Guarda iconos, capturas y creativos en el tracker y reúsalos en tus PWA y landings.

Leer la guía →
Guía

Creatives y pruebas de creativos

Sabe de qué creativo vino cada clic: enrutamiento por subid, una campaña de prueba y cómo leer el informe.

Leer la guía →