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.

Bulk Actions

Every admin table with checkboxes supports multi-select bulk operations. Select one or more rows and a floating action bar slides up at the bottom of the screen.

Where it's available

How it works

1. Tick the checkboxes on the rows you want to affect (or the header checkbox to select all visible rows).
2. A floating toolbar appears at the bottom of the screen: ✓ N selected followed by action buttons.
3. The header checkbox shows a tri-state indicator: fully checked when everything is selected, indeterminate when only some rows are, empty otherwise.
4. Destructive actions (Delete) show a confirmation dialog with the exact count. Activate/Pause/Publish confirm once; Move to group doesn't — it's reversible.
5. After success, you get a toast ("Paused 12 campaigns"), the selection clears, and the table reloads.

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. Three 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

Redirect Tracker NEW

A lightweight prelander that captures click-ID parameters sent by ad platforms (Facebook's fbclid, Google's gclid, Bing's msclkid, TikTok's ttclid, etc.) and stores them server-side before redirecting the visitor to your offer. Intended as the very first hop in an ad funnel so attribution parameters survive before the browser drops them on cross-domain navigation.

Why you want this

• Facebook Conversions API: reliable fbclid capture for server-side matching (eCPM improvement).
• Google Ads enhanced conversions: clean gclid / gbraid / wbraid for offline imports.
• Audit traffic quality: compare what your ad platform reports vs. what actually landed.
• CPM deal verification: your own source of truth against partner invoices.

Click IDs detected automatically

Every hit is inspected for 13 known parameter names — the first match is promoted to click_id_type / click_id_value for fast filtering:

Creating a Redirect Tracker

1. Go to Landing Pages → Create.
2. Set Type to 🎯 Redirect Tracker (capture click IDs).
3. Fill in the fields below.

Public URLs

• Standalone: https://your-domain.com/r/<slug> — paste in your ad creative directly.
• In a campaign flow: select the redirect tracker as a landing inside any flow; /c/:slug will dispatch to it automatically and pass the campaign_id to the capture row.

What's captured

Each visit writes a row to the tracked_redirects table:

• Primary click-ID type and value
• Full query-string as JSON (all_params)
• Final target URL
• IP address + country code (via ip-api geolocation)
• User-Agent, referrer, is_bot flag (on known bot UA patterns)
• Timestamp + optional verification status (see Bot Protection)

Reporting

Edit any redirect tracker — a stats box appears inline:

📊 Captures (last 500): 823     passed: 781
fbclid: 680  gclid: 101  none: 42
🛡 42 bots blocked (CAPTCHA: 30 · Honeypot: 8 · Time: 4)

Full CSV export (up to 5000 rows) available at GET /admin/api/landings/:id/redirect-captures.csv.

Technical safeguards

• Server-side capture: the insert happens before the HTML renders — works even if JavaScript is disabled.
• Triple-fallback redirect: window.location.replace() → <meta refresh> → visible fallback link.
• No-index: meta robots and X-Robots-Tag: noindex, nofollow prevent search-engine crawlers from indexing the prelander.
• No cache: Cache-Control: no-store so every visit is recorded.
• No loop: internal _tly_* params are stripped before forwarding.

AI Landing Page Builder PRO

Generate high-converting landing pages in seconds using AI. Choose your LLM provider, pick a copywriting framework, and let the system generate a complete, multi-section landing page tailored to your vertical and traffic source.

Quick Start

1. Configure your API key: Go to Settings → AI Landing Builder and enter an API key for at least one LLM provider (Claude, OpenAI, Gemini, DeepSeek, MiniMax, or GLM).
2. Generate: Go to AI Landings and click ✨ Generate with AI. Describe your offer, pick a vertical, language, audience, framework, and traffic temperature.
3. Edit: Click ✎️ to open the GrapesJS visual editor — drag-and-drop, change images, tweak copy inline.
4. Publish: Click 📤 to make it live at /l/your-slug.
5. Link to campaign: Click 🔌 to connect it to a campaign flow for full click tracking, cloaking, and offer rotation.

Supported LLM Providers

Image AI Providers

24 Affiliate Verticals

Each vertical has a dedicated conversion psychology profile that tailors the LLM’s output (emotional triggers, trust mechanisms, objection crushers, hero image direction, tone of voice, and compliance rules):

Antivirus & Software • Auto Warranty • Car Insurance • Debt Settlement • E-commerce • Education • Email Submit • Gaming • Health / Wellness • Health Insurance • Home Improvement • Home Insurance • Home Security • Investing & Financial • Legal • Life Insurance • Listicle / Advertorial • Medicare • Nutra (Supplements) • Real Estate • Survey • Travel • Utility / Software • Other (custom)

8 Copywriting Frameworks

Each framework structures the persuasion flow differently. The system auto-recommends the best one per vertical, but you can override:

Traffic Temperature

Controls how much education and proof the page includes based on how “ready to buy” the reader is:

Visual Editor (GrapesJS)

Click ✎️ on any AI landing to open the full visual editor:

• Drag & drop: Add, move, or resize any element
• Inline editing: Click any text to edit it directly
• Device preview: Desktop, Tablet, and Mobile views
• Asset manager: Upload custom images (stored in Postgres, served via /assets/:id)
• Regen Image: Click 🖼 to regenerate the hero image with a new AI prompt
• Domain assignment: Pick a custom domain from the editor topbar
• Save & Publish: One-click save or save + publish

A/B Testing (Variants)

Click 🧪 on any landing to generate 2–8 variants with different angles. Each variant uses a different copywriting hook:

Curiosity • Social proof • Urgency • Fear-of-loss • Aspirational • Authority • Contrarian • Story

Variants share a variant_group_id and are displayed with a 🧪 A/B ×N badge in the table. Click 📊 to see aggregated stats per variant (visitors, leads, conversions, CVR, revenue, EPC) with a z-test winner detection at 95% confidence. Click 🚀 Promote to set the winner to 100% traffic in every linked flow.

Campaign Bridge

Click 🔌 to link an AI landing (and all its variants) into an existing campaign flow. This enables:

• Click tracking: Every visitor via /c/campaign-slug gets a click record with full geo, UA, fraud score
• Cloaking: The campaign’s 3-layer cloaking workflow (Drawflow) applies on top of the landing’s built-in UA-based white page cloaking
• Offer rotation: The flow engine picks a weighted offer, and the CTA button on the landing automatically redirects to that offer URL
• Postback: Lead/conversion postbacks fire back to your traffic source (Kadam, PropellerAds, etc.)

Lead Capture

Inline forms in AI landings are automatically intercepted. The injected tracking script:

1. Detects all <form> elements at page load
2. On submit, extracts email / name / phone via field-name heuristics (supports EN + FR + ES names)
3. POSTs to /api/lead with click_id + ai_landing_id + form data
4. Redirects to the offer URL after 250ms

View leads via 👥 — the modal shows summary chips (total, unique emails, with phone), a search bar, and CSV export (up to 10K rows). Leads are scoped to the full variant group by default.

Opt-out: Add data-trackily="off" to any form you don’t want intercepted.

Compliance Checker

Click 🛡 to run a two-tier compliance scan:

• Rule-based scan (instant, free): Checks for banned terms and missing required disclaimers per vertical (antivirus, health, crypto, sweepstakes, finance). Returns a score 0–100 with severity-coded issues (ERROR / WARN / INFO) and fix hints.
• AI Deep Review (LLM-powered): Sends the page copy to your configured LLM for a deeper analysis with categorized issues and a verdict (safe / needs revisions / high risk).

Auto-Translation

Click 🌍 to translate a landing into other languages. 12 pre-set languages (FR, ES, DE, IT, PT, NL, PL, AR, EN, JA, TR, RU) plus a custom language field. The LLM performs culturally-adapted localization (not literal translation), and testimonial names are localized to the target market. Each translation is saved as a new draft with translated_from metadata.

Heatmap / Conversion Audit

Click 🔥 to get an AI-powered conversion audit. The LLM analyzes the page structure and copy to predict:

• Conversion score (0–100) with verdict (strong / average / weak)
• Attention distribution per section (headline, hero, CTA, bullets, testimonials, FAQ, footer)
• CTA click predictions with position and estimated CTR%
• Heat zones (hot / warm / cool / cold) with explanations
• Friction points and top fixes ordered by priority with expected CVR lift

White Page Cloaking

Click ⚪ to auto-generate a compliant “white page” (page jumelle) — a clean, corporate-style version of your landing served to ad-network reviewers and crawlers. Features:

• LLM generates a professional business page with About Us, Services, Contact sections
• Toggle cloaking on/off from the modal
• Bot detection via User-Agent (Googlebot, facebookexternalhit, AdsBot, etc.)
• Manual test: append ?safe=1 to any /l/slug URL
• Views counter skips bots — only real visitors are counted

Cloning & Import

Three ways to create a landing from existing content:

Offline Asset Hosting

Imported images, CSS, fonts, and videos are stored in Postgres (BYTEA) and served via /assets/:id with immutable cache headers. Your landing survives the original host going down. Limits: 40 images (10 MB each), 5 videos (50 MB each), 10 stylesheets (2 MB each, with recursive font/image sub-asset download).

Use 🗑 Asset GC in the toolbar to find and purge orphaned assets no longer referenced in any landing or version history snapshot.

Version History

Click ⏱ to view up to 20 auto-saved snapshots per landing. Every edit in the visual builder creates a snapshot before overwriting. Features:

• Preview any version in a new tab
• Restore a version (the current state is snapshotted first, so restores are always reversible)
• Delete individual versions
• Automatic GC: only the last 20 versions per landing are kept

Scheduled Publish / Unpublish

Click 📅 to set a future date/time for automatic status changes. Useful for coordinated launches, time-limited promos, and A/B test windows. The scheduler runs every 60 seconds and clears the field once it fires (one-shot). Quick presets: +1h, Tomorrow 9am, +1 week.

5 Built-in Templates

All templates render the full 28-field rich schema (12 sections: urgency bar, hero, problem, solution, benefits grid, testimonials, comparison, objections, pricing/guarantee, urgency, FAQ, final CTA):

You can also import custom templates from any URL using the 🕵️ Import → Template mode.

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.

Bot Protection (CAPTCHA) NEW

Stack three layers of bot filtering in front of your Redirect Tracker prelanders: Cloudflare Turnstile CAPTCHA, an invisible honeypot field, and a minimum dwell-time gate. Humans get through in <1s; bots get blocked at the door and never reach your offer.

The three layers

Setup (one-time, global)

Per-landing config

The challenge page

When protection is enabled, /r/:slug serves a minimal dark-themed verification page (spinner + "Verifying your connection..." message + optional Turnstile widget). The page runs the three checks client-side, then POSTs to /r/:slug/verify with:

{
  "cf_token": "0.xxx...",           // Turnstile token, null if CAPTCHA off
  "honeypot_value": "",              // empty for humans, filled by bots
  "started_at": 1713128400000,       // ms since page load
  "elapsed_ms": 1620,                // ms elapsed at submit
  "query": { "fbclid": "IwAR...", "utm_source": "fb" }
}

The server runs the three checks in order (honeypot → time gate → Turnstile). First failure short-circuits: a row is written to tracked_redirects with verification_status = failed_*, then either a 403 is returned or the visitor proceeds (in log mode).

Reporting

The stats box on every redirect tracker shows a per-method breakdown:

📊 Captures (last 500): 823     passed: 781
🛡 42 bots blocked (CAPTCHA: 30 · Honeypot: 8 · Time: 4)

Cloaking Workflow PRO

Trackily's cloaking system is built around a drag-and-drop Visual Workflow Builder. Legacy inline cloaking config has been retired — all cloaking now lives in reusable workflows you can attach to any campaign.

What a workflow can do

• Detect VPN / Proxy / Tor / datacenter IPs
• Identify reviewer IPs (Meta, Google, TikTok, Bing review teams)
• Reverse-DNS match against ad-platform crawlers
• Screen bot user-agents and behavioral fingerprint
• Route traffic by country, device, OS, browser, language
• A/B/C split-test at the traffic layer
• Rate-limit, delay-and-recheck, run custom JS rules

Built-in templates

The Visual Workflow Builder ships with several pre-built templates you can load with one click and customize:

• VPN Blocker — blocks VPN/Proxy/Tor and datacenter IPs, allows residential traffic.
• Facebook Shield — reviewer IP + reverse DNS + bot UA, safe page for ops.
• Google Ads Safe, TikTok Cloak, Push Traffic Pro, A/B Split, Stealth Max…

Built-in "VPN Blocker" workflow

On first launch, Trackily idempotently seeds a ready-to-use workflow named "VPN Blocker (Built-in)". Select it straight from the Cloaking Workflow dropdown in the Edit Campaign modal — no builder interaction required. If you rename or delete it, Trackily will not recreate it (the seeder checks by exact name before inserting).

Attaching a workflow to a campaign

1. Open or create a campaign.
2. Pick a workflow from the CLOAKING WORKFLOW dropdown at the top of the modal.
3. Save. Every click on /c/:slug runs through the workflow before reaching the flow engine.

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.

My Profile NEW

Every logged-in user gets a dedicated profile page, reachable from the avatar dropdown in the top-right header. Self-service account management — no admin needed to rename yourself or change your password.

What's on the page

Self-service endpoints

Any authenticated user can call these without admin permission:

• PUT /admin/api/users/me — update own name
• POST /admin/api/users/me/password — change password (current_password + new_password, bcrypt-verified server-side)

Header & Sidebar UI NEW

The admin chrome was reorganised along modern SaaS patterns. Key changes:

Top-right header

The top bar now carries five quick-access utilities, left to right:

Avatar dropdown menu

Click your avatar and you get a SaaS-style dropdown with the following items:

• Profile header — avatar, name, email, plan badge, inline Upgrade link
• My Profile — opens the profile page
• Settings
• Documentation — opens /docs
• What's new — opens the changelog modal and shows the current version (e.g. v3.2.0)
• Install App — appears only when the browser offers PWA install
• Separator
• Logout (red)

Sidebar accordion

Navigation is organised under two collapsible accordion sections so the sidebar stays compact even with 18+ pages:

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