Docs
What is collected
This is the short version for someone installing the tracker. The privacy policy is the full and binding one.
In the visitor’s browser
| Name | What it is | How long |
|---|---|---|
peregrine_vid | A random visitor id, in a cookie and local storage. It is how a purchase weeks later is credited to the first visit, and the cookie copy is what lets your server attach it to a checkout. | Cookie: 2 years |
peregrine_sid | A random session id, to group one visit’s pageviews. | Until the browser closes |
Both are first-party: they belong to your domain, and no other site can read them. Neither contains anything about the person. Whether your site needs a cookie notice for them depends on where you and your visitors are.
Sent with each event
- the visitor id and session id;
- the event name and the page path, without the query string;
- the referring site’s host name, such as
reddit.com, not the full URL; utm_source,utm_mediumandutm_campaign, if the address had them;- the window width, used only to tell phones from desktops;
- for goals, the details your site attaches, up to 1 KB.
From the request itself, Peregrine keeps a country, region and city, which the hosting edge works out from the IP address, and a device type and browser name from the user agent.
Never stored
- IP addresses, anywhere, including the rate limiter.
- The full user agent, the window width, or the full referring URL.
- Ad click ids such as
gclidandfbclid. The tracker sends them; the server drops them. - Buyer details. From your payment provider Peregrine keeps the order id, amount, currency, time, the visitor id the checkout carried, and whether it was a test order. No name, email or billing address.
Your part
Goal details are free-form, so keep personal data out of them: no emails, names or user ids in window.peregrine() or data-goal-* attributes.
More docs
- Install the tracker
- Revenue attribution
- Goals and custom events
- Sale notifications on Telegram
- How channels are decided
- Bots and filtering
- 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.