Postbacks y conversiones
Una conversión llega a Orbitra como un postback de la red de afiliados y se adjunta a un clic por su ID (subid). El tracker puede entonces reenviarla a la fuente de tráfico (un postback S2S saliente) y a la Conversions API de la plataforma de anuncios.
Postback entrante
La dirección del postback es ⚙ → Postback URL. Se ve así:
https://your-domain/<postback_key>/postback
El postback_key es la clave secreta de la instalación (protección contra conversiones falsas). Si todavía es igual al valor público por defecto del repositorio, el panel te avisa; genera uno nuevo en la misma página o con php cli/generate_postback_key.php. El instalador genera su propia clave.
Parámetros
| Parámetro | Obligatorio | Significado |
|---|---|---|
subid | sí | El click ID del tracker — lo que la red recibió en {subid} / {clickid} |
status | no | Estado de la conversión: lead, sale, rejected, registration, deposit, trash, o cualquiera personalizado |
payout | no | Importe del payout |
currency | no | Moneda del payout |
tid | no | ID de transacción — para conversiones repetidas en el mismo clic |
sub_id_N | no | Valores adicionales |
<type>_status | no | Mapea estados directamente en la URL: sale_status=approved,confirmed |
Ejemplos:
…/postback?subid={subid}&status=lead
…/postback?subid={subid}&status=sale&payout={payout}
…/postback?subid={subid}&status=sale&payout={payout}&tid={transaction_id}
…/postback?subid={subid}&status={status}&sale_status=approved,confirmed
Si la red nombra sus parámetros distinto, configura alias de parámetros en la misma página.
Respuestas
200 — la conversión se registra. 4xx — la petición se rechaza (clave equivocada, clic desconocido). 500 / 503 — un error de escritura; la red debería reintentar el postback. La conversión, sus contadores y los eventos de la Conversions API se escriben en una sola transacción: un error nunca puede producir un "200 y un evento perdido".
Cómo se determina el estado
En orden:
- Los tipos de conversión de Settings → Conversion Types — si el estado está en la lista de valores de un tipo.
- Un tipo incorporado con el mismo nombre.
- La regla
<type>_status=…del propio postback. - Alias incorporados:
approved,confirmed,accepted,converted→sale;declined,refused,cancelled,canceled→rejected. - En cualquier otro caso —
custom.
Los estados que no coincidieron con ningún tipo se listan en Settings → Conversion Types → Unmapped statuses: ahí puedes mapearlos a un tipo, y las conversiones ya registradas se reclasifican.
Tipos de conversión
Cada tipo tiene: un nombre, una lista de estados de la red, un color de etiqueta y cuatro banderas — cuenta para "Conversions", cuenta para "Profit", envía S2S a la fuente, cuenta para el Cap de la oferta. Existe de fábrica un tipo Revshare (el estado revshare va solo a ganancia: no crea conversión nueva, ni S2S, ni Cap).
Payouts en otra moneda
El payout se convierte a la moneda base del tracker (tasas en core/CurrencyRates.php). El importe original, la moneda y la tasa se guardan en el clic. Las macros del postback saliente {payout} / {currency} llevan el valor en la moneda base; los originales son {fx_orig_payout} / {fx_orig_currency}. Un par de monedas desconocido se registra tal cual.
Log de postbacks entrantes
⚙ → Logs → Postbacks — cada petición entrante con su desenlace: si se encontró el clic, el estado resultante, el importe. El click ID abre la tarjeta del clic.
Postbacks S2S salientes (hacia la fuente de tráfico)
Se configuran en la campaña, en la pestaña S2S Postbacks. Cada postback es una tarjeta: URL, método GET o POST, chips de estado (sale, lead, rejected, registration, deposit, trash más los personalizados). El menú "insertar macro" inserta una macro en la posición del cursor.
Si la fuente de tráfico elegida tiene un postback_url configurado, una campaña con la lista vacía lo recibe automáticamente. Si ya hay postbacks configurados, arriba de la pestaña aparece una pista con un botón de "añadir".
El filtro de estado deja pasar una conversión si coincidió el estado interno (sale), la palabra propia de la red (approved), o el chip heredado custom para palabras que ahora reconocen los alias.
Macros
{subid} (también {clickid}, {click_id}), {status}, {payout} (también {conversion_revenue}), {currency}, {tid} (también {external_id}), {campaign_id}, {offer_id}, {cost}, {revenue}, {profit}, y cualquier parámetro de clic guardado por su nombre: {sub_id_1} … {sub_id_30}, {fx_orig_payout}, {fx_orig_currency}, etc.
{status} lleva el estado interno (sale), no la palabra original de la red. Para traducirlo al vocabulario de la fuente, usa una transformación al estilo Keitaro: {status: sale=purchase lead=lead} — un estado que no esté en la lista pasa sin cambios.
Cola de entrega
Los postbacks salientes no se envían en el momento de la conversión — entran en la cola s2s_postbacks_log, y el cron postback_queue_cron.php (una vez por minuto) los entrega con reintentos:
- éxito — HTTP 2xx–3xx;
- reintentos: 60 s → 5 min → 30 min → 2 h → 24 h, tras lo cual la fila se marca
failed; - comprobación SSRF al encolar y antes de enviar: una dirección en una red privada recibe
failedde inmediato; - una fila dejada en
in_flightpor un worker caído vuelve a la cola a los 10 minutos.
⚠️ Sin el cron, la cola nunca se procesa. El instalador lo configura; para comprobarlo o añadirlo a mano — Settings → Automation → Postback Queue. Actualizar desde el panel también restaura un cron faltante.
Log de la cola: ⚙ → Logs → S2S (estado, intentos, próximo intento, último error, código HTTP).
Probador de postbacks
El botón de la pestaña S2S Postbacks (solo admin) envía un postback real a este mismo servidor con un clic de un solo uso y muestra un veredicto para cada paso:
- con qué estado se registró la conversión;
- si el filtro de estado de cada postback S2S lo deja pasar — y por qué: por estado interno, por la palabra de la red, o por el chip heredado;
- una entrega de prueba a la fuente: código HTTP y tiempos;
- macros que no se resolverían e irían a la fuente como texto plano (
{external_id},{sub_id_N}); - placeholders de la plantilla de la fuente (
bbg=xxx,[YOUR_…]); - si el worker de la cola está vivo y el cron está instalado.
El clic de prueba, la conversión y las filas de cola se borran tras la comprobación.
Reenviar conversiones perdidas
El botón "Re-send missed conversions" encola las conversiones de las últimas 72 horas que pasan el filtro actual pero nunca llegaron a la cola. Pulsarlo otra vez no duplica nada.
Importación de conversiones
⚙ → Conversion Import — sube un archivo o pega una lista de click IDs cuando la red no puede enviar postbacks, o cuando hay que restaurarlos.
Conversions API
El envío de conversiones a los servidores de Meta y TikTok se configura en el perfil de píxel y en la campaña (la pestaña "Integrations"). Para detalles sobre Meta, ver Facebook / Meta. Los eventos se encolan junto con la conversión y se entregan con confirmación: éxito solo con una respuesta 2xx donde events_received coincide con el tamaño del lote.
Monitoreo
conversion_monitor_cron.php calcula la proporción de postbacks fallidos sobre una ventana (60 minutos por defecto) y, cuando se supera el umbral (10 %), escribe una alerta en var/logs/conversion_alerts.log; el envío de la alerta a Telegram aún no está implementado. El instalador no configura este cron — añádelo si lo necesitas:
*/5 * * * * php /var/www/orbitra/conversion_monitor_cron.php --quiet
Inicio rápido: tu primera campaña
El camino corto: instala el tracker, crea la red, la oferta y la campaña, y consigue tus primeros clics y conversiones en menos de una hora.
Leer la guía →DocsInstalación y actualizaciones
Instala Orbitra en un servidor Ubuntu o Debian recién creado con un solo comando, actualiza PHP y las versiones nuevas de forma segura.
Leer la guía →DocsMigrar desde Keitaro
Mueve campañas, ofertas, fuentes y dominios de Keitaro a Orbitra con un dump SQL — qué se transfiere y qué revisar después.
Leer la guía →DocsMigrar desde Binom
Mueve campañas y flujos de Binom v2 a Orbitra vía su Public API — qué se transfiere automáticamente y qué se ajusta a mano.
Leer la guía →DocsResumen de funciones
Todo lo que Orbitra puede hacer: campañas y flujos, cloaking, landings, PWA, postbacks, costos, informes e integraciones.
Leer la guía →DocsCampañas y flujos
La referencia completa: ajustes de campaña, tipos de flujo, esquemas, rotación, filtros, test links y cada opción explicada.
Leer la guía →DocsCloaking: referencia completa
Referencia completa del cloaking: capas de detección, sensibilidad, ajustes globales, veredictos, motivos e informes.
Leer la guía →DocsBrowser check
Cómo el check JS atrapa bots, VMs y emuladores por contradicciones del navegador: modos Off / Observe / Soft / Strict y sus signos.
Leer la guía →DocsLanding pages (referencia)
Tipos de landing, la macro {offer}, el adaptador JS, LeadForge y landings multi-oferta — la referencia completa.
Leer la guía →DocsPWA y Web Push
Crea apps PWA instalables y tu propia base de suscriptores push: constructor, claves VAPID, mensajes, atribución y solución de problemas.
Leer la guía →DocsEmbudo de PWA
Cómo funciona el embudo configurable de una PWA: pasos y tipos de pantalla, tracking por pantalla, estadísticas del embudo y vista previa en el editor.
Leer la guía →DocsPopups de conversión
Muestra conversiones reales como popups en tus landings: activación por campaña, plantillas por vertical, disparadores y ubicación.
Leer la guía →DocsGrabaciones de sesión y mapas de calor
Reproduce visitas reales y consulta el mapa de calor de clics y de scroll. Límites de almacenamiento y notas de privacidad.
Leer la guía →DocsContent Gallery (referencia)
Almacenamiento central de iconos, capturas y creativos usados en PWAs y landings: carpetas, límites y el MediaPicker en los editores.
Leer la guía →DocsBiblioteca de creativos
Almacena creativos con tracking de subid y pruébalos en distintas campañas: métricas por creativo sincronizadas con Facebook y TikTok.
Leer la guía →DocsPWA externas y canales de Telegram
Publica PWAs en dominios externos y usa canales de Telegram como fuente de tráfico con suscriptores atribuidos.
Leer la guía →DocsPostbacks y conversiones
Postbacks entrantes, estados y tipos de conversión, y postbacks S2S salientes hacia tu fuente de tráfico.
Leer la guía →DocsCostos
Importa el gasto de Facebook, TikTok y Google Ads, o actualízalo por API y cron — y cómo funciona el agregador de ingresos.
Leer la guía →DocsRedes push y pop
Trabajo con fuentes de tráfico push y pop: importación de gasto por campaña y zona, optimización de zonas y el Zone Killer.
Leer la guía →DocsFacebook / Meta
Importación de costos desde Meta Ads y Conversions API: eventos del lado del servidor con deduplicación.
Leer la guía →DocsDolphin / Fbtool
Recibe los costos de Facebook vía la API de Dolphin (Fbtool) en tiempo real: clave de API, configuración de cada servicio y cómo se reparte el gasto entre los clics.
Leer la guía →DocsFB Comment Cleaner
Modera en bloque los comentarios bajo tus anuncios de Meta: ocultar, borrar y filtrar por palabras clave, con dry run, journal y auto-pausa.
Leer la guía →DocsFuentes de tráfico y redes de afiliados
Los dos directorios que configuran los bordes del embudo: plantillas y parámetros de fuentes y redes, postback global, macros de oferta y LeadForge.
Leer la guía →DocsInformes, logs y métricas
El constructor de informes, tendencias y cohortes, el log de tráfico y la tarjeta del clic, más la definición de cada métrica.
Leer la guía →DocsDominios y SSL
Añade dominios, apunta el DNS y emite certificados Let's Encrypt gratis: ajustes del dominio, modos SSL, registrars conectados y Backorder.
Leer la guía →DocsCloudflare
Cómo pasar los dominios de campaña por Cloudflare vía API: token, parking automático del registro A, modos SSL de zona y proxy.
Leer la guía →DocsAdministración
Usuarios, roles y permisos, ajustes de seguridad y privacidad, bases de datos geo, actualizaciones y estado del sistema.
Leer la guía →DocsBot de Telegram
Gestiona el tracker desde Telegram: estadísticas, conversiones y alertas en el chat, con webhook o polling.
Leer la guía →DocsMCP: un asistente de IA en el tracker
Conecta Claude o cualquier cliente MCP a Orbitra y maneja campañas con comandos en lenguaje natural: claves de API, conexión y seguridad.
Leer la guía →