Tag your ads so Veya knows where visitors came from
The UTM and ad-id parameters to paste into Meta, Google, TikTok, Pinterest, Snapchat, Microsoft and Klaviyo, so popup versions and results split by channel and ad.
Veya can show a different version of a popup to visitors from each channel, campaign or ad, and give each version its own funnel: views, signups, attributed orders and revenue. It can only do that for visits it can tell apart, so tag every ad link once, at the source.
Why tag your ads
An ad click lands on your store with a click id such as fbclid or gclid. That says which platform sent the visitor, but not which campaign or ad, and Apple's Link Tracking Protection removes click ids from links opened in Mail, Messages and Safari Private Browsing. UTM tags and your own parameters stay.
The strings below add two things to every ad link:
- UTM tags (
utm_source,utm_medium,utm_campaign,utm_content), the industry standard that GA4, Shopify and Klaviyo read too. - Veya's own parameters (
vy_ad,vy_adset,vy_campaign,vy_placement,vy_platform), filled by each platform's macros with the ad's own ids, so a rule can pick out one ad even after a campaign is renamed.
Keep values lowercase and spell each source the same way every time: facebook and Facebook are two sources to most reports.
The strings to paste
Copy the string for each platform you advertise on and paste it where it says. The {{...}}, {...} and __...__ parts are macros: the platform fills them in when someone clicks, so leave them exactly as written.
Meta (Facebook and Instagram)
Where: Ads Manager → the ad → Destination → Build a URL parameter, or the URL parameters field under Tracking (set it on every ad; it is not inherited from the campaign).
utm_source={{site_source_name}}&utm_medium=paid_social&utm_campaign={{campaign.name}}&utm_content={{ad.name}}&vy_ad={{ad.id}}&vy_adset={{adset.id}}&vy_campaign={{campaign.id}}&vy_placement={{placement}}
- {{site_source_name}} becomes fb, ig, msg or an, so Veya can show Instagram and Facebook visitors different versions.
- Name macros carry the name the ad was published with: rename a campaign and links keep the old name. The ad id never changes, so per-ad rules use the ad id.
Google Ads
Where: Google Ads → Admin → Account settings → Tracking template → Final URL suffix (keep auto-tagging on).
utm_source=google&utm_medium=cpc&utm_campaign={campaignid}&utm_content={creative}&utm_term={keyword}&vy_platform=google&vy_ad={creative}&vy_adset={adgroupid}&vy_campaign={campaignid}
- Auto-tagging (gclid) stays on for Google Ads conversions; the suffix adds what other tools and Veya read.
- ValueTrack has no campaign-name macro; Veya rules can match the campaign id.
- {keyword} is blank for Performance Max, AI Max and Dynamic Search Ads.
TikTok
Where: TikTok Ads Manager → the ad → Ad details → Destination → Website URL → Build URL parameters.
utm_source=tiktok&utm_medium=paid_social&utm_campaign=__CAMPAIGN_NAME__&utm_content=__CID_NAME__&vy_platform=tiktok&vy_ad=__CID__&vy_adset=__AID__&vy_campaign=__CAMPAIGN_ID__&vy_placement=__PLACEMENT__
- CID is the creative id; the ad-id macro (ADID_V2) works only in upgraded Smart+ campaigns.
- Macros are upper case with two underscores on each side; check them with Preview before you publish.
Where: Pinterest Ads Manager → the ad → Destination URL (add the parameters after a ?).
utm_source=pinterest&utm_medium=paid_social&utm_campaign={campaign_name}&utm_content={adid}&vy_platform=pinterest&vy_ad={adid}&vy_adset={adgroupid}&vy_campaign={campaignid}
- Pinterest fills the macros only on live ads, not in ad previews.
Snapchat
Where: Snapchat Ads Manager → the ad → Website URL → URL parameters (the URL macros builder, set per ad).
utm_source=snapchat&utm_medium=paid_social&utm_campaign={{campaign.name}}&utm_content={{creative.name}}&vy_platform=snap&vy_ad={{ad.id}}&vy_adset={{adSet.id}}&vy_campaign={{campaign.id}}
- Macros are case-sensitive: {{adSet.name}} with a capital S.
- Snapchat's Auto-UTMs fill only the UTM tags you leave out; yours are kept.
Microsoft Advertising (Bing)
Where: Microsoft Advertising → Campaigns → Settings → Account level options → Final URL suffix (keep auto-tagging of the Microsoft Click ID on).
utm_source=bing&utm_medium=cpc&utm_campaign={CampaignId}&utm_content={AdId}&utm_term={keyword}&vy_platform=microsoft&vy_ad={AdId}&vy_adset={AdGroupId}&vy_campaign={CampaignId}
- A suffix set on a campaign, ad group or ad replaces the account one; the two are not combined.
Email and SMS (Klaviyo and others)
Where: Klaviyo → Settings → Other → UTM tracking → Automatically add UTM parameters to links, with utm_medium set to Message type; other tools have the same setting.
utm_source=klaviyo&utm_medium=email&utm_campaign={campaign or flow name}
- With utm_medium set to Message type, Klaviyo writes email in emails and sms in texts (its default since June 2, 2025).
- utm_medium=email or sms is enough for the channel; returning subscribers can see their own version.
Creators, podcasts and anything else
Where: Give each partner its own link.
utm_source=<partner>&utm_medium=referral&vy_partner=<partner>
- Any parameter of your own also works in rules: Landing URL parameter, e.g. ?promo=reel-cup.
How Veya reads the tags
Veya reads the landing URL once, on a visitor's first page, and keeps what it found for the whole visit.
| Condition | Comes from |
|---|---|
| Traffic channel | utm_source (Meta's fb, ig, msg and an included), or a utm_medium of email or sms; without tags, the Instagram or Facebook in-app browser, the click id, then the referring site |
| Ad ID | vy_ad, the ad-id parameters attribution tools already use, or a numeric utm_content |
| Ad set, Ad campaign, Ad placement | vy_adset, vy_campaign, vy_placement |
| Ad platform | vy_platform, or the platform whose click id is on the link |
| Affiliate or media partner | vy_partner |
| UTM source, UTM medium, UTM campaign, UTM content | the utm_ tags as they are |
The traffic channel tells Facebook from Instagram, which the ad platform alone can't: both are Meta. A macro the platform didn't fill, such as a literal {{ad.id}}, is ignored. Veya only notes which click id was present, never its value.
Use them as a version's Who sees this conditions on the Copy variants tab, for example Traffic channel is Instagram, or Ad ID is 120210000000001. The Audience tab's rules offer the same fields, so a whole form can also be limited to one channel or ad.
Check your tags work
- In the ad platform, preview the ad and click through. The landing URL should carry your tags with real values in place of the macros (Pinterest fills them only on live ads).
- On the form's Copy variants tab, use See what a visitor sees: pick a channel under Arriving from and click Open on my store. It opens a private store preview as if you came from there, so you can see which version shows. Only you see it.
- After a few days of traffic, the Tag your ads card on the Copy variants tab shows, per channel, how much of the last 30 days' traffic arrived tagged. A channel with little tagged traffic has ads still missing the string.
Your own parameters
Any parameter on the link a visitor landed with works in rules, not only the ones above. Under Who sees this, add a Landing URL parameter condition with the parameter's name, then the value. For example, a creator's link ?promo=reel-cup can show that creator's version with the condition promo is reel-cup.
For strategy, naming and what the industry recommends, read the UTM parameters for ads guide. For every other audience rule, see Choose who sees a form.
Your next popup?
We’ll build it for you.
14-day free trial on every plan. Custom design and revisions included.