NewsBreak Ads tracking tokens & macros
NewsBreak isn't an open publisher network the way Taboola or Outbrain are, it's a single local-news content app, and your native ads run inside NewsBreak's own feed rather than across thousands of third-party sites. That changes what 'publisher' even means here: instead of scoring individual outside sites, the unit worth watching is the ad set or placement inside NewsBreak's app that served the impression. Append NewsBreak's macros to your destination URL and ValidVisit attributes each visit down to that level, then scores it 0-100.
Cross-check any macro against the network’s official documentation. NewsBreak Ads official docs →
NewsBreak's macros use double-underscore, all-caps placeholders rather than braces, and __CALLBACK_PARAM__ is the one that matters most, it's the click identifier NewsBreak returns on every visit and it's required for ValidVisit to attribute anything back to this network at all. __ADSET_ID__ is the closest thing NewsBreak has to a placement or sub-publisher unit, since there's no third-party site to name, the ad set is what actually varies in quality from one grouping of impressions to the next. Round it out with __CAMPAIGN_ID__ and __CAMPAIGN_NAME__ for reporting, plus __AD_ID__ and __CREATIVE_ID__ if you're running multiple creatives per ad set and want to see which one is underperforming. All six resolve automatically inside the NewsBreak app once the macros are present in your link, there's no separate feed or file to configure on NewsBreak's side.
Because everything runs inside one app rather than across an open exchange, the usual 'is this publisher's traffic bad' question doesn't apply the same way, what you're really asking is whether a particular ad set or targeting configuration is attracting engagement that doesn't hold up. Scoring by __ADSET_ID__ answers that, letting you compare ad sets against each other inside the same campaign instead of judging the whole NewsBreak spend as one unit. ValidVisit's role stops at delivering that comparison, the scoring and attribution happen automatically, but nothing gets paused or excluded on ValidVisit's end. If an ad set keeps coming back with a poor score, adjusting its targeting or turning it off is something you do directly in the NewsBreak Ads dashboard.
NewsBreak Ads macro → ValidVisit param
| Token | NewsBreak Ads macro | ValidVisit param | Example |
|---|---|---|---|
| Callback Parameter (click ID) *click | __CALLBACK_PARAM__ | vv_click_id | abc123xyz |
| Campaign IDcampaign | __CAMPAIGN_ID__ | vv_campaign_id | 123456 |
| Campaign Namecampaign | __CAMPAIGN_NAME__ | vv_campaign_name | 123456 |
| Ad Set IDplacement | __ADSET_ID__ | vv_placement_id | plc_7 |
| Ad IDad | __AD_ID__ | vv_ad_id | 456789 |
| Creative IDcreative | __CREATIVE_ID__ | vv_creative_id | 987 |
- NewsBreak Ads macro
__CALLBACK_PARAM__- ValidVisit param
vv_click_id- Example
- abc123xyz
- NewsBreak Ads macro
__CAMPAIGN_ID__- ValidVisit param
vv_campaign_id- Example
- 123456
- NewsBreak Ads macro
__CAMPAIGN_NAME__- ValidVisit param
vv_campaign_name- Example
- 123456
- NewsBreak Ads macro
__ADSET_ID__- ValidVisit param
vv_placement_id- Example
- plc_7
- NewsBreak Ads macro
__AD_ID__- ValidVisit param
vv_ad_id- Example
- 456789
- NewsBreak Ads macro
__CREATIVE_ID__- ValidVisit param
vv_creative_id- Example
- 987
* required for NewsBreak Ads attribution.
Ready-to-use NewsBreak Ads tracking URL
https://yoursite.com/landing?utm_source=newsbreak-ads&utm_medium=native&vv_click_id=__CALLBACK_PARAM__&vv_campaign_id=__CAMPAIGN_ID__&vv_campaign_name=__CAMPAIGN_NAME__&vv_placement_id=__ADSET_ID__&vv_ad_id=__AD_ID__&vv_creative_id=__CREATIVE_ID__Append these params to your landing-page URL — NewsBreak Ads fills the macros at click time, so every visit arrives attributed and ready to score. No funnel hop.
A buyer cannot upload a bad-ID list; the most they can do is run a Custom Report by Placement and then restrict the ad set to exclude a whole platform (e.g. drop Premium Partner), or — managed accounts only — ask their account manager to denylist specific publishers via Brand Suitability Controls.
NewsBreak Ads tracking token FAQs
What counts as the 'publisher' on NewsBreak if it's not an open network?+
There isn't one in the usual sense. NewsBreak ads run inside NewsBreak's own app and feed, so the closest equivalent is __ADSET_ID__, the placement or targeting group that served the impression, which is what ValidVisit scores in place of a third-party site.
Which macro is required for ValidVisit to attribute a visit?+
__CALLBACK_PARAM__. It's NewsBreak's click identifier and the only token ValidVisit strictly needs; __CAMPAIGN_ID__, __ADSET_ID__, __AD_ID__, and __CREATIVE_ID__ add detail on top of that base attribution.
How do I act if an ad set scores poorly?+
Inside NewsBreak, not ValidVisit. ValidVisit only reports the 0-100 score against __ADSET_ID__; pausing or retargeting that ad set happens in your NewsBreak Ads account directly.
Score every NewsBreak Ads click — and find the fake ones.
See which NewsBreak Ads 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