Voluum macros

Voluum is a performance tracking platform. Postback parameters use curly-bracket tokens {like_this}. The core postback parameter is cid= which must receive the Voluum click ID.

25 macros · {clickid} Official docs

👋 Quick tip: Every macro below has a "Here's what I'd do" section — a plain-English note on exactly when and how to use it. If you're ever unsure, that's the bit to read.

Attribution

{clickid}

Voluum's unique click ID. Pass this in your offer URL so the affiliate network can return it in the postback.

Offer URL

Used in the offer URL to pass the Voluum click ID to the affiliate network. The network then returns it in the postback as the cid= parameter value.

cid=

The mandatory postback parameter. The affiliate network passes the Voluum click ID back here to register a conversion.

Postback (receive)

This is the parameter name Voluum expects — not a macro. Replace REPLACE with the affiliate network's click ID macro. e.g. cid={affiliate_network_clickid_token}

{externalid}

The traffic source's click ID that was passed to Voluum. Used in traffic source postback URLs to relay the click ID back.

Traffic Source Postback

txid=

Optional postback parameter for a unique transaction ID. Used to track upsells and secondary conversion steps.

Postback (receive)

et=

Event type parameter. Used to track different custom conversion types.

Postback (receive)

Requires custom conversion setup in Settings → Custom conversions.

Financial

{payout}

Revenue amount per conversion. Used in traffic source postback URLs that Voluum fires outbound.

Traffic Source Postback

{cost}

Cost per click or conversion. Used in traffic source postback URLs.

Traffic Source Postback

Sub IDs

param1=

Additional data parameter 1. Pass any affiliate network token here to record extra conversion data.

Postback (receive)

Requires 'Include additional parameters in the postback URL' toggle to be enabled in Voluum settings.

param2=

Additional data parameter 2.

Postback (receive)

Requires 'Include additional parameters in the postback URL' toggle to be enabled.

param3=

Additional data parameter 3.

Postback (receive)

Requires 'Include additional parameters in the postback URL' toggle to be enabled.

param4=

Additional data parameter 4.

Postback (receive)

Requires 'Include additional parameters in the postback URL' toggle to be enabled.

param5=

Additional data parameter 5.

Postback (receive)

Requires 'Include additional parameters in the postback URL' toggle to be enabled.

IDs

{campaignid}

Voluum campaign ID.

Traffic Source Postback

{offerid}

Offer ID within Voluum.

Traffic Source Postback

Geography

{countrycode}

Two-letter country code of the visitor.

Offer URL Traffic Source Postback

Device

{devicetype}

Device type (Desktop, Mobile, Tablet).

Offer URL Traffic Source Postback

{os}

Operating system of the visitor's device.

Offer URL Traffic Source Postback

{browser}

Browser name of the visitor.

Offer URL Traffic Source Postback

{ip}

IP address of the visitor.

Offer URL Traffic Source Postback

{useragent}

Full user agent string of the visitor's device.

Offer URL

{language}

Browser language of the visitor.

Offer URL

Timestamps

{timestamp}

UNIX timestamp of the click event.

Offer URL Traffic Source Postback

Custom Variables

{var1}

Custom variable 1. Maps to traffic source custom parameters for outbound postbacks.

Traffic Source Postback

{var2}

Custom variable 2.

Traffic Source Postback

{var3}

Custom variable 3.

Traffic Source Postback

Data sourced from Voluum's official documentation on 2026-04-18.