PropellerAds tracking tokens & macros
PropellerAds runs your push traffic across a huge spread of publisher zones, and the quality between those zones varies wildly. Append these macros to your destination URL and every click arrives stamped with the exact zone, subzone, and campaign it came from, so ValidVisit can attribute it down to the precise zone that delivered it and score that visit 0-100 for traffic quality.
Cross-check any macro against the network’s official documentation. PropellerAds official docs →
Attribution on PropellerAds hangs on a couple of tokens. The ${SUBID} macro is the per-click identifier you pass back for S2S tracking, but the token that actually names the sub-source you care about is {zoneid} (with {subzone_id} drilling one level deeper) alongside {campaign_id} for the campaign context. Note the format quirk: ${SUBID} uses the dollar-brace style while the zone and campaign tokens are plain curly braces like {zoneid} and {bannerid} — keep each one exactly as written or PropellerAds won't expand it, and you'll get a literal string back instead of the real ID.
Once every click is tied to its zone, the granularity becomes actionable. ValidVisit looks at 100+ data points per visit and rolls them into a single 0-100 quality score, then ranks the worst-performing zone_ids for you. ValidVisit only reports and scores — it never blocks a click — so you take that ranked list and act on it yourself: open the campaign's zone targeting → Exceptions in your PropellerAds dashboard and add the bad zones to the block list manually. The score points the finger at the underperforming zone or subzone, not at PropellerAds itself.
PropellerAds macro → ValidVisit param
| Token | PropellerAds macro | ValidVisit param | Example |
|---|---|---|---|
| Subscriber / Click ID (SUBID) *click | ${SUBID} | vv_click_id | a1b2c3d4e5f6 |
| Campaign ID *campaign | {campaign_id} | vv_campaign_id | 7654321 |
| Zone IDpublisher | {zoneid} | vv_publisher_id | 3456789 |
| Subzone IDplacement | {subzone_id} | vv_placement_id | 112233 |
| Banner / Creative IDcreative | {bannerid} | vv_creative_id | 998877 |
- PropellerAds macro
${SUBID}- ValidVisit param
vv_click_id- Example
- a1b2c3d4e5f6
- PropellerAds macro
{campaign_id}- ValidVisit param
vv_campaign_id- Example
- 7654321
- PropellerAds macro
{zoneid}- ValidVisit param
vv_publisher_id- Example
- 3456789
- PropellerAds macro
{subzone_id}- ValidVisit param
vv_placement_id- Example
- 112233
- PropellerAds macro
{bannerid}- ValidVisit param
vv_creative_id- Example
- 998877
* required for PropellerAds attribution.
Ready-to-use PropellerAds tracking URL
https://yoursite.com/landing?utm_source=propellerads&utm_medium=push&vv_click_id=${SUBID}&vv_campaign_id={campaign_id}&vv_publisher_id={zoneid}&vv_placement_id={subzone_id}&vv_creative_id={bannerid}Append these params to your landing-page URL — PropellerAds fills the macros at click time, so every visit arrives attributed and ready to score. No funnel hop.
The buyer pastes the list of bad zone IDs into the campaign’s Zone Limitation field set to Exclude (blacklist), or excludes individual subzones, and PropellerAds stops serving on them and reallocates budget to remaining zones.
PropellerAds tracking token FAQs
Which token identifies the sub-source I should judge?+
{zoneid} is the one that names the publisher zone behind each click, and {subzone_id} narrows it further. {campaign_id} gives you campaign context and ${SUBID} is the per-click ID for S2S, but zone and subzone are what you rank and act on for traffic quality.
Do I need a funnel hop or tracker in the middle?+
No. These are ordinary URL parameters appended to your destination link. PropellerAds fills in the values when it fires the click — there's no extra hop or extra script required, you just add the macros to the URL.
Where do I act on the zones ValidVisit flags?+
Inside PropellerAds, not in ValidVisit. ValidVisit ranks the bad zone_ids; you add them to your campaign's zone targeting → Exceptions / block list manually in the PropellerAds dashboard. ValidVisit reports and scores only — it never excludes anything for you.
Score every PropellerAds click — and find the fake ones.
See which PropellerAds publishers and placements send real buyers vs. bots.
Free trial at launch · just your email
One script · no cookies · no fingerprinting · raw IP never stored