peregrine
DocsDemoGet started

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:

  1. the utm_source in the page address, such as newsletter;
  2. the site they came from, such as reddit.com;
  3. 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=october
  • utm_source names the channel, and is the one that matters most.
  • utm_medium and utm_campaign are saved too. The campaign appears alongside the channel, for example in sale notifications.
  • Keep the spelling consistent: Newsletter and newsletter are 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.

peregrine
DemoDocsIntegrationsCompareUTM builderSign in
© 2026
TermsPrivacyDPA

Contact us

Something is broken or wrong

hello@justperegrine.com
Featured onFeatured on DanielLaunchesLaunched on LaunchPanda