Velotrak

A self-hosted ad tracker whose built-in MCP server lets AI agents (Claude, Cursor, etc.) manage campaigns, offers, landers and reports.

Dokumentation

Documentation

Velotrak docs

Velotrak is a self-hosted ad tracker: one Go binary, PostgreSQL for the ledger, and ClickHouse for clicks. These pages explain how to install it and how campaigns, flows, postbacks, CAPI, reports, MCP, backup, and licenses work in the current product.

Start

  • Getting started with Velotrak

    Velotrak is a self-hosted ad tracker: one Go program on Linux, PostgreSQL for the ledger, and ClickHouse for clicks. Install with one command, create the admin in the wizard, then send traffic to a /click/ link.
  • Install Velotrak on Linux

    On a Linux server, as root, run curl -fsSL https://velotrak.app/install.sh | sudo bash. The script installs Docker if needed, starts PostgreSQL and ClickHouse on localhost, and runs Velotrak as a systemd service.
  • Cloudflare in front of Velotrak

    When Cloudflare connects straight to Velotrak, the click stores the visitor from CF-Connecting-IP, not the edge address. Use SSL mode Full (strict) with a certificate file. The built-in ACME client cannot issue or renew while that proxy terminates TLS.

Tracking

  • Campaigns, sources, offers, and flows

    A campaign binds a traffic source, a domain, and a flow. The public link is /click/<campaign id>. The flow picks a path, then a lander or an offer, and the click id follows the visitor to the network postback.
  • Flow rules and condition fields

    A flow evaluates enabled rules by priority and sends the click to a path or a safe page. The built-in fields are 15 visitor properties plus token1–token10. Traffic-source parameters are extra fields. An enabled rule with no condition matches nothing.
  • Landing pages in Velotrak

    A lander is either files Velotrak serves at /lp/<id>/ or an external URL. Upload a ZIP of up to 25 MiB, or edit HTML, CSS, and JS in the file API. Put index.html at the root so the lander URL has a page.
  • Conversions and postbacks

    The affiliate network calls /postback/<network key> with the click id. Approved, pending, rejected, refunded, and trash are the stored statuses. A click can only be booked by the network that owns the offer it was sent to.
  • CAPI for Meta, TikTok, and Google

    Velotrak sends an approved conversion to Meta, TikTok, or Google from an integration you create in the admin. Free allows one CAPI account per platform. Pro, Team, and Founder do not cap the count. CAPI delivery is not gated by the license.
  • Cost models and allocation

    Each campaign has a cost model. CPC and CPM write a cost on the click. CPA, manual, and auto write zero at click time. Manual and auto campaigns can receive a daily total that is split across that day's clicks. Automatic pull from ad accounts is a Pro feature.
  • Reports and saved views

    Reports group the click log by campaign, offer, geography, device, tokens, and time. Free queries the last 15 days and at most 2 dimensions. Pro and above keep full history and 5 dimensions. Each user can save a view. CSV export uses the same query.

Operate

  • Connect an AI assistant with MCP

    An admin creates a token in the Velotrak admin. The client sends Authorization: Bearer vtmcp_… to POST /mcp on the tracker origin. Edits and deletes return a diff and wait for the same call with diff_token. Free tokens are read-only.
  • Backup and restore

    Backups are logical dumps of PostgreSQL, kept under the data directory, seven copies. ClickHouse click history is not in the file. Restore replaces rows in one transaction after you send the confirmation word, and it does not include master.key.
  • Plans, limits, and offline grace

    Free is $0, Pro is $49 a month or $490 a year, Team is $99 a month or $990 a year, and Founder is $399 once. Clicks are not metered. A lapsed subscription has 7 days of read-only paid access, then Free. A paid license that cannot phone home for 30 days stays fully paid.
  • Import from Binom or Keitaro

    Velotrak imports its own export and JSON from Binom or Keitaro. There is no Voluum importer in the product. The Binom and Keitaro adapters bring paths, offers, and external landers. They do not import flow rules. Free stops at 20 campaigns in one import.
  • Users, roles, and API keys

    Roles are admin, operator, and viewer. Operator and viewer exist only on Team. API keys are a Team feature and are either read-only or read-write, and read-write is capped at operator. Disabling a user ends their sessions immediately.
  • Troubleshooting Velotrak

    A click 404s when the campaign or flow is not active, or when the path has no active lander and offer. A postback 403s when the network key does not belong to the click's offer. LP Protect answers everyone else with an empty 403.