Docs

Push and pop networks

Spend import from push and pop advertiser networks, plus Zone Killer β€” rules that find (and, if you allow them, block) the zones burning money. Everything lives in one place: the Push/Pop networks card in βš™ β†’ Integrations, in the ad networks group next to Facebook / TikTok / Google costs.

Networks

NetworkSpend levelAPI key
AdMavencampaign Γ— zoneAdvertiser panel β†’ API section β†’ API token
PropellerAdscampaign Γ— zoneSSP β†’ Profile β†’ API token
Kadamcampaign Γ— zoneAdvertiser account β†’ API section β†’ API token
Galaxioncampaign Γ— zoneE-mail + password of the account (the tracker gets a token itself), or a ready API token
HilltopAdscampaign onlyMy Account β†’ API tab β†’ API key
Adsterracampaign onlySettings β†’ API tab β†’ Generate new token (only the newest token works)
Clickaducampaign onlyAdvertiser account β†’ API section β†’ API key

Networks marked campaign only do have a zone breakdown in their API, but its rows carry no campaign id β€” a zone there cannot be tied to the campaign whose clicks it bought. Their spend is spread over the campaign's clicks, and the connection card warns about this before you connect.

Connecting

Pick a network tile, paste the key, press Check connection β€” it shows the account's real balance β€” then save. Each connection has its own update interval; the buttons in the list: Update spend (now), pause, edit, delete. Already imported spend stays in the reports after a delete.

Sync runs in the same aggregator_cron.php pass as the other cost connections (see Costs): every pass re-reads the last 5 days, the first pass 30. Re-syncing a day is safe β€” spend is recalculated, not accumulated.

How spend lands on a click

The main requirement is the same as for Facebook or TikTok: the campaign must use the network's traffic source template, so the link passes the network's campaign id (into ad_campaign_id) and the zone id (the Keitaro source templates write it into source, the built-in PropellerAds template into zone). Without the zone macro spend still lands β€” but per campaign only, never split by zone.

Matching, from the most specific level to the broadest:

  1. campaign Γ— zone β€” a zone row is attributed only to clicks of the same day that carry both the zone id and the network campaign id. A bare zone id is not enough: zone ids are not unique across networks.
  2. campaign β€” a zone row whose zone matched no clicks sums onto the campaign's clicks without a zone (it never climbs onto clicks already priced by their own zone rows β€” several unmatched zones add up instead of overwriting each other).

The click parameter keys that count as "the zone": zone, zone_id, zoneid, sub_source_id.

If a sync answers "records received, but none could be attached to clicks", the campaign most likely does not use this network's source template β€” the link brings no campaign id to match on. The "Received N, matched 0" diagnostics from Costs apply here too.

Zone Killer

A card on the campaign editor's General tab (the campaign must be saved first). A rule binds the campaign to one push/pop cost connection and decides which zones are candidates:

Candidates are computed from clicks.cost / clicks.revenue per zone β€” the same distributed numbers the reports show, with the same zone keys the cost import matched on, so a rule can never judge a zone the importer priced differently.

Blocking goes through the network's write API for AdMaven, HilltopAds, PropellerAds, Kadam and Galaxion. Adsterra and Clickadu have no usable zone write API: their rules stay dry-run, and the card copies the selected zone ids so you can paste them into the network's blacklist by hand.

Every block and unblock β€” manual or automatic β€” lands in an append-only journal with the metrics that stood behind the decision; the current blocked set is a zone whose latest successful action is "block". The journal is rendered under the rule.

For campaign only networks (HilltopAds, Adsterra, Clickadu) Zone Killer judges zones approximately β€” by their share of the campaign's clicks, because the API gives no per-zone spend. Keep their rules in dry-run and check the list before blocking.

Cron

*/15 * * * * php /var/www/orbitra/aggregator_cron.php >> /var/www/orbitra/var/logs/aggregator.log 2>&1
*/30 * * * * php /var/www/orbitra/zone_rules_cron.php  >> /var/www/orbitra/var/logs/zone_rules.log 2>&1

The first line is the cron the installer adds for cost sync. The second one β€” the Zone Killer executor β€” you add yourself, and only if you use auto rules; a pass is cheap (a rule with no candidates is a single GROUP BY over the campaign's clicks). Flags: --campaign=12 (one campaign), --quiet.

← Previous
Costs
Next β†’
Facebook / Meta
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 β†’