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 judge it Valid or Invalid.
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}} is the unique conversion ID HilltopAds' postback carries, and it lets ValidVisit tie each visit to the 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 invalid share so you can act on the worst offenders: you add those zones to HilltopAds' campaign blacklist yourself. ValidVisit judges after the visit arrives and never touches your HilltopAds 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 judge. No funnel hop.
See which HilltopAds sources send bots.
- Every visit judged Valid or Invalid, worst source first.
- Attributed through the HilltopAds tokens above, down to the placement.
- Works beside your tracker, with nothing added to the click path.
What HilltopAds tokens let you break bots down by
- Zone ID — ID of the traffic source / zone the click came from — the unit you blacklist in the campaign.
Carries a per-click id, stored with each visit so a verdict traces back to the click.
- IP exclusiondocumented
- Device targetingdocumented
- OS targetingdocumented
- Browser targetingdocumented
- Connection typedocumented
- Languagedocumented
Tokens last verified against HilltopAds’s docs on 2026-10-02.
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 is the unique conversion ID HilltopAds' postback carries, 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.
Tracking tokens for other pop / pop-under networks
Judge every HilltopAds visit — and find the fake ones.
See which HilltopAds publishers and placements send real buyers vs. bots.
Join the waitlist with just your email · 7-day trial at launch
One script · no cookies · no device IDs · raw IP never stored