Trackily Documentation

The complete guide to setting up and using Trackily — your self-hosted affiliate tracker.

Introduction

Trackily is a self-hosted multi-campaign affiliate tracking platform, inspired by Keitaro. It lets you track clicks, manage flows, optimize landing pages, and monitor conversions — all from your own server with full data ownership.

Key Capabilities

Installation

Requirements

• VPS with Ubuntu 20+ or Debian 11+ (minimum 1GB RAM)
• PostgreSQL database
• A domain name pointed to your server
• Ports 80 and 443 open

Quick Install (VPS)

SSH into your server and run:

curl -sSL https://license.trackily.online/install.sh | bash -s -- YOUR_LICENSE_KEY

Docker Install

Create a docker-compose.yml:

version: "3.8"
services:
  trackily:
    image: trackily/tracker:latest
    restart: always
    ports:
      - "3000:3000"
    env_file: .env
    depends_on:
      - postgres
  postgres:
    image: postgres:16-alpine
    restart: always
    environment:
      POSTGRES_DB: trackily
      POSTGRES_USER: trackily
      POSTGRES_PASSWORD: your_secure_password
    volumes:
      - pgdata:/var/lib/postgresql/data
volumes:
  pgdata:

Create a .env file:

LICENSE_KEY=your-license-key-here
LICENSE_SERVER_URL=https://license.trackily.online
DATABASE_URL=postgresql://trackily:your_secure_password@postgres:5432/trackily
ADMIN_PASSWORD=YourAdminPassword123!
PORT=3000

Then run:

docker compose up -d

Coolify / Panel Manager

Your First Campaign

Follow these steps to create your first tracking campaign:

Dashboard

The dashboard provides a real-time overview of your campaigns with three data tabs:

Everflow Tab

Shows stats pulled directly from your Everflow affiliate network: clicks, conversions, revenue, payout, and ROI. Uses the Everflow Affiliate API.

Kadam Tab

Shows campaign stats from your Kadam traffic source: impressions, clicks, CTR, cost. Uses the Kadam REST API.

Trackily Tab

Shows native tracking data: clicks, unique visitors, leads, conversions, cost, revenue, profit, ROI, EPC. This is your primary dashboard for campaign performance.

Campaigns

A campaign is the central entity that connects a traffic source, landing pages, offers, and routing flows.

Creating a Campaign

Campaign Settings

Bot Filter

Enable to block known bots. Bots are redirected to a URL of your choice (default: google.com). Clicks with fraud score > 50 are blocked.

Frequency Capping

Limit how many times a visitor can see your campaign. Example: max 3 visits per 24 hours per IP.

External Campaign IDs

Link your Kadam/PropellerAds campaign IDs to pull combined stats from both Trackily and the source API.

Tracking Link

Each campaign generates a tracking URL:

https://your-domain.com/c/mcafee-us?click_id={click_id}&cost={cost}&sub2={campaign_id}

Paste this in your traffic source as the destination URL. The macros will be replaced with real values by the traffic source.

Offers

An offer is the product or service you're promoting. Offers can be created manually or imported from Everflow.

Import from Everflow

Offer Caps

Set daily and total caps to limit conversions. When a cap is reached, Trackily automatically routes traffic to the next available offer in the flow.

Geo-specific Payouts

Configure different payouts per country. Example: McAfee US = $40 CPA, McAfee FR = $25 CPA.

Landing Pages

Landing pages are shown to visitors before they see the offer. Two types:

Import Landing Pages

Two import methods:

• From URL: Paste a URL and Trackily downloads the HTML
• From HTML: Upload or paste raw HTML code

Flows & Routing

Flows determine how traffic is routed within a campaign. Each campaign can have multiple flows with different rules.

Flow Types

Flow Filters

Add conditions to target specific traffic. Available filters:

Weighted Rotation

Assign weights to landing pages and offers for A/B testing:

Landing A: weight 100 (67% traffic)
Landing B: weight 50  (33% traffic)

Higher weight = more traffic. Use the Balance button to equalize weights.

Visitor Binding

Ensure returning visitors see the same landing page/offer:

Conflict Detection

Trackily warns you about potential flow conflicts:

• Error: Multiple default flows (only the first one runs)
• Warning: Forced flow without filters shadows everything
• Info: Regular flows with identical filters (unintentional A/B test)

Traffic Sources

Trackily comes with 10 pre-configured traffic source templates with smart forms:

Affiliate Networks

Connect your affiliate networks to import offers and sync conversions. Everflow has full API integration.

Everflow Setup

Domains

Add custom domains for cleaner tracking links. Each domain can be linked to a campaign.

Features: DNS verification, SSL status check, DNS provider detection (Cloudflare, etc.), domain grouping.

Reports

The Reports page provides detailed analytics with multiple grouping options:

Group By Options

Metrics Available

Clicks, Unique, Leads, Conversions, Cost, Revenue, Profit, ROI%, CR%, EPC, CPA, CPL

Period Comparison

Check "vs Previous" to compare current period with the previous one (e.g. today vs yesterday, this week vs last week).

Column Templates

Customize which columns are visible in your reports and save presets for quick switching.

Export / Import

Export

Export your data in CSV or JSON format. Go to Settings → Export section. Available types: Campaigns, Offers, Flows, Sources, Networks, Landing Pages, or All.

Import

Import data from JSON. Go to Settings → Import section. Upload a JSON file with an array of objects matching the entity schema.

Postback System

Trackily uses a Keitaro-style universal postback with parameter aliases. Any affiliate network can fire conversions regardless of their naming convention.

Postback URL

https://your-domain.com/postback?click_id={sub2}&amount={payout_amount}&txid={transaction_id}

Parameter Aliases

Dynamic Call-Outs

Personalize your landing pages by injecting visitor data. Use double-brace placeholders in your HTML:

Example

<h1>Attention {{city}} residents!</h1>
<p>Your {{os}} device may be at risk.</p>

Becomes:

<h1>Attention New York residents!</h1>
<p>Your Windows device may be at risk.</p>

Multi-Step Funnels

Track visitor progress through multiple landing page steps. Each step is reported automatically.

How to Use

In your local landing page, call the step tracking function:

// Step 1 is auto-tracked on page load
// Track custom steps:
window.__trackily.reportStep(2, 'Email Submitted');
window.__trackily.reportStep(3, 'Scan Started');
window.__trackily.reportStep(4, 'Offer Shown');

View funnel stats in Reports → Funnel tab to see dropoff at each step.

Custom Conversions

Define multiple conversion types beyond just "sale":

Pass the type in your postback: &conversion_type=upsell. Rebills automatically link to the parent conversion for LTV tracking.

GeoIP Databases

Trackily uses local MaxMind GeoLite2 databases for instant geo-detection (~1ms per lookup, no external API calls).

Manual Cost Update

Correct cost data after the fact when your traffic source reports different costs than bid.

Single Click

In the Clicks report, click the $$ button next to any click to edit its cost.

Bulk Update

Select a campaign and date range, then set a new cost-per-click value. All clicks in that range are updated.

Anti-Fraud Kit PRO

Detect and block fraudulent clicks in real-time with a multi-factor scoring system.

Fraud Score (0-100)

Clicks with score ≥ 50 are blocked (with bot filter enabled). IPs with score ≥ 80 are auto-blacklisted.

IP Blacklist

Manually add IPs or ranges. Auto-blacklist adds IPs automatically when fraud score exceeds the threshold.

Automizer PRO

Create automation rules that monitor your campaigns and take action based on performance metrics.

Rule Structure

IF [metric] [operator] [value] WITHIN [time_window]
THEN [action]

Example Rules

Available Metrics

clicks, conversions, revenue, cost, roi, cpa, cr, epc

Available Actions

pause_campaign, pause_offer, send_notification, change_weight, change_bid

Traffic Distribution AI PRO

Automatically optimize landing page and offer weights based on real-time conversion data.

The AI analyzes conversion rate and EPC per landing/offer, then suggests weight adjustments. Enable it per flow in the flow editor.

Notifications PRO

Get alerted on important events via 4 channels:

Notification Rules

Create rules to trigger on specific events: conversion, fraud_alert, rule_triggered, link_down, campaign_paused, offer_capped. Set conditions, choose channels, and add a cooldown to prevent spam.

A/B Testing PRO

Compare landing pages and offers using flow weights and statistical significance testing.

Lander Protection PRO

Protect your landing pages from spy tools and competitors.

When enabled, Trackily detects:

• Headless browsers (Selenium, Puppeteer)
• Known spy tool referrers (AdPlexity, Anstrex, SpyPush, etc.)
• Missing browser plugins (bot indicator)

Detected spies see "Access Denied" instead of your landing page. Enable per landing page in the editor.

Conversion Pixel (JS)

The JavaScript pixel allows e-commerce merchants to track conversions client-side, directly from their thank-you page — no S2S postback needed.

Installation

Add this script to your website's <head> or thank-you page:

<script src="https://your-tracker.com/pixel.js"></script>

Tracking Events

// Track a purchase
trackily.track('purchase', {
  order_id: 'ORD-12345',
  revenue: 89.99,
  currency: 'USD',
  products: [
    { name: 'Running Shoes', price: 59.99, qty: 1 },
    { name: 'Sports Socks', price: 14.99, qty: 2 }
  ]
});

// Track add-to-cart
trackily.track('add_to_cart', {
  product: 'Running Shoes',
  price: 59.99
});

// Track checkout initiation
trackily.track('checkout', {
  cart_total: 89.97,
  item_count: 3
});

// Track a lead
trackily.track('lead', {
  email: 'customer@example.com'
});

Product Catalog

Import and manage your product catalog. Products can be imported from Shopify, WooCommerce, or added manually.

Manual Product

Import from Shopify

Go to Integrations → configure your Shopify store URL and API token → click Import Products. All products with title, price, SKU, images, and variants are imported automatically.

Import from WooCommerce

Go to Integrations → configure your WooCommerce store URL, consumer key, and consumer secret → click Import Products.

Shopify Integration

Trackily integrates with Shopify via API for products, orders, and auto-sync conversions.

Setup

Shopify Webhook (Alternative)

For real-time conversion tracking, configure a webhook in Shopify:

URL: https://your-tracker.com/webhook/shopify?key=YOUR_WEBHOOK_SECRET
Event: Order creation

Each new order fires a webhook → Trackily matches the customer email/IP to a click → creates a conversion automatically.

Auto-Sync Orders

When enabled, Trackily polls Shopify's GET /admin/api/2024-01/orders.json every 15 minutes and matches orders to clicks using:

• note_attributes._tly_click — click ID passed from landing page
• Customer email matching
• IP address matching (last resort)

WooCommerce Integration

Connect your WordPress/WooCommerce store for product import and conversion tracking.

Setup

WooCommerce Webhook

For real-time tracking, add a webhook in WooCommerce:

URL: https://your-tracker.com/webhook/woocommerce
Topic: Order completed
Secret: YOUR_WEBHOOK_SECRET

E-Commerce Metrics: AOV / ROAS / CAC

Trackily calculates key e-commerce KPIs automatically from your conversion data. These metrics are shown on the Dashboard and Reports pages.

E-Commerce Funnel

Visualize your shopping funnel to identify where customers drop off.

Funnel Steps

The funnel page shows visual bars with conversion rates between each step:

Page Views:    10,000  (100%)
Add to Cart:    3,500  (35.0%)  ← 35% clicked Add to Cart
Checkout:       1,800  (18.0%)  ← 51% of carts started checkout
Purchase:       1,200  (12.0%)  ← 67% of checkouts completed

E-Commerce Status Scheme PRO

Track the lifecycle of each conversion through e-commerce statuses, similar to Binom's status scheme.

Available Statuses

Status History

Every status change is logged with who made the change, when, and from/to statuses. View the history in the conversion detail modal.

Automatic Transitions

When status changes to Sale, the conversion is automatically marked as "approved". When it changes to Refund or Chargeback, the conversion is marked as "rejected" and revenue is excluded from reports.

Retargeting Pixels PRO

Inject retargeting pixels (Facebook, Google, TikTok) on ANY tracking link — even links to external sites you don't own. This is a feature unique to Trackily and ClickMagick.

How It Works

When a visitor clicks your tracking link /c/:slug, Trackily shows a brief intermediate page (1.5 seconds) that:

1. Fires your Facebook Pixel (PageView event)
2. Fires your Google Tag (page_view event)
3. Fires your TikTok Pixel (page event)
4. Runs any custom scripts you defined
5. Redirects the visitor to the destination (landing page or offer)

Configuration

In the campaign editor, go to the Retargeting Pixels section:

Use Case

You promote a Shopify store you don't own. By adding your FB Pixel to the Trackily campaign, every visitor who clicks your link is added to your Facebook retargeting audience — even though the Shopify store doesn't have your pixel installed.

Multi-Touch Attribution ENTERPRISE

Go beyond last-click attribution with 4 models that distribute conversion credit across multiple touchpoints.

Attribution Models

Example

Customer journey: Facebook Ad → Google Search → TikTok Ad → Purchase ($100)

Last Click:   Facebook $0, Google $0, TikTok $100
First Click:  Facebook $100, Google $0, TikTok $0
Linear:       Facebook $33, Google $33, TikTok $33
Time Decay:   Facebook $16, Google $28, TikTok $56

Access attribution reports at Attribution page. Select a model, date range, and campaign to see how revenue is distributed across traffic sources.

Audience Export PRO

Build audience segments from your traffic data and export them for retargeting on ad platforms.

Creating a Segment

Export Formats

Segment Examples

• Converters: Visitors who completed a purchase (for lookalike audiences)
• Cart Abandoners: Added to cart but didn't purchase (for retargeting)
• High Value: Customers with AOV > $100 (for upsell campaigns)
• By Country: US-only visitors for geo-specific campaigns

Audience Optimization ENTERPRISE

Automatically send conversion data in real-time to ad platforms (Facebook, Google, TikTok) for better ad optimization and higher match rates.

Supported Platforms

Setup

In the campaign editor, go to Audience Passback section:

How It Works

Every time a conversion is recorded (via postback, webhook, or pixel), Trackily automatically fires the conversion data to all configured platforms with:

• Client IP and User Agent (for matching)
• Click ID (fbclid, ttclid, gclid)
• Revenue and currency
• Event type (Purchase or Lead)
• Country code

Users & Permissions

Manage team access with role-based permissions.

Roles

Sections

10 sections with independent read/write toggles: Campaigns, Offers, Landings, Flows, Sources, Networks, Domains, Reports, Settings, Users.

Settings

AI Assistant

Configure Claude, Gemini, or DeepSeek API keys for the built-in AI chat. The AI can create campaigns, suggest optimizations, and generate landing page copy.

IP Anonymization

Enable to mask visitor IPs for GDPR compliance (last octet zeroed).

License Management

Activate your license in the sidebar → Upgrade button. Paste your license key (UUID) and click Activate.

Plans

Get your license at license.trackily.online/portal.

Tracking Flow

The complete journey of a click through Trackily:

Traffic Source (Kadam, PropellerAds, etc.)
  │
  ▼
GET /c/:campaign-slug
  ├─ Parse visitor: IP, UA, sub1-5, referrer
  ├─ GeoIP lookup: country, city, ISP
  ├─ Parse UA: OS, browser, device type
  ├─ Fraud scoring: bot check, flood, datacenter
  ├─ Bot filter: redirect if score >= 50
  ├─ Frequency cap: block if limit exceeded
  ├─ Unique click detection (IP+UA hash)
  ├─ Flow evaluation: forced → regular → default
  ├─ Weighted landing selection
  ├─ Offer cap check: skip capped offers
  ├─ Create click record (UUID)
  └─ Serve landing (HTML) or redirect (URL)
       │
       ▼
  Landing Page
  ├─ Dynamic call-outs injected
  ├─ Lander protection active (if enabled)
  ├─ Step tracking (multi-step funnels)
  └─ Visitor clicks CTA
       │
       ▼
  GET /offer/:clickId/:offerId
  ├─ Append sub params (sub2=trackily_uuid)
  └─ Redirect to affiliate offer URL
       │
       ▼
  Conversion (on affiliate network)
  ├─ Network fires postback
       │
       ▼
  GET /postback?click_id={sub2}&amount={payout}
  ├─ Resolve click by ID
  ├─ Create conversion record
  ├─ Fire source postback (Kadam, etc.)
  └─ Dispatch notifications

API Reference

All admin endpoints require Authorization: Bearer {token} header.

Authentication

POST /admin/api/login
Body: { "email": "admin@example.com", "password": "..." }
Response: { "token": "...", "user": {...} }

Core Endpoints

Public Endpoints (No Auth)

Environment Variables