Skip to main content

Dynamic Values for Tracking

Adding tracking parameters to your destination URLs allows you to collect valuable data about your campaign performance and attribute conversions accurately.

Why Use Tracking Parameters?​

Tracking parameters help you:

  • Attribute conversions - Know which campaign, creative, and source drove each conversion
  • Optimize performance - Identify top-performing sources for Source Optimization
  • Analyze traffic - Understand user demographics and device types
  • Calculate ROI - Track cost per conversion accurately

Available Tracking Macros​

Pushnami provides the following macros that dynamically insert relevant data into your URLs. These are available in the Link Builder for easy implementation.

Essential Tracking Parameters​

NameMacroDescriptionExample Output
Conversion ID<<conversion_id>>Unique Pushnami click identifier for conversion trackingabc123def456
Cost<<ad_cost>>Current bid amount (reflects source-level optimization bids)0.15

Campaign & Creative Identifiers​

NameMacroDescriptionExample Output
Campaign ID{{=data.adcampaignid}}Your campaign's reference IDC0001234
Creative ID{{=data.adcreativeid}}The creative's reference IDC0001234-001
Website/Source ID{{=data.adsourceid}}Publisher website reference IDS0004483

User Location Data​

NameMacroDescriptionExample Output
Country{{=data.dcountry}}Detected country codeUS
State{{=data.dstate}}Detected stateTexas
City{{=data.dcity}}Detected cityAustin
ZIP Code{{=data.dzip}}Detected ZIP code78757

Device & Technical Data​

NameMacroDescriptionExample Output
Device Type{{=data.ddevice}}Device categorymobile, desktop, tablet
IP Address{{=data.dip}}User's IP address198.54.146.xxx
User Agent{{=data.dua}}Browser user agent stringMozilla/5.0...

User Demographics (When Available)​

NameMacroDescriptionExample Output
Age{{=data.age}}User's age (if available)35
Gender{{=data.gender}}User's gender (if available)M, F

Conversion Tracking​

For detailed setup instructions, implementation examples (JavaScript, PHP, Node.js), and platform integrations (Everflow), see the dedicated Conversion Tracking guide.

Example URLs​

Basic Tracking​

Track campaign, creative, and source:

https://yoursite.com/offer?campaign={{=data.adcampaignid}}&creative={{=data.adcreativeid}}&source={{=data.adsourceid}}

Full Conversion Tracking​

Complete setup for conversion attribution:

https://yoursite.com/offer?cid=<<conversion_id>>&campaign={{=data.adcampaignid}}&source={{=data.adsourceid}}&cost=<<ad_cost>>

Geographic Targeting Analysis​

Track user location:

https://yoursite.com/offer?cid=<<conversion_id>}&state={{=data.dstate}}&city={{=data.dcity}}&zip={{=data.dzip}}

Device Analysis​

Track device information:

https://yoursite.com/offer?cid=<<conversion_id>>&device={{=data.ddevice}}&country={{=data.dcountry}}

Important Notes​

For Source Optimization​

URL Encoding​

All macro values are automatically URL-encoded when inserted into your links.

Missing Data​

If a data point isn't available for a particular user, the macro will be empty. Consider using fallback values in your tracking system.

Integration Examples​

Google Analytics​

https://yoursite.com/offer?utm_source=pushnami&utm_medium=push&utm_campaign={{=data.adcampaignid}}&utm_content={{=data.adcreativeid}}

Affiliate Networks​

Most affiliate networks accept sub-ID parameters. Use Pushnami macros to populate them:

https://network.com/offer?aff_sub1=<<conversion_id>>&aff_sub2={{=data.adsourceid}}&aff_sub3={{=data.adcampaignid}}

Next Steps​