HilltopAds tracking tokens & macros
On HilltopAds, pop traffic flows in from thousands of publisher zones, and by default a click just lands on your page with no record of which zone sent it. Appending these macros stamps every visit with its origin, so ValidVisit can attribute each visit to its exact zone and score it 0-100 for traffic quality.
Cross-check any macro against the network’s official documentation. HilltopAds official docs →
Attribution on HilltopAds hinges on two of the double-brace macros in your landing URL. The required {{token}} carries the click id that lets ValidVisit tie each visit back to the precise click HilltopAds recorded, while {{zoneid}} names the publisher zone that actually served the pop. Adding {{campaignid}} and {{adid}} is optional but worth it for rollups by campaign and creative. Note that HilltopAds uses the lowercase double-curly format ({{zoneid}}, not [ZONEID] or {SUBID}), so paste the macros exactly as written or the network will pass them through unexpanded.
Once each click is tied to its {{zoneid}}, you stop guessing at the campaign level and start seeing which individual zones send valid traffic and which send invalid traffic and bots. ValidVisit ranks the bad zoneid values by their quality scores so you can act on the worst offenders: you add those zones to HilltopAds' campaign blacklist yourself. ValidVisit only reports and scores after the click arrives, it never blocks anything or touches your campaigns, and the exclusion always happens manually in your own HilltopAds dashboard. The blame sits with the underperforming zone, not with HilltopAds.
HilltopAds macro → ValidVisit param
| Token | HilltopAds macro | ValidVisit param | Example |
|---|---|---|---|
| Campaign IDcampaign | {{campaignid}} | vv_campaign_id | 99213 |
| Zone IDpublisher | {{zoneid}} | vv_publisher_id | A1B2C3D4 |
| Ad IDad | {{adid}} | vv_ad_id | E5F6G7H8 |
| Conversion Token (Click ID) *click | {{token}} | vv_click_id | ck_77a2 |
- HilltopAds macro
{{campaignid}}- ValidVisit param
vv_campaign_id- Example
- 99213
- HilltopAds macro
{{zoneid}}- ValidVisit param
vv_publisher_id- Example
- A1B2C3D4
- HilltopAds macro
{{adid}}- ValidVisit param
vv_ad_id- Example
- E5F6G7H8
- HilltopAds macro
{{token}}- ValidVisit param
vv_click_id- Example
- ck_77a2
* required for HilltopAds attribution.
Ready-to-use HilltopAds tracking URL
https://yoursite.com/landing?utm_source=hilltopads&utm_medium=pop&vv_campaign_id={{campaignid}}&vv_publisher_id={{zoneid}}&vv_ad_id={{adid}}&vv_click_id={{token}}Append these params to your landing-page URL — HilltopAds fills the macros at click time, so every visit arrives attributed and ready to score. No funnel hop.
The buyer opens the campaign’s BlackList setting and pastes the non-profitable ad-zone IDs separated by commas, then saves; those zones are removed from the campaign’s traffic sources (BlackList and WhiteList are mutually exclusive per campaign).
HilltopAds tracking token FAQs
Which token identifies the zone I should judge on HilltopAds?+
{{zoneid}} is the sub-source token. It resolves to the individual publisher zone that served your pop, and it is the value ValidVisit ranks so you know exactly which zones to blacklist.
Which macro is required, and what does it do?+
The Conversion Token {{token}} is the only required macro. It carries the HilltopAds click id, which lets ValidVisit match each arriving visit back to its original click. {{campaignid}} and {{adid}} are optional and only add reporting granularity.
Do I need a funnel hop or tracker to use these on HilltopAds?+
No. These are plain URL parameters you append to your landing page link inside your HilltopAds campaign settings. HilltopAds substitutes the real values at click time, so there is no funnel hop, script, or extra hop required.
Score every HilltopAds click — and find the fake ones.
See which HilltopAds 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