Docs

Postbacks and conversions

A conversion reaches Orbitra as a postback from the affiliate network and is attached to a click by its ID (subid). The tracker can then forward it to the traffic source (an outgoing S2S postback) and to the ad platform's Conversions API.

Incoming postback

The postback address is βš™ β†’ Postback URL. It looks like this:

https://your-domain/<postback_key>/postback

postback_key is the installation's secret key (protection against fake conversions). If it still equals the public default value from the repository, the panel warns you; generate a new one on the same page or with php cli/generate_postback_key.php. The installer generates its own key.

Parameters

ParameterRequiredMeaning
subidyesTracker click ID β€” what the network received in {subid} / {clickid}
statusnoConversion status: lead, sale, rejected, registration, deposit, trash, or any custom one
payoutnoPayout amount
currencynoPayout currency
tidnoTransaction ID β€” for repeated conversions on the same click
sub_id_NnoAdditional values
<type>_statusnoMap statuses right in the URL: sale_status=approved,confirmed

Examples:

…/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

If the network names its parameters differently, set up parameter aliases on the same page.

Responses

200 β€” the conversion is recorded. 4xx β€” the request is rejected (wrong key, unknown click). 500 / 503 β€” a write error; the network should retry the postback. The conversion, its counters and the Conversions API events are written in a single transaction: an error can never produce a "200 and a lost event".

How the status is determined

In order:

  1. Conversion types from Settings β†’ Conversion Types β€” if the status is in a type's value list.
  2. A built-in type with the same name.
  3. The <type>_status=… rule from the postback itself.
  4. Built-in aliases: approved, confirmed, accepted, converted β†’ sale; declined, refused, cancelled, canceled β†’ rejected.
  5. Otherwise β€” custom.

Statuses that did not match any type are listed under Settings β†’ Conversion Types β†’ Unmapped statuses: you can map them to a type there, and already recorded conversions get reclassified.

Conversion types

Each type has: a name, a list of statuses from the network, a label color, and four flags β€” counts toward "Conversions", counts toward "Profit", send S2S to the source, counts toward the offer Cap. A Revshare type exists out of the box (the revshare status goes into profit only: no new conversion, no S2S, no Cap).

Payouts in another currency

The payout is converted to the tracker's base currency (rates in core/CurrencyRates.php). The original amount, currency and rate are stored on the click. The outgoing postback macros {payout} / {currency} carry the value in the base currency; the original ones are {fx_orig_payout} / {fx_orig_currency}. An unknown currency pair is recorded as is.

Incoming postback log

βš™ β†’ Logs β†’ Postbacks β€” every incoming request with its outcome: whether the click was found, the resulting status, the amount. The click ID opens the click card.

Outgoing S2S postbacks (to the traffic source)

Configured in the campaign, on the S2S Postbacks tab. Each postback is a card: URL, GET or POST method, status chips (sale, lead, rejected, registration, deposit, trash plus custom ones). The "insert macro" menu inserts a macro at the cursor position.

If the selected traffic source has a postback_url set, a campaign with an empty list receives it automatically. If postbacks are already configured, a hint with an "add" button appears at the top of the tab.

The status filter passes a conversion through if the internal status matched (sale), the network's own word (approved), or the legacy custom chip for words that are now recognized by aliases.

Macros

{subid} (also {clickid}, {click_id}), {status}, {payout} (also {conversion_revenue}), {currency}, {tid} (also {external_id}), {campaign_id}, {offer_id}, {cost}, {revenue}, {profit}, and any saved click parameter by name: {sub_id_1} … {sub_id_30}, {fx_orig_payout}, {fx_orig_currency}, etc.

{status} carries the internal status (sale), not the network's original word. To translate it into the source's vocabulary, use a Keitaro-style transformation: {status: sale=purchase lead=lead} β€” a status not in the list goes through unchanged.

Delivery queue

Outgoing postbacks are not sent at the moment of conversion β€” they go into the s2s_postbacks_log queue, and the postback_queue_cron.php cron (once a minute) delivers them with retries:

⚠️ Without the cron, the queue is never processed. The installer sets it up; to check or add it manually β€” Settings β†’ Automation β†’ Postback Queue. Updating through the panel also restores a missing cron.

Queue log: βš™ β†’ Logs β†’ S2S (status, attempts, next attempt, last error, HTTP code).

Postback tester

The button on the S2S Postbacks tab (admin only) sends a real postback to this same server with a one-off click and shows a verdict for every step:

The test click, conversion and queue rows are deleted after the check.

Re-sending missed conversions

The "Re-send missed conversions" button enqueues conversions from the last 72 hours that pass the current filter but never made it into the queue. Pressing it again duplicates nothing.

Conversion import

βš™ β†’ Conversion Import β€” upload a file or paste a list of click IDs when the network cannot send postbacks, or when they need to be restored.

Conversions API

Sending conversions to Meta and TikTok servers is configured in the pixel profile and in the campaign (the "Integrations" tab). For details on Meta, see Facebook / Meta. Events are enqueued together with the conversion and delivered with confirmation: success only on a 2xx response where events_received matches the batch size.

Monitoring

conversion_monitor_cron.php computes the failed-postback share over a window (60 minutes by default) and, when the threshold (10%) is exceeded, writes an alert to var/logs/conversion_alerts.log; sending the alert to Telegram is not implemented yet. The installer does not set up this cron β€” add it if needed:

*/5 * * * * php /var/www/orbitra/conversion_monitor_cron.php --quiet
← Previous
External PWA and Telegram channels
Next β†’
Costs
View source on GitHub: github.com/fenjo26/Orbitra.link/wiki
All guides
Docs

Quick start: your first campaign

The short path: install the tracker, create a campaign, and get your first clicks and conversions in under an hour.

Read guide β†’
Docs

Installation and updates

Install Orbitra on a fresh Ubuntu or Debian server with one command, and update to new versions safely.

Read guide β†’
Docs

Migrating from Keitaro

Move campaigns, offers, sources and domains from Keitaro to Orbitra in one click β€” what transfers and what to check.

Read guide β†’
Docs

Migrating from Binom

Move campaigns and streams from Binom to Orbitra: what transfers automatically and what to set up by hand.

Read guide β†’
Docs

Feature overview

Everything Orbitra can do: campaigns and streams, cloaking, landings, PWA, postbacks, costs, reports and integrations.

Read guide β†’
Docs

Campaigns and streams

The complete reference: campaign settings, stream types, schemas, rotation, filters, test links and every option explained.

Read guide β†’
Docs

Cloaking

Full cloaking reference: detection layers, global settings, per-stream filters, verdicts and reports.

Read guide β†’
Docs

Browser check

How the JS check catches bots, VMs and emulators through contradictions in the browser environment.

Read guide β†’
Docs

Landing pages

Landing types, the {offer} macro, the JS adapter, LeadForge and multi-offer landings β€” the complete reference.

Read guide β†’
Docs

PWA and Web Push

Build installable PWA apps and collect push subscribers: settings, icons, events and notifications.

Read guide β†’
Docs

PWA Funnel

A multi-step PWA funnel: install prompts, event tracking and re-engagement notifications.

Read guide β†’
Docs

Conversion popups

Show real conversion events as on-page popups: setup, triggers and placement.

Read guide β†’
Docs

Session recordings and heatmaps

Replay real visits and see click and scroll maps. Storage limits and privacy notes.

Read guide β†’
Docs

Content gallery

Central storage for icons, screenshots and creatives used across PWAs and landings.

Read guide β†’
Docs

Creatives library

Store creatives with subid tracking and test them across campaigns.

Read guide β†’
Docs

External PWA and Telegram channels

Publish PWAs to external domains and run Telegram channels as a traffic source.

Read guide β†’
Docs

Postbacks and conversions

Incoming postbacks, conversion statuses and types, and outgoing S2S postbacks to your traffic source.

Read guide β†’
Docs

Costs

Import spend from Facebook, TikTok and Google Ads, or update it via API and cron β€” and how the revenue aggregator works.

Read guide β†’
Docs

Push and pop networks

Working with push and pop traffic sources: feeds, zone optimization and the zone killer.

Read guide β†’
Docs

Facebook / Meta

Cost import from Meta Ads and the Conversions API: server-side events with deduplication.

Read guide β†’
Docs

Dolphin / Fbtool

Receive Facebook costs through the Dolphin (Fbtool) API in real time.

Read guide β†’
Docs

FB comment cleaner

Bulk-moderate comments under Meta ads: hide, delete and filter by keywords.

Read guide β†’
Docs

Traffic sources and affiliate networks

Catalog of 50+ traffic sources and 440+ networks: templates, parameters and postback URLs.

Read guide β†’
Docs

Reports, logs and metrics

The report builder, saved reports, click logs and every metric explained.

Read guide β†’
Docs

Domains and SSL

Add domains, DNS, free Let's Encrypt certificates, redirects, parking and every switch on the page.

Read guide β†’
Docs

Cloudflare

How to run campaign domains through Cloudflare: DNS, SSL modes and what to turn off.

Read guide β†’
Docs

Administration

Users, roles and permissions, security settings, geo databases, updates and system health.

Read guide β†’
Docs

Telegram bot

Manage the tracker from Telegram: stats, conversions and alerts in chat.

Read guide β†’
Docs

MCP: an AI assistant in the tracker

Connect Claude or any MCP client to Orbitra and manage campaigns with plain-language commands.

Read guide β†’