RichAds tracking tokens & macros
RichAds buys are pushed across thousands of publisher sources, so spend that looks fine at the campaign level can hide wildly different traffic underneath. Appending these macros to your landing-page URL lets ValidVisit attribute every visit back to its exact source id, then score it 0-100 for traffic quality so you can see which sources are actually sending real users.
Cross-check any macro against the network’s official documentation. RichAds official docs →
On RichAds, attribution rides on the bracketed macros the network fills in at click time. The required [CLICK_ID] stamps each click with RichAds' own unique click identifier so ValidVisit can match it one-to-one, and [CAMPAIGN_ID] keys it to the buy. The tokens that matter for cleanup, though, are [PUBLISHER_ID] and [SITE_ID], which carry the publisher source the traffic came from, alongside optional context like [CREATIVE_ID] and, on RichPush, [SUB_LIST_ID] for the subscriber list. Note the format quirk: RichAds macros are all-caps inside square brackets, so they must be pasted exactly as written or the network won't replace them.
This matters because campaign-level numbers average good and bad sources together. Once each click is tied to its source id, ValidVisit ranks the worst-performing sources by IVT — and the call to action is yours to make: take the bad source ids and add them to the campaign's Black/White lists (or an auto-rule) inside RichAds. ValidVisit only reports and scores the traffic after it arrives; it never blocks anything and never edits your campaigns. The actual exclusion happens manually in your own RichAds dashboard, and the blame sits with the offending source, not with RichAds.
RichAds macro → ValidVisit param
| Token | RichAds macro | ValidVisit param | Example |
|---|---|---|---|
| Click ID *click | [CLICK_ID] | vv_click_id | [CLICK_ID] |
| Campaign ID *campaign | [CAMPAIGN_ID] | vv_campaign_id | 1234567 |
| Campaign Namecampaign | [CAMPAIGN_NAME] | vv_campaign_name | My_Push_Campaign |
| Creative IDcreative | [CREATIVE_ID] | vv_creative_id | 987654 |
| Publisher IDpublisher | [PUBLISHER_ID] | vv_publisher_id | 55012 |
| Site IDplacement | [SITE_ID] | vv_placement_id | 778899 |
| Subscriber List ID (RichPush)adset | [SUB_LIST_ID] | vv_adset_id | 44021 |
- RichAds macro
[CLICK_ID]- ValidVisit param
vv_click_id- Example
- [CLICK_ID]
- RichAds macro
[CAMPAIGN_ID]- ValidVisit param
vv_campaign_id- Example
- 1234567
- RichAds macro
[CAMPAIGN_NAME]- ValidVisit param
vv_campaign_name- Example
- My_Push_Campaign
- RichAds macro
[CREATIVE_ID]- ValidVisit param
vv_creative_id- Example
- 987654
- RichAds macro
[PUBLISHER_ID]- ValidVisit param
vv_publisher_id- Example
- 55012
- RichAds macro
[SITE_ID]- ValidVisit param
vv_placement_id- Example
- 778899
- RichAds macro
[SUB_LIST_ID]- ValidVisit param
vv_adset_id- Example
- 44021
* required for RichAds attribution.
Ready-to-use RichAds tracking URL
https://yoursite.com/landing?utm_source=richads&utm_medium=push&vv_click_id=[CLICK_ID]&vv_campaign_id=[CAMPAIGN_ID]&vv_campaign_name=[CAMPAIGN_NAME]&vv_creative_id=[CREATIVE_ID]&vv_publisher_id=[PUBLISHER_ID]&vv_placement_id=[SITE_ID]&vv_adset_id=[SUB_LIST_ID]Append these params to your landing-page URL — RichAds fills the macros at click time, so every visit arrives attributed and ready to score. No funnel hop.
Paste the bad 32-character publisher/site source IDs into the campaign’s Black list field, one ID per line with no extra characters, and untick bad sublists in the Sources selector.
RichAds tracking token FAQs
Which RichAds token identifies the source I should exclude?+
The publisher source is carried by [PUBLISHER_ID] and [SITE_ID]. ValidVisit ties each visit to that source id and ranks the ones sending invalid traffic, so you know exactly which entries to put on your campaign Black/White lists. [CLICK_ID] and [CAMPAIGN_ID] are the required macros that let us match every visit back to its campaign.
Do I need a tracker or funnel hop to use these macros?+
No. These are plain URL parameters appended to your destination URL. RichAds substitutes the bracketed macros at click time and the values land directly in ValidVisit — there is no funnel hop, no extra hop, and no separate tracker required.
Where do I add the macros, and how does the exclusion actually happen?+
Add the macros to your campaign's target URL in RichAds, keeping each one in its exact all-caps bracketed form. ValidVisit then scores the incoming traffic 0-100 per source. To act on a bad source you add it manually to the campaign Black/White lists (or an auto-rule) in your RichAds dashboard — ValidVisit reports and scores only, it does not exclude anything for you.
Score every RichAds click — and find the fake ones.
See which RichAds 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