Voluum macros & parameters

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.

73 entries (65 current/verified) · {clickid} Official docs

👋 Quick tip: Check the type badge before copying. A substitution macro inserts a value; an inbound parameter is the field name a platform expects when receiving a postback.

What are you setting up?

Choose a use case to keep only the fields that apply.

Showing 73 of 73 entries

Attribution

cid=

Parameter low confidence

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

This entry is retained for reference but was not confirmed in the latest official documentation. Verify it before using it in production.

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}

{click.id}

Substitution macro high confidence

Click ID for traffic-source postback

Offer URL Traffic Source Postback

{clickid}

Substitution macro high confidence

Voluum click ID

Offer URL Traffic Source Postback

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.

et=

Parameter low confidence

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

This entry is retained for reference but was not confirmed in the latest official documentation. Verify it before using it in production.

Postback (receive)

Requires custom conversion setup in Settings → Custom conversions.

{eventType}

Substitution macro high confidence

Custom conversion event type

Traffic Source Postback

{externalid}

Substitution macro high confidence

Traffic-source click ID

Offer URL Traffic Source Postback

{externalidparameter}

Substitution macro high confidence

External-ID type

Offer URL Traffic Source Postback

{referrerdomain}

Substitution macro high confidence

Referrer domain

Offer URL Traffic Source Postback

{trackingdomain}

Substitution macro high confidence

Tracking domain

Offer URL Traffic Source Postback

{transaction.id}

Substitution macro high confidence

Transaction ID passed from affiliate network

Traffic Source Postback

txid=

Parameter low confidence

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

This entry is retained for reference but was not confirmed in the latest official documentation. Verify it before using it in production.

Postback (receive)

Financial

{conversion.cost}

Substitution macro high confidence

Conversion cost

Traffic Source Postback

{cost}

Substitution macro high confidence

Visit cost

Offer URL Traffic Source Postback

{payout}

Substitution macro high confidence

Offer payout

Offer URL Traffic Source Postback

{payout.currency}

Substitution macro high confidence

Payout currency

Offer URL Traffic Source Postback

IDs

{campaign.id}

Substitution macro high confidence

Campaign ID

Offer URL Traffic Source Postback

{campaign.name}

Substitution macro high confidence

Campaign name

Offer URL Traffic Source Postback

{campaignid}

Substitution macro low confidence Legacy

Voluum campaign ID.

This entry is retained for reference but was not confirmed in the latest official documentation. Verify it before using it in production.

Traffic Source Postback

Current Voluum token reference uses different names for several related concepts; retained for migration/audit, not recommended for new configuration.

{offerid}

Substitution macro low confidence Legacy

Offer ID within Voluum.

This entry is retained for reference but was not confirmed in the latest official documentation. Verify it before using it in production.

Traffic Source Postback

Current Voluum token reference uses different names for several related concepts; retained for migration/audit, not recommended for new configuration.

{path.id}

Substitution macro high confidence

Path ID

Offer URL Traffic Source Postback

{path.name}

Substitution macro high confidence

Path name

Offer URL Traffic Source Postback

{trafficsource.id}

Substitution macro high confidence

Traffic source ID

Offer URL Traffic Source Postback

{trafficsource.name}

Substitution macro high confidence

Traffic source name

Offer URL Traffic Source Postback

{workspace.id}

Substitution macro high confidence

Workspace ID

Offer URL Traffic Source Postback

{workspace.name}

Substitution macro high confidence

Workspace name

Offer URL Traffic Source Postback

Geography

{city}

Substitution macro high confidence

City

Offer URL Traffic Source Postback

{country}

Substitution macro high confidence

Two-letter country code

Offer URL Traffic Source Postback

{countrycode}

Substitution macro low confidence Legacy

Two-letter country code of the visitor.

This entry is retained for reference but was not confirmed in the latest official documentation. Verify it before using it in production.

Offer URL Traffic Source Postback

Current Voluum token reference uses different names for several related concepts; retained for migration/audit, not recommended for new configuration.

{countryname}

Substitution macro high confidence

Country name

Offer URL Traffic Source Postback

{region}

Substitution macro high confidence

Region

Offer URL Traffic Source Postback

Device

{brand}

Substitution macro high confidence

Device brand

Offer URL Traffic Source Postback

{browser}

Substitution macro high confidence

Browser name

Offer URL Traffic Source Postback

{browserversion}

Substitution macro high confidence

Browser version

Offer URL Traffic Source Postback

{carrier}

Substitution macro high confidence

Mobile carrier

Offer URL Traffic Source Postback

{connection.type}

Substitution macro high confidence

Connection type

Offer URL Traffic Source Postback

{device}

Substitution macro high confidence

Device type

Offer URL Traffic Source Postback

{devicetype}

Substitution macro low confidence Legacy

Device type (Desktop, Mobile, Tablet).

This entry is retained for reference but was not confirmed in the latest official documentation. Verify it before using it in production.

Offer URL Traffic Source Postback

Current Voluum token reference uses different names for several related concepts; retained for migration/audit, not recommended for new configuration.

{ip}

Substitution macro high confidence

Visitor IP

Offer URL Traffic Source Postback

{isp}

Substitution macro high confidence

ISP name

Offer URL Traffic Source Postback

{language}

Substitution macro high confidence

Language

Offer URL Traffic Source Postback

{model}

Substitution macro high confidence

Device model

Offer URL Traffic Source Postback

{os}

Substitution macro high confidence

Operating system

Offer URL Traffic Source Postback

{osversion}

Substitution macro high confidence

Operating-system version

Offer URL Traffic Source Postback

{useragent}

Substitution macro high confidence

Visitor user agent

Offer URL Traffic Source Postback

Timestamps

{postbacktime}

Substitution macro high confidence

Postback time

Traffic Source Postback

{timestamp}

Substitution macro low confidence Legacy

UNIX timestamp of the click event.

This entry is retained for reference but was not confirmed in the latest official documentation. Verify it before using it in production.

Offer URL Traffic Source Postback

Current Voluum token reference uses different names for several related concepts; retained for migration/audit, not recommended for new configuration.

Custom Variables

{param1}

Substitution macro high confidence

Additional postback parameter 1

Offer URL Traffic Source Postback

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

{param2}

Substitution macro high confidence

Additional postback parameter 2

Offer URL Traffic Source Postback

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

{param3}

Substitution macro high confidence

Additional postback parameter 3

Offer URL Traffic Source Postback

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

{param4}

Substitution macro high confidence

Additional postback parameter 4

Offer URL Traffic Source Postback

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

{param5}

Substitution macro high confidence

Additional postback parameter 5

Offer URL Traffic Source Postback

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

{var1}

Substitution macro high confidence

Custom variable 1

Offer URL Traffic Source Postback

{var10}

Substitution macro high confidence

Custom variable 10

Offer URL Traffic Source Postback

{var2}

Substitution macro high confidence

Custom variable 2

Offer URL Traffic Source Postback

{var3}

Substitution macro high confidence

Custom variable 3

Offer URL Traffic Source Postback

{var4}

Substitution macro high confidence

Custom variable 4

Offer URL Traffic Source Postback

{var5}

Substitution macro high confidence

Custom variable 5

Offer URL Traffic Source Postback

{var6}

Substitution macro high confidence

Custom variable 6

Offer URL Traffic Source Postback

{var7}

Substitution macro high confidence

Custom variable 7

Offer URL Traffic Source Postback

{var8}

Substitution macro high confidence

Custom variable 8

Offer URL Traffic Source Postback

{var9}

Substitution macro high confidence

Custom variable 9

Offer URL Traffic Source Postback

Postback Receive

c=

Inbound parameter high confidence

Alias for click ID.

Postback (receive)

cid=

Inbound parameter high confidence

Voluum click ID.

Postback (receive)

Required.

currency=

Inbound parameter high confidence

Payout currency.

Postback (receive)

et=

Inbound parameter high confidence

Custom conversion event type.

Postback (receive)

p=

Inbound parameter high confidence

Alias for payout.

Postback (receive)

param1=

Inbound parameter high confidence

Additional conversion parameter 1.

Postback (receive)

param2=

Inbound parameter high confidence

Additional conversion parameter 2.

Postback (receive)

param3=

Inbound parameter high confidence

Additional conversion parameter 3.

Postback (receive)

param4=

Inbound parameter high confidence

Additional conversion parameter 4.

Postback (receive)

param5=

Inbound parameter high confidence

Additional conversion parameter 5.

Postback (receive)

payout=

Inbound parameter high confidence

Conversion payout.

Postback (receive)

txid=

Inbound parameter high confidence

Unique transaction ID for additional conversions.

Postback (receive)

Data sourced from Voluum's official documentation on 2026-09-22.