Docs
How channels are decided
Every visitor gets one channel: where they came from the first time Peregrine saw them. Their later visits, goals and purchases are all credited to it.
The rule
On a visitor’s first visit, the channel is the first of these that exists:
- the
utm_sourcein the page address, such asnewsletter; - the site they came from, such as
reddit.com; - otherwise Direct: a typed address, a bookmark, or an app that does not pass a referrer.
www. is removed, and common redirect and app addresses are merged into one name: t.co is x.com, old.reddit.com is reddit.com, and links opened from Gmail or Outlook are email. A link from one of your own pages or subdomains is navigation, not a source.
First channel, kept for good
Once a visitor has a channel, it never changes. Someone who found you on Reddit, came back through Google two weeks later and then bought is a Reddit buyer. That is first-touch attribution, and it is the point of the product: it shows what finds your customers, where most tools show what they clicked last. First-touch vs last-touch, explained.
A visitor is recognised by an id in a cookie and local storage on their browser. Someone who switches device or clears their browser data is a new visitor, with a new first channel.
Tagging your own links
Links from email, ads, social bios and QR codes often arrive with no referrer and would count as Direct. Add utm_source so they show up by name:
https://your-domain.com/?utm_source=newsletter&utm_medium=email&utm_campaign=octoberutm_sourcenames the channel, and is the one that matters most.utm_mediumandutm_campaignare saved too. The campaign appears alongside the channel, for example in sale notifications.- Keep the spelling consistent:
Newsletterandnewsletterare two channels. The UTM builder lowercases the values for you.
Filtering by channel
Click a channel on the dashboard and every panel narrows to the visitors who first came from it: their pages, their countries, their goals and their revenue. Click a page and the same happens for the visitors who viewed it.
More docs
- Install the tracker
- Revenue attribution
- Goals and custom events
- Sale notifications on Telegram
- Bots and filtering
- What is collected
- Peregrine for Polar
- Peregrine for Lemon Squeezy
- Peregrine for Dodo Payments
Something missing? Write to us from the footer. Or see a real dashboard in the demo, or start a free trial.