NewsBreak Ads tracking tokens & macros
NewsBreak isn't an open publisher network the way Taboola or Outbrain are, it sells its own local-news app plus a handful of platforms (Scoopz, Premium Partner, Newsletters), and it doesn't name the third-party apps and sites behind Premium Partner. That changes what 'publisher' even means here: instead of judging individual outside sites, the unit worth watching is the ad set in NewsBreak Ads Manager that served the click. Append NewsBreak's macros to your destination URL and ValidVisit attributes each visit down to that level, then judges it Valid or Invalid, with its evidence.
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 fills in on every click and it's required for ValidVisit to attribute anything back to this network at all. __FLIGHT_ID__, NewsBreak's ad set id, is the closest thing NewsBreak has to a sub-publisher unit, since it gives you no third-party site or app id to name, the ad set is where you choose placements and where quality can be compared from one grouping of clicks to the next. Round it out with __CAMPAIGN_ID__ and __CAMPAIGN_NAME__ for reporting, plus __CREATIVE_ID__ (NewsBreak's ad ID) if you're running multiple creatives per ad set and want to see which one carries the invalid share. All five resolve automatically once the macros are present in your click-through URL, there's no separate feed or file to configure on NewsBreak's side.
Because NewsBreak sells platforms rather than named publishers, 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 placement choice is sending visits that get judged Invalid. Judging by __FLIGHT_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 verdict and attribution happen automatically, but nothing gets paused or excluded on ValidVisit's end. If an ad set keeps coming back with a high invalid share, adjusting its placements or targeting, or turning it off, is something you do directly in NewsBreak Ads Manager.
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 |
| Flight (ad set) IDadset | __FLIGHT_ID__ | vv_adset_id | 120001 |
| 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
__FLIGHT_ID__- ValidVisit param
vv_adset_id- Example
- 120001
- 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_adset_id=__FLIGHT_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 judge. No funnel hop.
See which NewsBreak Ads sources send bots.
- Every visit judged Valid or Invalid, worst source first.
- Attributed through the NewsBreak Ads tokens above, down to the placement.
- Works beside your tracker, with nothing added to the click path.
What NewsBreak Ads tokens let you break bots down by
Campaign level only: NewsBreak Ads passes no publisher, zone or placement token, so invalid traffic is attributed to the campaign and, where a click id exists, to the click.
Carries a per-click id, stored with each visit so a verdict traces back to the click.
- IP exclusionnot offered
- Device targetingdocumented
- OS targetingdocumented
- Browser targetingnot offered
- Connection typedocumented
- Languagedocumented
Tokens last verified against NewsBreak Ads’s docs on 2026-10-02.
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 keep only its gaming or non-gaming apps), or — managed accounts only — ask their account manager about Brand Suitability Controls, which denylist publishers and content categories for in-article placements and which NewsBreak says are not for performance advertisers on tCPA or Maximize Conversions.
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 on NewsBreak's own app and on the platforms it sells alongside it, without naming individual third-party apps or sites, so the closest equivalent is __FLIGHT_ID__, the ad set that served the click, which is what ValidVisit judges 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__, __FLIGHT_ID__, and __CREATIVE_ID__ add detail on top of that base attribution.
How do I act if an ad set keeps coming back invalid?+
Inside NewsBreak, not ValidVisit. ValidVisit judges visits against __FLIGHT_ID__ and never edits your campaign; pausing or retargeting that ad set happens in your NewsBreak Ads account directly.
Tracking tokens for other native networks
Judge every NewsBreak Ads visit — and find the fake ones.
See which NewsBreak Ads 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