Voluum tokens and tracking parameters guide
Technical Guide

Voluum Tokens Guide

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.

Tokens & Variables Postback-Ready Setup Steps Updated Jul 2026

Set Up Tokens on a Live Account

Follow along in Voluum during the 14-day free trial. No credit card required.

Start Free Trial →

Table of Contents

  1. What Are Voluum Tokens?
  2. Common Voluum Tokens
  3. Custom Variables Explained
  4. How to Set Up Tokens
  5. Fixing Empty Token Values
  6. Frequently Asked Questions

What Are Voluum Tokens?

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.

Common Voluum Tokens

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 roleWhat it capturesWhere it is used
Click IDUnique ID for each clickOffer URL & postback (essential)
Campaign ID / nameWhich campaign the click belongs toReporting, passed to offer
Traffic sourceThe source sending the clickReporting breakdowns
CostPer-click or CPM costROI calculation
Custom variablesZone, site, creative, placement, etc.Optimization segments
PayoutConversion value from the networkSent 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.

Build Your First Tracking URL

Voluum generates token-ready URLs automatically. Try it on a live campaign — 14-day trial, no card.

Start Your Free Trial →

Custom Variables Explained

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.

How to Set Up Tokens

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.

Fixing Empty Token Values

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.

Put This Into Practice

Set up tokens, postbacks and reports on a real account. 14-day free trial, no credit card required.

Get Started with Voluum →

Frequently Asked Questions

What are Voluum tokens?
Voluum tokens are placeholders in your tracking URLs that get replaced with real data at the moment of a click — things like the traffic source, zone, campaign, click ID, and cost. They are how information is passed between your traffic source, Voluum, and your offer.
What is the most important Voluum token?
The click ID token is the most important. It uniquely identifies each click and is what you place in your postback URL so that conversions reported by the affiliate network are matched back to the exact click that generated them. Without it, ROI tracking does not work.
What are Voluum custom variables?
Custom variables are Voluum's flexible token slots where you store any traffic-source data you want to track, such as zone ID, site ID, creative, or placement. You can then break down reports by those variables to find winning and losing segments to scale or cut.
Why are my Voluum tokens showing empty values?
Empty token values usually mean the traffic-source macro was not added to the campaign URL, was misspelled, or the source does not pass that data. Re-check the token mapping against the traffic source's documentation and send a fresh test click, since old clicks will not back-fill.
Research Notes & Transparency:
Disclosure: This website contains affiliate links. If you click on a link and make a purchase, we may receive a commission at no additional cost to you. Our reviews are based on independent research and our honest opinions.
Try Voluum Free (14 Days) →