Welcome to the Eximus documentation. This guide will help you understand and utilize all features of our advanced traffic protection and campaign management platform.
Follow these steps to get started with Eximus:
Register for a new account and receive a 2-day free trial automatically.
Select from Standard, Business, or Enterprise plans based on your needs.
Set up a campaign link with your target URL and protection settings.
Track your traffic, conversions, and blocked threats in real-time.
The Eximus AntiBot SDK is a standalone PHP-based bot detection system that provides advanced fingerprinting and traffic protection for any website. It works independently from campaign links, allowing you to protect any PHP application.
Advanced JavaScript fingerprinting collects 50+ browser attributes for accurate bot detection.
Instant bot/human classification using Eximus cloud intelligence.
Beautiful statistics interface to monitor all visitor activity and bot patterns.
Detailed visitor data including location, ISP, ASN, and timezone information.
Single line integration - just include the PHP file in your pages.
All visitor data automatically logged to JSON for analysis and export.
Follow these steps to install and configure the AntiBot SDK on your website:
Download the AntiBot SDK package from your Eximus dashboard under Services → AntiBot SDK.
Extract the package to your web server. You'll get:
antibot.php - Main detection scriptstats.php - Analytics dashboardREADME.txt - Quick reference guideFind your AntiBot license key in your Profile or Download page.
Open antibot.php and add your license key on line 13:
$EXIMUS_LICENSE_KEY = 'YOUR_LICENSE_KEY_HERE';
The AntiBot SDK provides several configuration options in the antibot.php file:
// Configuration Section
$EXIMUS_LICENSE_KEY = 'YOUR_LICENSE_KEY_HERE'; // Your license key
$ENABLE_LOGGING = true; // Enable/disable logging
$LOG_FILE = __DIR__ . '/visitors.json'; // Log file location
| Parameter | Type | Default | Description |
|---|---|---|---|
$EXIMUS_LICENSE_KEY |
String | Required | Your Eximus license key |
$ENABLE_LOGGING |
Boolean | true | Enable visitor logging to JSON file |
$LOG_FILE |
String | visitors.json | Path to the log file |
Add the AntiBot SDK to any PHP page with a single line:
<?php require_once 'antibot.php'; ?>
<!-- Your HTML content -->
<html>
<head>
<title>Protected Page</title>
</head>
<body>
<h1>This page is protected by Eximus AntiBot</h1>
</body>
</html>
Customize what happens when bots or humans are detected by editing lines 103-114 in antibot.php:
if ($detection) {
if (!$detection['ok']) {
// BOT DETECTED - Customize action
header('Location: https://google.com'); // Redirect to Google
exit;
} else {
// HUMAN DETECTED - Show protected content
include('protected-content.php');
exit;
}
}
The $detection array provides comprehensive visitor information:
$detection = eximus_antibot();
// Available data:
$detection['ok'] // true for human, false for bot
$detection['ip'] // Visitor IP address
$detection['country'] // Country code (US, GB, etc.)
$detection['country_name'] // Full country name
$detection['city'] // City name
$detection['isp'] // Internet Service Provider
$detection['org'] // Organization
$detection['asn'] // Autonomous System Number
$detection['timezone'] // Visitor timezone
$detection['action'] // HTTP status (200, 403, etc.)
$detection['target'] // Detection target type
// Add to wp-config.php or theme functions.php
require_once(ABSPATH . 'antibot/antibot.php');
// For specific pages only
function protect_sensitive_pages() {
if (is_page('checkout') || is_page('register')) {
$detection = eximus_antibot();
if ($detection && !$detection['ok']) {
wp_die('Access Denied - Bot Detected');
}
}
}
add_action('template_redirect', 'protect_sensitive_pages');
session_start();
$detection = eximus_antibot();
if ($detection) {
if ($detection['ok']) {
// Human verified - set session
$_SESSION['verified_human'] = true;
$_SESSION['user_country'] = $detection['country'];
$_SESSION['user_city'] = $detection['city'];
} else {
// Bot detected - destroy session
session_destroy();
die('Access Denied');
}
}
// Protect API endpoints
require_once 'antibot.php';
$detection = eximus_antibot();
if (!$detection || !$detection['ok']) {
http_response_code(403);
die(json_encode(['error' => 'Forbidden']));
}
// Continue with API logic...
The AntiBot SDK includes a comprehensive analytics dashboard to monitor all visitor activity.
Navigate to stats.php on your website:
https://yourwebsite.com/path/to/stats.php
Live counters for total visitors, humans detected, and bots blocked.
Detailed table showing all visitors with IP, location, ISP, and status.
Export all visitor logs as JSON for external analysis.
Dashboard automatically refreshes every 30 seconds for live monitoring.
Protect your stats dashboard with password authentication:
// Add to top of stats.php
session_start();
$password = 'your_secure_password';
if ($_POST['password'] !== $password && !$_SESSION['auth']) {
die('<form method="post">
Password: <input type="password" name="password">
<button>Login</button>
</form>');
}
$_SESSION['auth'] = true;
// Redirect to search engine
header('Location: https://google.com');
exit;
// Show blank page
header('HTTP/1.0 403 Forbidden');
die();
// Custom error page
include('error_403.html');
exit;
// Log to database then block
log_bot_attempt($detection);
die('Access Denied');
function eximus_antibot()
Returns: Array|null
- Returns detection array on POST request with fingerprint data
- Returns null on initial page load (while collecting fingerprint)
{
"ok": true, // true = human, false = bot
"ip": "192.168.1.1", // Visitor IP
"country": "US", // Country code
"country_name": "United States",
"city": "New York",
"isp": "ISP Name",
"org": "Organization",
"asn": 12345, // ASN number
"timezone": "America/New_York",
"cid": "correlation_id",
"target": "human|bot",
"action": "200|403|404", // HTTP status
"data": {} // Full API response
}
Visitor data is logged to visitors.json in the following format:
{
"timestamp": "2025-01-20 15:30:45",
"ip": "192.168.1.1",
"country": "US",
"country_name": "United States",
"city": "New York",
"isp": "ISP Name",
"org": "Organization",
"asn": 12345,
"timezone": "America/New_York",
"user_agent": "Mozilla/5.0...",
"referer": "https://example.com",
"status": "HUMAN|BOT",
"action": "200",
"target": "human"
}
| Issue | Possible Cause | Solution |
|---|---|---|
| No detection happening | Invalid license key | Verify license key in Profile page |
| Logs not saving | File permissions | Ensure directory has write permissions |
| Stats page blank | No visitor data yet | Wait for first visitors or test manually |
| Always detecting as bot | JavaScript disabled | Ensure JavaScript is enabled in browser |
| cURL errors | cURL not enabled | Enable cURL in PHP configuration |
Campaign links are the core of Eximus's protection system. Each campaign link acts as a protected gateway to your actual destination URL.
Go to Services → Campaign → Create Campaign in your dashboard.
Input your destination URL where legitimate traffic will be redirected.
Specify where bot traffic should be redirected. Leave empty to show a blank page to bots.
Choose country restrictions, enable/disable redirect, and set other filters.
Your protected campaign URL that you'll use in your advertising campaigns.
The destination URL where real human visitors will be sent.
Alternative destination for detected bot traffic (optional).
Restrict access to specific countries using country codes (e.g., US, GB, CA).
Toggle to enable/disable the campaign without deleting it.
Optional HTML page to display instead of redirect (cloaking page).
Eximus provides powerful customization options for your campaign links, allowing you to create fully branded and customized landing pages that maintain your campaign's look and feel.
Navigate to Services → Campaign → Customization to access the visual landing page designer.
Customize primary colors, secondary colors, backgrounds, and gradients to match your brand identity.
Choose fonts, sizes, weights, and text colors for headings, body text, and buttons.
Upload logos, background images, icons, and other media assets directly to your landing page.
Select from multiple layout templates or create custom arrangements for your content.
Add custom HTML sections and CSS for advanced customization needs.
All customizations are automatically responsive for perfect display on all devices.
Build your landing page using these customizable components:
Choose which campaign link you want to customize from your campaigns list.
Start with a pre-designed template or begin with a blank canvas.
Use the visual editor to modify colors, fonts, images, and layout.
Preview your design on different devices and test all functionality.
Save and publish your customized landing page instantly.
Use dynamic placeholders to personalize content based on visitor data:
{{country}} - Visitor's country
{{city}} - Visitor's city
{{device}} - Device type
{{browser}} - Browser name
{{parameter}} - URL parameter value
Create multiple versions of your landing page to test different designs:
Add tracking pixels, analytics codes, or custom JavaScript:
Eximus automatically optimizes your customized landing pages for performance:
Eximus automatically transfers all GET parameters from your campaign link to the destination URL. This powerful feature ensures tracking parameters, UTM codes, email addresses, and other data pass through seamlessly.
yourdomain.com/[email protected]
Bot filtering & validation
destination.com/[email protected]
One of the most powerful uses of parameter passing is automatic email capture. When email addresses are passed as URL parameters, they flow through to your destination, allowing seamless data collection.
?utm_source=google
&utm_medium=cpc
&utm_campaign=summer2025
Track campaign performance across all platforms
[email protected]
&name=John+Doe
&phone=1234567890
Pass user information for pre-filling forms
?gclid=abc123xyz
&fbclid=def456uvw
&msclkid=ghi789rst
Maintain platform-specific tracking identifiers
?aff_id=partner123
&sub_id=campaign456
&source=newsletter
Track affiliate partners and sub-campaigns
Collect email on your campaign link using HTML content
JavaScript captures email and adds to redirect URL
Email automatically fills form on destination
// Example: JavaScript for email capture and redirect
function redirectWithEmail() {
const email = document.getElementById('email').value;
const destination = 'https://destination.com/offer';
// Add email to URL parameters
window.location.href = destination + '?email=' + encodeURIComponent(email);
}
Instead of immediate redirects, you can display custom HTML content on your campaign links. This is useful for creating safe pages, pre-landers, or implementing advanced cloaking strategies.
The short link system provides an additional layer of protection with simplified URLs. Short links are perfect for social media, SMS campaigns, and anywhere you need concise URLs.
| Feature | Campaign Links | Short Links |
|---|---|---|
| URL Format | Standard URL path | Shortened format |
| Customization | Full HTML support | Redirect only |
| Bot Protection | ✓ Full protection | ✓ Full protection |
| Parameter Passing | ✓ Automatic | ✓ Automatic |
| Analytics | ✓ Detailed | ✓ Detailed |
| Best For | Display ads, search ads | Social media, SMS |
Navigate to Services → Link Shortener in your dashboard.
Input the destination URL you want to protect and shorten.
Select bot handling method and country restrictions if needed.
Click create to generate your protected short link.
Eximus offers a curated selection of domains for your campaigns. Having your own domain improves trust and campaign performance.
After purchasing a domain, it's automatically configured for use with your campaigns. Each domain includes:
The Deploy Index feature allows you to set a default landing page for your domain root. This is what visitors see when they access your domain directly without a specific campaign path.
Makes your domain appear more legitimate to reviewers and checkers.
Shows a professional page instead of errors when accessed directly.
Control access to your campaigns with advanced IP filtering and ASN-level blocking.
Example IP Formats:
Single IP: 192.168.1.1
IP Range: 192.168.1.0/24
ASN: AS15169 (Google)
Restrict campaign access based on visitor location using country codes.
| Country | Code | Example Usage |
|---|---|---|
| United States | US | US |
| United Kingdom | GB | GB |
| Multiple Countries | Various | US,GB,CA,AU |
Monitor your campaign performance with comprehensive analytics and reporting tools.
Total visitors, unique visitors, and page views.
Number of bots blocked and bot vs human ratio.
Visitor locations, countries, and cities.
Device types, browsers, and operating systems.
Internet service providers and connection types.
Traffic patterns by hour, day, and month.
All analytics data is retained for 6 months, allowing you to analyze long-term trends and patterns.
Need more help? Contact our support team through the dashboard for assistance with any aspect of the Eximus platform.