Guide

Your first campaign, step by step

This guide takes you from a freshly installed tracker to a working campaign link and a test conversion. It uses one realistic example all the way through:

Each step takes a few minutes. Install the tracker first: Installation and updates.

Step 1. Create the administrator

Open http://<your-server-ip>/admin.php. On the first visit Orbitra starts a three-step wizard: create the admin user (login of at least 3 characters, password of at least 8), then pick your time zone and interface language.

First-run wizard: create the administrator
First-run wizard: create the administrator

The time zone matters: "today" and "yesterday" in every report are counted in it. You can change it later under βš™ β†’ Users β†’ Profile.

Step 2. Install a geo database

On the dashboard you will see a yellow banner "No geo database installed". Press Install Sypex Geo (free). Without a geo database the tracker cannot tell which country a visitor is from, so country filters and country cloaking will not work.

The banner that asks for a geo database
The banner that asks for a geo database

Sypex is enough to start. For better cloaking add the free MaxMind and IP2Location databases later β€” see Geo databases.

Step 3. Change the postback key

Open βš™ β†’ Postback URL. If you see the warning "Your postback key is the public default", replace the key: type any random string of letters and digits into Postback Key (or generate one on the server with php cli/generate_postback_key.php) and press Save settings.

The postback page warns about the default key
The postback page warns about the default key

The key is part of the address networks send conversions to. With the public default anyone could post fake conversions to your tracker. Do this before you add affiliate networks: a network saves the postback URL with the key that was current when you created it, so after a later change you would have to fix the URL in every network and in every network dashboard.

Step 4. Add a domain

Campaign links look much better (and survive ad reviews longer) on your own domain than on a bare IP.

  1. Domains β†’ Add domain, type the domain, e.g. go.example.com, press Add.
  2. At your registrar or DNS provider, create an A record for that domain pointing to the server IP shown at the top of the Domains page.
  3. Wait: Orbitra checks DNS and issues a free Let's Encrypt certificate by itself.
Adding a domain
Adding a domain

Details, Cloudflare and the meaning of every switch: Connecting a domain.

Step 5. Add the affiliate network

Networks β†’ Create, choose your network in Template (about 440 networks are listed; pick Generic if yours is missing) and give it a name.

Creating an affiliate network from a template
Creating an affiliate network from a template

The template fills in two important things:

The network's offer parameters
The network's offer parameters

Step 6. Add the offer

Offers β†’ Create:

Creating an offer
Creating an offer

On the Notes & Parameters tab set the country and the payout (e.g. CPA, 30). The payout is only used as a default; the real amount arrives in the postback.

Offer country and payout
Offer country and payout

Create a second offer the same way if you want to split traffic between two offers. More: Offers and affiliate networks.

Step 7. Add the traffic source

Sources β†’ Create, choose Facebook Ads in Source Template, name it after your ad account.

A traffic source from the Facebook template
A traffic source from the Facebook template

The Parameters tab now holds Facebook macros like {{ad.id}} and {{ad.name}}. They will be added to the campaign link automatically, and Facebook replaces them with real IDs on every click. That is how reports can later show results per campaign, ad set and ad.

Source parameters with Facebook macros
Source parameters with Facebook macros

Step 8. Create the campaign

Campaigns β†’ Create. The editor has settings on the left and streams on the right.

An empty new campaign
An empty new campaign

On the General tab:

Now add the main stream: Create Stream β†’ Regular. Leave the schema Direct link to offer, press Add offers and tick the offer(s).

Choosing offers for the stream
Choosing offers for the stream

Then + Add filter β†’ Country β†’ Germany and + Add filter β†’ Device β†’ Mobile, so this stream only takes German mobile visitors.

A country filter
A country filter

Press Save. The stream card now shows the offers with their split (50% / 50%) and the filters.

The saved stream
The saved stream

What about everyone else? A visitor who matches no stream gets nothing. Add a Fallback stream (no filters) that sends them to a landing or another offer, and, if you like, an Intercepting stream with the Bot filter and the action Show 404. How streams are ordered and chosen is explained in Streams.

Scroll the General tab down. You will find:

Campaign URL and test link
Campaign URL and test link

Add &_dbg=1 to the test link and open it: instead of a redirect you get a trace β€” every stream, every filter's verdict, the chosen stream and the final URL with the click ID inside. Add &_geo=DE to pretend you are in Germany without a VPN.

The routing trace of a test link
The routing trace of a test link

Step 10. Give the postback URL to the network

Copy the Postback URL from Networks (the one the template built for your network) and paste it into your affiliate network dashboard as the global postback. Not sure where that is or what to write to your manager? See Postbacks.

To check the chain without real sales: βš™ β†’ Postback URL β†’ Test Postback β€” paste a click ID from the click log, choose a status and press Test.

Step 11. Launch and watch

Put the Campaign URL into your Facebook ad (the whole link, with the macros). As visitors arrive:

The click log
The click log
The dashboard after a week of traffic
The dashboard after a week of traffic

Click a click ID anywhere to open the click card β€” every parameter the visitor brought, the stream, the exact redirect URL.

What next

← Previous
Beginner's guide: start here
Next β†’
Connecting a domain
View source on GitHub: github.com/fenjo26/Orbitra.link/wiki
All guides
Guide

Beginner's guide: start here

A screen-by-screen tour of Orbitra: what the tracker does, the words you will meet, and the order to read the guides in.

Read guide β†’
Guide

Your first campaign, step by step

From a fresh install to a working campaign link and a test conversion: domain, network, offer, source, campaign, postback.

Read guide β†’
Guide

Connecting a domain

Add a domain, point DNS at the tracker, get a free SSL certificate, and what every switch on the Domains page does.

Read guide β†’
Guide

Offers and affiliate networks

How offers and networks are organized in Orbitra: templates, offer parameters and payout settings.

Read guide β†’
Guide

Postbacks: what to tell your affiliate manager

How conversions reach Orbitra: the postback URL, statuses, and what to copy-paste to your network.

Read guide β†’
Guide

Streams: how traffic is distributed

What a stream is, schemas, rotation and weights, and how Orbitra decides where a click goes.

Read guide β†’
Guide

Stream filters

Country, device, ISP, bots and more: every filter explained with examples of common routing setups.

Read guide β†’
Guide

Cloaking for beginners

Safe page vs money page, filter levels, sensitivity, and how to test your cloak before sending real traffic.

Read guide β†’
Guide

Landing pages

Host landings right in the tracker: landing types, the {offer} macro, the JS adapter and tracking pixels.

Read guide β†’
Guide

PWA apps

Build an installable PWA from a landing page: icon, screenshots, store listing and limits.

Read guide β†’
Guide

Push notifications to PWA users

Collect push subscribers from PWA landings and send them notifications β€” free re-engagement traffic.

Read guide β†’
Guide

Content Gallery

Store icons, screenshots and creatives in the tracker and reuse them across PWAs and landings.

Read guide β†’
Guide

Creatives and creative testing

Track which creative a click came from: subid routing, a test campaign and reading the report.

Read guide β†’