Docs

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ámetroObligatorioSignificado
subidsíEl click ID del tracker — lo que la red recibió en {subid} / {clickid}
statusnoEstado de la conversión: lead, sale, rejected, registration, deposit, trash, o cualquiera personalizado
payoutnoImporte del payout
currencynoMoneda del payout
tidnoID de transacción — para conversiones repetidas en el mismo clic
sub_id_NnoValores adicionales
<type>_statusnoMapea 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:

  1. Los tipos de conversión de Settings → Conversion Types — si el estado está en la lista de valores de un tipo.
  2. Un tipo incorporado con el mismo nombre.
  3. La regla <type>_status=… del propio postback.
  4. Alias incorporados: approved, confirmed, accepted, converted → sale; declined, refused, cancelled, canceled → rejected.
  5. 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:

⚠️ 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:

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
← Anterior
PWA externas y canales de Telegram
Siguiente →
Costos
Ver el código en GitHub: github.com/fenjo26/Orbitra.link/wiki
Todas las guías
Docs

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 →
Docs

Instalació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 →
Docs

Migrar 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 →
Docs

Migrar 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 →
Docs

Resumen de funciones

Todo lo que Orbitra puede hacer: campañas y flujos, cloaking, landings, PWA, postbacks, costos, informes e integraciones.

Leer la guía →
Docs

Campañ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 →
Docs

Cloaking: referencia completa

Referencia completa del cloaking: capas de detección, sensibilidad, ajustes globales, veredictos, motivos e informes.

Leer la guía →
Docs

Browser 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 →
Docs

Landing pages (referencia)

Tipos de landing, la macro {offer}, el adaptador JS, LeadForge y landings multi-oferta — la referencia completa.

Leer la guía →
Docs

PWA 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 →
Docs

Embudo 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 →
Docs

Popups 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 →
Docs

Grabaciones 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 →
Docs

Content 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 →
Docs

Biblioteca 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 →
Docs

PWA 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 →
Docs

Postbacks y conversiones

Postbacks entrantes, estados y tipos de conversión, y postbacks S2S salientes hacia tu fuente de tráfico.

Leer la guía →
Docs

Costos

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 →
Docs

Redes 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 →
Docs

Facebook / Meta

Importación de costos desde Meta Ads y Conversions API: eventos del lado del servidor con deduplicación.

Leer la guía →
Docs

Dolphin / 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 →
Docs

FB 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 →
Docs

Fuentes 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 →
Docs

Informes, 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 →
Docs

Dominios 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 →
Docs

Cloudflare

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 →
Docs

Administración

Usuarios, roles y permisos, ajustes de seguridad y privacidad, bases de datos geo, actualizaciones y estado del sistema.

Leer la guía →
Docs

Bot de Telegram

Gestiona el tracker desde Telegram: estadísticas, conversiones y alertas en el chat, con webhook o polling.

Leer la guía →
Docs

MCP: 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 →