TwinRed tracking tokens & macros
TwinRed's macro set leans on SSP terminology — SSP ID, Source Site — that gives away what kind of network this actually is: a programmatic, RTB-style operation buying multi-format inventory (banner, pop, push) across a stack of supply-side platforms, not a single self-serve publisher network with fixed inventory of its own. That structure means a single TwinRed campaign can be sourced from dozens of underlying supply partners at once. Appending TwinRed's tokens lets ValidVisit attribute each visit down to the transaction, the SSP, and the source site, and score it 0-100 for traffic quality.
Cross-check any macro against the network’s official documentation. TwinRed official docs →
{transactionId} is the required token and functions as TwinRed's click ID — every visit needs it to be individually addressable. {campaignId} and {campaignName} tie that transaction back to the campaign it belongs to. The two tokens that matter most for cleanup are {sspId}, which identifies which supply-side platform actually sourced and served the impression, and {sourceSite}, the specific placement or site within that SSP's inventory. Because TwinRed is buying across multiple SSPs rather than running one homogenous ad exchange, {sspId} functions as something close to a publisher-network-level dimension, while {sourceSite} narrows it further to the individual placement. {adId} rounds it out at the creative level. All six are populated by TwinRed automatically once they're appended as query parameters on your landing page URL — there's no separate integration step required beyond adding them to your campaign's destination URL.
Because the underlying supply can shift from one SSP to another even within the same campaign, {sspId} and {sourceSite} are what let you tell a legitimate publisher relationship from a supply partner quietly pushing pop-under or push-notification traffic that's technically 'in campaign' but not worth paying for. ValidVisit only ever detects, scores, and reports on what arrives — it has no connection into TwinRed's bidding or delivery pipeline and can't cut off a source itself. Acting on a bad score means going back into your TwinRed dashboard and excluding the specific source site or SSP from the campaign's supply, or narrowing the campaign to the formats and SSPs that have been scoring clean.
TwinRed macro → ValidVisit param
| Token | TwinRed macro | ValidVisit param | Example |
|---|---|---|---|
| Transaction ID *click | {transactionId} | vv_click_id | abc123xyz |
| Campaign IDcampaign | {campaignId} | vv_campaign_id | 123456 |
| Campaign Namecampaign | {campaignName} | vv_campaign_name | 123456 |
| SSP IDpublisher | {sspId} | vv_publisher_id | pub_42 |
| Source Siteplacement | {sourceSite} | vv_placement_id | plc_7 |
| Ad IDad | {adId} | vv_ad_id | 456789 |
- TwinRed macro
{transactionId}- ValidVisit param
vv_click_id- Example
- abc123xyz
- TwinRed macro
{campaignId}- ValidVisit param
vv_campaign_id- Example
- 123456
- TwinRed macro
{campaignName}- ValidVisit param
vv_campaign_name- Example
- 123456
- TwinRed macro
{sspId}- ValidVisit param
vv_publisher_id- Example
- pub_42
- TwinRed macro
{sourceSite}- ValidVisit param
vv_placement_id- Example
- plc_7
- TwinRed macro
{adId}- ValidVisit param
vv_ad_id- Example
- 456789
* required for TwinRed attribution.
Ready-to-use TwinRed tracking URL
https://yoursite.com/landing?utm_source=twinred&utm_medium=banner&vv_click_id={transactionId}&vv_campaign_id={campaignId}&vv_campaign_name={campaignName}&vv_publisher_id={sspId}&vv_placement_id={sourceSite}&vv_ad_id={adId}Append these params to your landing-page URL — TwinRed fills the macros at click time, so every visit arrives attributed and ready to score. No funnel hop.
The buyer opens Site Targeting, reviews the list of all eligible sites/traffic sources (TwinRed is transparent, all sources visible), and toggles each bad site to Block (or blocks all and allows only a whitelist) at campaign, placement, or account level.
TwinRed tracking token FAQs
What does {sspId} identify?+
The specific supply-side platform that sourced and served the impression. Since TwinRed buys programmatically across multiple SSPs rather than running one fixed publisher network, {sspId} is the closest thing to a publisher-level dimension for this network.
Which token functions as the click ID on TwinRed?+
{transactionId}. It's required and gives ValidVisit a unique identifier for every visit, the same role a dedicated click-id macro plays on other networks.
Can I exclude a bad source without pausing the whole campaign?+
Yes, but it happens manually. ValidVisit flags which {sourceSite} or {sspId} is producing poor-quality traffic; you take that information into your TwinRed dashboard and exclude the specific source or SSP from the campaign's supply yourself.
Score every TwinRed click — and find the fake ones.
See which TwinRed 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