Cloaking House helps you stop bots, reviewers, VPN/proxy traffic & spy tools so real users see the offer that converts. 24/7 support at [email protected] · +447482795924.

Get a Demo
Sign In Request Demo

Developer Documentation

Secure traffic protection • Rule engine • Analytics

Last updated: October 16, 2026

Cloaking House helps advertisers and agencies protect campaigns with traffic filtering, bot/VPN detection, and rule-based routing — while complying with applicable platform policies and laws. This documentation covers quickstart, API, SDKs, dashboard setup, and best practices.

Compliance first: Use Cloaking House only for legitimate security, analytics, and quality-control purposes. Do not use our service to deceive platforms, commit fraud, or violate any policy.

A) Client Setup — End-to-End

Step 1 — Sign up

Open the dashboard and create your account.

  1. Enter First/Last name and Email (or choose Sign up with Google / X).
  2. Create a strong password. We recommend a password manager and enabling 2FA if available.
  3. Click Sign Up.
Sign up form
Create your account with email or SSO.
Use a work email so your team can be added to the same workspace later.

Step 2 — Confirm your email

Check your inbox for our verification message and click the link to activate your account.

  • If you don’t see it, check Spam / Promotions.
  • Links expire for security; request a new one if needed.

Step 3 — Trial (7 days)

New accounts start with a 7-day trial that includes 1 Flow. This lets you build and test a complete setup.

  • Trial banner shows remaining days.
  • When you reach your Flow limit (1/1), you can upgrade to add more.
Trial status / 7 days left

Step 4 — Subscription & Payment

When you’re ready (or the trial ends), choose a plan and activate billing.

4.1 Choose a plan

Go to Subscription and compare plans. Starter includes 1 Flow / 10k visits/month.

4.2 Review & Subscribe

Confirm billing cycle and proceed to payment.

4.3 Payment

Send the exact amount to the address shown. We match automatically when the network confirms.

Once paid, your subscription activates automatically.
4.4 Payment history
Payment history

Step 5 — Create your Flow

Go to Flows → New Flow and fill the form:

  • Flow name & Purpose — internal labels for your team.
  • Domain — hostname only (e.g., promo.example.com).
  • White URL — where filtered/QA users go.
  • Offer URL — where qualified visitors land.
  • Default action — White is safest during testing.
  • Integration — pick tech stack and platform (informational at creation).
Verify both URLs load and tracking pixels fire before moving on.

Step 6 — Add Rules (Targeting & Protection)

Rules decide who reaches the Offer vs who goes to the White page (or gets blocked). Start conservative, then tighten.

6.1 Filtration toggles
  • Cloaking — master smart-filtering switch; suspicious traffic goes to White (or blocked if you set Block elsewhere).
  • Block IP — denylist single IPs or ranges.
  • Block VPN/Proxy — filter known VPN/proxy IP space (reduces fraud; can affect some legit users).
  • Block IPv6 — rarely needed; use only if your stack lacks IPv6 support.
  • Block without ISP — blocks requests where ISP/ASN is missing (catches some bots).
  • Block without Referrer — blocks direct/blank referrers; useful when traffic should only come from ads or partners.
  • Clicks from one IP/day — rate limit repeated clicks per IP (e.g., 3).
  • Clicks before filtering — grace clicks before strict filtering (handy during warm-up).
6.2 Audience targeting
  • Countries — allowlist only markets you target (e.g., FR for France-only).
  • Devices — Mobile / Desktop / Tablet. For app installs, select Mobile and match OS.
  • Operating Systems — Android, iOS, Windows, etc.
  • Browsers — Chrome, Safari, Firefox; optionally exclude fringe browsers seen in abuse.
  • Languages — browser language (e.g., fr-FR).
  • Time Zones — useful for day-parting or regional promos (e.g., Europe/Paris).
  • Connection Type — Cellular/Corporate/Satellite. Cellular narrows to mobile networks only.
6.3 Advanced
  • Referrer Filter — Allow only specific domains (safelist) or Block listed. Option to Block empty referrers. Example allowlist: google.com, facebook.com.
  • UTM Filter — require parameters like gclid, utm_source; missing values send users to White/Block (per your default/other toggles).
Rules screen
If qualified visitors are being filtered, gradually loosen rules and retest each layer (VPN/Proxy, Referrer/UTM, Geo/Device).
Click Save Rules when done.

Step 7 — Activate & Monitor

New flows start Paused. Toggle to Active, then watch Hits, Filtered, and Ratio in the flows list.

  • Stats icon → insights/logs; validate routing and suspicious patterns.
  • Edit rules anytime; use Pause to test safely.
  • Bar shows plan Flow limit (e.g., 1/1). Upgrade to add more flows.

Step 8 — Integration (API / SDK)

Protect pages by checking visitors before rendering your offer. Typical order:

  1. Server receives request to a protected route.
  2. Server calls /api/v1/check-visitor with IP, UA, headers, and path.
  3. Act on the decision: allow (render offer), challenge (light gate), or block/white.
<?php
// Laravel example (Server-side)
$resp = Http::withToken(env('CM_API_KEY'))
  ->post('https://api.example.com/api/v1/check-visitor', [
    'ip' => request()->ip(),
    'user_agent' => request()->userAgent(),
    'headers' => [
      'accept-language' => request()->header('accept-language'),
      'x-forwarded-for' => request()->header('x-forwarded-for'),
    ],
    'path' => request()->path(),
    'referrer' => request()->headers->get('referer'),
  ]);

$data = $resp->json();
switch ($data['decision'] ?? 'allow') {
  case 'allow':
    // render offer
    break;
  case 'challenge':
    // lightweight challenge page or fallback
    break;
  default:
    // route to White URL
}
// Client hint (optional, never rely on client-only)
(function(){
  window.cm = window.cm || {};
  cm.hints = {
    tz: Intl.DateTimeFormat().resolvedOptions().timeZone,
    lang: navigator.language,
    dpr: window.devicePixelRatio || 1
  };
})();
Wire post-conversion POST /api/v1/events to improve quality scoring and reporting.

QA & Troubleshooting

  • No traffic recorded → DNS not pointed yet, caching delay, or Flow still Paused.
  • Everyone goes to White → rules too strict; relax VPN/Proxy, Referrer/UTM, or Geo/Device.
  • High false positives → lower strictness; safelist known IPs/ASNs/referrers.
  • Blank/403 → Default is Block with no matching rules; use White until finalized.
🛡 AI Traffic Protection

BestCloaking Smart Traffic Filtering

Protect your ads, detect bots automatically, and route visitors in real-time using AI-powered flows.

⚡ 30-Second Setup 🤖 AI Engine 🔁 Auto Redirect 📊 Full Logs
⚠ Required Setup

White Page & Offer Page

BestCloaking works by showing different pages to different visitors. You must create two separate pages.

🛡 White Page
  • Clean & compliant
  • Used in ads
  • Contains cloaking code
https://yourdomain.com/white
💰 Offer Page
  • Real offer / checkout
  • No cloaking code
  • Approved traffic only
https://yourdomain.com/checkout
Ad Click → White Page → AI Filters → Offer OR Stay

Quick Start

1️⃣ Create Flow

Set White Page & Offer Page

2️⃣ Configure Filters

AI analyzes every visitor

3️⃣ Go Live

Upload PHP or add JS

🐘 PHP One-Click Integration

Download a ready-to-use index.php. Upload it and BestCloaking routes traffic automatically.

  • No configuration required
  • Runs before page load
  • Maximum security
/public_html/flow1/index.php
Ad URL: https://yourdomain.com/flow1
❌ Do NOT use /index.php in ads

📜 JavaScript Integration

Paste the script inside the <head> of your White Page.

<script src="https://cdn.bestcloaking.com/cloak.js?flow=YOUR_FLOW_KEY"></script>
⚠ Use ONLY on White Pages

🧩 WordPress Integration

Use the BestCloaking WordPress plugin to run cloaking before the theme loads. No coding required.

  • Works with all WordPress themes
  • Compatible with caching plugins
  • No theme or page builder edits
🔧 Installation
  1. Download the BestCloaking Plugin (ZIP)
  2. Go to WordPress Admin → Plugins → Add New
  3. Click Upload Plugin and upload the ZIP
  4. Activate the plugin
⚙ Configuration
  1. Open Settings → BestCloaking
  2. Paste your Flow Key
  3. Save settings
✅ Once activated, traffic is routed automatically according to your Flow rules.
⚠ Do NOT install cloaking scripts inside themes or builders.

📊 Traffic Logs

  • IP Address & Country
  • OS, Browser & Device
  • Bot / Proxy Detection
  • Flow Decision

🛡 Flow Filters

  • Bot & crawler detection
  • VPN / Proxy blocking
  • Geo & device targeting
✅ Always enable security filters

⚠ Critical Rules

  • Always use White Page in ads
  • Never cloak Offer Pages
  • One flow = one white + one offer
  • Always test before scaling
Need a hand?

Talk to a Solutions Engineer

We’ll help you integrate Cloaking House in minutes.

Request Demo Contact Support
Cookie
We use cookies to improve your experience, analyze traffic, and for marketing. See our Privacy Policy.
Customize

Cookie Preferences

Choose which cookies to allow. You can change this anytime.

cookies.title
We use cookies to improve your experience, analyze traffic, and for marketing. See our Privacy Policy.
Customize

Cookie Preferences

Choose which cookies to allow. You can change this anytime.

Expert Support