Tokens are how data moves between your traffic source, Voluum, and your offer. This guide explains what Voluum tokens and custom variables are, the ones you will actually use, and how to set them up without empty columns.
Follow along in Voluum during the 14-day free trial. No credit card required.
Start Free Trial →Voluum tokens are placeholders you put inside your tracking URLs. At the moment a visitor clicks, Voluum replaces each token with the real value for that click — the traffic source, the zone or placement, the campaign, a unique click ID, the cost, and more. Tokens are the plumbing of accurate tracking: they carry information from your traffic source into Voluum, and from Voluum onward to your landing page and offer.
Get them right and every report column fills with meaningful data you can optimize on. Get them wrong and you see blank columns and cannot tell which placement or creative is winning. Tokens come in two directions: values a traffic source passes into Voluum (its macros mapped to your custom variables), and Voluum tokens you pass out to offers and postbacks. This guide covers both.
You will not use every token, but a handful appear in almost every campaign. Exact token syntax is shown in Voluum's interface when you build a URL, so treat these as the roles to look for rather than fixed strings.
| Token role | What it captures | Where it is used |
|---|---|---|
| Click ID | Unique ID for each click | Offer URL & postback (essential) |
| Campaign ID / name | Which campaign the click belongs to | Reporting, passed to offer |
| Traffic source | The source sending the click | Reporting breakdowns |
| Cost | Per-click or CPM cost | ROI calculation |
| Custom variables | Zone, site, creative, placement, etc. | Optimization segments |
| Payout | Conversion value from the network | Sent back via postback |
The click ID is the one non-negotiable token. Without it, Voluum cannot connect a conversion back to the click that caused it, and your ROI data falls apart. Everything else adds detail; the click ID makes tracking work at all.
Voluum generates token-ready URLs automatically. Try it on a live campaign — 14-day trial, no card.
Start Your Free Trial →Custom variables are Voluum's flexible token slots. Each traffic source exposes its own data through macros — a native network might pass a zone ID and a widget ID, a push network a subscriber age or a publisher ID. You decide which of those you want to track and map each one to a Voluum custom variable. From then on, every click carries that data, and you can slice reports by it.
This is where real optimization happens. When you can break a campaign down by zone or placement, you spot the handful of sources burning your budget and the few quietly printing profit. Map the variables that let you cut and scale at the level your traffic source allows. Our whitelist & blacklist guide shows how to act on those segments once you can see them.
Setting tokens up correctly is a short, repeatable process:
1. Pick your traffic source template. Choose the built-in source in Voluum so common tokens are pre-mapped, or add a custom source if yours is not listed.
2. Map source tokens to Voluum variables. Assign each traffic-source macro (zone, site, creative) to a custom variable so the data is captured on every click.
3. Add Voluum tokens to the campaign URL. Insert tokens such as the click ID into the offer or landing page URL so values pass through the funnel.
4. Configure the postback. Put the click ID token into your affiliate network's postback URL so conversions tie back to the right click. Our postback setup guide covers this in depth.
5. Test with a real click. Send one test click and confirm the token values show up correctly in Voluum's report columns before scaling spend.
The most common token problem is blank columns in your reports. Nearly always the cause is one of three things: the traffic-source macro was never added to the campaign URL, the macro was misspelled or uses the wrong syntax, or the source simply does not pass that particular data. Work through them in that order.
Re-open the traffic source's own documentation, confirm the exact macro strings, and compare them against what you mapped in Voluum. Then send a fresh test click — old clicks will not back-fill. If a value is genuinely not provided by the source, remove that variable so you are not chasing data that will never arrive. For a broader walkthrough of tracking setup, see our Voluum setup guide.
Set up tokens, postbacks and reports on a real account. 14-day free trial, no credit card required.
Get Started with Voluum →