Campaigns
TypeUI Insights reads standard UTM parameters and ref from the landing URL so you can connect acquisition with engagement, session journeys, conversions, and UI interaction.
No extra campaign script or dashboard registration is required.
Supported parameters
| Parameter | Dashboard view | Use it for |
|---|---|---|
utm_campaign | Campaigns | The shared campaign name, such as summer_launch |
utm_source | Sources | The publisher or platform, such as newsletter or linkedin |
utm_medium | Mediums | The marketing method, such as email, paid_social, or cpc |
utm_content | Content | A creative, placement, or link variation |
utm_term | Terms | A paid-search keyword or another audience label |
ref | Refs | A TypeUI-friendly partner, product, or internal referral code |
Add campaign parameters
Add the parameters to a link that points to the website:
https://example.com/pricing?utm_campaign=summer_launch&utm_source=newsletter&utm_medium=email&utm_content=hero_cta
For a simpler partner or product link, use ref:
https://example.com/pricing?ref=partner_directory
The tracker captures attribution when the session begins. Query strings are not stored with page paths, so /pricing?utm_campaign=summer_launch remains /pricing in page analytics.
Read campaign performance
The Campaigns card includes tabs for campaigns, sources, mediums, content, terms, and refs. Each list is ordered by user sessions and can be read alongside the comparison period.
Use campaign context with the rest of the dashboard:
- Choose the date range and optional comparison.
- Review the campaign breakdown.
- Compare user sessions, pageviews, average active time, and bounce rate.
- Inspect the pages and session journeys reached by the campaign.
- Check custom events to understand conversion activity.
Campaign dimensions are also included in SUMMARY.md and CSV exports.
Use campaign data with AI
Select a useful date range, then copy SUMMARY.md. The generated snapshot includes the leading campaign dimensions alongside the current metrics, filters, pages, referrals, events, and interaction data.
Compare our newsletter and paid-social campaigns using this SUMMARY.md. Explain which source brings more engaged sessions, which landing pages underperform, and which campaign should receive the next UI experiment.
Naming guidelines
- Use lowercase names with underscores or dashes.
- Keep one spelling for the same source and medium.
- Name the campaign after the business initiative, not the individual post.
- Use
utm_contentfor creative or placement variations. - Do not include names, email addresses, account IDs, or other personal data.