Documentation

Campaigns, sources, offers, and flows

Updated 17 Nov 2026

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.

The objects

A traffic source is where the click comes from. It stores a parameter template (platform, the click-id parameter name, optional cost and zone parameters, and extra parameters) and a postback URL template used when a conversion is booked. Status is active, paused, or draft.

An affiliate network is who pays you. It has a name, a postback URL template, a network key, a currency, and a status. If you leave the key empty on create, one is generated. A key you type must be 32–128 characters and only letters, digits, _, and -. Rotate it from the network page or with the MCP tool rotate_network_key. The old postback URL stops working immediately.

An offer belongs to one network. The URL template must be http or https and must contain {click_id}. Payout type is fixed, percent, or from_postback. You can set a daily cap. Status is active, paused, or draft.

A lander is hosted (files on this server) or external (an http or https URL). See landers.

A flow is a named set of paths and rules. Paths hold weighted landers and offers. Rules send a visitor to a path or to a safe-page URL. See flow rules.

A campaign ties one traffic source, one domain, and one flow together. It has a cost model (cpc, cpm, cpa, manual, or auto), a timezone, and a redirect type (302, meta, double_meta, or js). bind_visitor is what smart rotation uses to avoid repeating a lander or offer. Only campaigns with status active are in the click snapshot. A paused or draft campaign answers 404 campaign not found.

A domain is a hostname you registered, with an SSL status and certificate mode. One domain can be the default.

What a click does

The tracking link the admin builds is https://<domain>/click/<campaign uuid> plus the query parameters from the source template. The handler is GET /click/{campaignID}.

The server mints a UUIDv7 click id, sets vt_vid (visitor, 365 days) and vt_cid (this click, 24 hours), and stores the source’s external click id, zone, tokens 1–10, and fbclid, gclid, ttclid, and msclkid when they are present. The flow decision runs next. A hosted lander redirects to /lp/<lander id>/. An external lander or a direct offer redirects to the expanded URL. {click_id} in an offer URL is this click.

The lander’s link to the offer is GET /go, using cid, click_id, or the vt_cid cookie. The campaign’s redirect type applies to both the click and /go.

If the snapshot is not loaded yet, the click returns 503. If the flow is missing or paused, the response is 404. If every lander and offer on the chosen path is paused, the response is 404 and there is no fallback path. Offer daily caps skip capped offers; if every offer on the path is capped, the click is also 404.

Paused sources do not drop the campaign by themselves, but a paused source is outside the active snapshot the click uses for source fields. Conversions are a separate request: the network calls your postback URL.