Guide

Cloaking for beginners

What cloaking is

Ad networks review your ads: a moderator or a bot opens the link and checks the page. Cloaking shows different pages to different visitors:

In Orbitra cloaking is a stream schema called Cloaking. One module makes the decision in all entry points (the campaign link, click.php, the Click API).

Cloaking violates the rules of most ad platforms and can lead to account and domain bans. You are responsible for how you use it. The same tool is also used honestly β€” for example, to keep scrapers and bots off a landing.

How Orbitra decides

Every visitor goes through two kinds of checks:

  1. Detection layers β€” signals that the visitor is not a regular person:
LayerWhat it catchesNeeds
Datacenter / hostingVisitors from servers and clouds (Amazon, Google Cloud, Hetzner…) β€” typical for review botsASN database
VPN / proxyVPN, proxy and Tor exitsIP2Proxy PX12 database
Bot blocklistsIPs and User-Agents from βš™ β†’ Settings β†’ Botsβ€”
UA heuristicsCrawlers and tools (facebookexternalhit, curl, headless browsers), an empty User-Agent, no browser languageβ€”
  1. Targeting filters β€” your audience. A visitor who is not in it gets the safe page: wrong country, wrong device type, or an ISP from the bot & datacenter ISP list.

Sensitivity sets how many signals are needed: Low β€” only a hard signal (a blocklist hit); Medium (default) β€” a hard signal or two soft ones; High β€” any single signal.

JavaScript check (off by default) adds one more step: the visitor first gets a tiny loading page, and only a browser that runs JavaScript moves on to the money page. Bots that do not run JS stay on the safe page. The price is one extra hop for everyone.

How to set it up

  1. Install the geo databases first. Without them the country filter sees everyone as Unknown and sends 100% of traffic to the safe page. The cloak card warns about missing databases. β†’ Geo databases
  2. Open the campaign β†’ Create Stream β†’ Regular β†’ schema Cloaking.
Detection layers and sensitivity
Detection layers and sensitivity
  1. Keep all four detection layers on and sensitivity Medium to start.
  2. Targeting filters: country (Allow DE), device types (only Mobile if you buy mobile traffic), leave Block Bot & Datacenter ISPs on.
Targeting filters
Targeting filters
  1. Safe page β€” choose what moderators see: an External URL, one of your Tracker Landings, a Local Offer, or Inline HTML. Make it a believable, rule-abiding page on the same topic.
  2. Money page β€” exactly like the Landing + Offer schema: add landings and/or offers.
Safe page and money page
Safe page and money page
  1. Save, then test with the test link: open it from your phone in the target country β€” you should get the offer; open it from a desktop or with &_geo=US β€” you should get the safe page.

The two report switches

"Send clean visitors to the next stream"

Tick it to use the cloak only as a gate: suspicious visitors get the safe page, clean visitors continue to your normal streams (by country, device…). Then the cloak stream must be intercepting (or first) so that every visitor passes through it.

Reading the results

The cloak card shows the hits for the chosen period β€” how many went to money and how many to safe β€” and the top reasons.

Cloak statistics on the stream
Cloak statistics on the stream

In βš™ β†’ Logs β†’ Traffic the Route and Reason columns appear automatically: geo_country:US, device_type:Desktop, crawler_or_tool_ua:facebookexternalhit…

Cloak reasons in the click log
Cloak reasons in the click log

Common problems

ProblemFix
All traffic goes to the safe pageGeo database missing (reason geo_unknown), or the country/device list is too narrow
Real mobile users get the safe page with reason ip2proxy_vpn_proxyMany mobile carriers look like proxies β€” turn off the VPN/proxy layer
Moderators still reach the offerRaise sensitivity, turn on the JavaScript check, add the browser check (βš™ β†’ Settings β†’ Bots)
The ad dashboard shows clicks, the tracker shows zeroLog Safe Page clicks is off, or everything is on the safe page

Deeper reading: Cloaking, How the cloaker works, Browser check.

← Previous
Stream filters
Next β†’
Landing pages
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 β†’