There are a few ways we determine where a visitor comes from. We automatically detect the previous page (referrer) from the visitor’s browser, but you can also add a URL parameter to override this and set a custom referrer.
Using a URL parameter
If the current URL on your site includes a parameter named
utm_source, we use this value instead of the browser’s previous page.
For example, if you were to include this link in an email newsletter, Simple Analytics records the referrer as
Certain character are not allowed in the URL parameter. Letters and numbers are always okay, but if you want to use special characters (like spaces,
,) you need to escape your URL parameter. A good website that does this for you is urlencoder.io.
Valid examples of URL parameters:
https://example.com/?ref=email-button https://example.com/?ref=docs.simpleanalytics.com https://example.com/?ref=android%3A%2F%2Fcom.example.app%2Fpath https://example.com/?ref=exister%2C%20avoir%20une%20r%C3%A9alit%C3%A9
Using the referrer URL
The referrer URL is only used if there are none of the URL parameters mentioned above
If there is no referral parameter found, we save the URL of the referring page from the visitor’s browser. We only save the part of the referrer before
#, so if the referrer URL is
https://referrer.example.com/search?query=sensitive+information, we only store
referrer.example.com/search. Note that the protocol (
https://) is also removed. We also ignore common subdomains like
You don’t have to do anything to make this work.
Parsing of values
We parse the URL parameter differently than the referrer URL. Because you generate the URL parameters yourself, we don’t want to touch these too much. Instead, we decode their values (so you can use forbidden characters) and convert hostnames to more general names. For example, we convert
google.fr, into simply
Referrer URLs contain the full URL that the browser gives us, such as
https://www.example.com/search?query=sensitive+information. From this URL we store
example.com as the referrer and keep
example.com/search as the original URL. We drop the query (
?query=sensitive+information), protocol (
https://), and common subdomain (