When you want to know where visitors are coming from you can add certain parameters to your URL. Browsers send the previous page (referrer) to the next page so you can see where a visitor did come from. There are a few ways how we determine where a visitor comes from.
Using an URL parameter
First we check the referrer for the parameters
utm_source. So if you link your website in your email it’s wise to add something like this:
This way Simple Analytics knows where the visitor did come from (email) and will save this information and show it in the dashboard (as a referrer).
Certain character are not allowed in the URL parameters. Letter and numbers are always okay. 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
The referrer URL is only used the there are no URL parameters found
Using the referrer URL
If there is no parameter found we save the URL of the referrer. We only save the part before any
#. So for example if the referrer URL is
https://app.referrer.com/search?query=sensitive+information we only store
app.referrer.com/search. Note that the protocol (
https://) is gone. We also delete common subdomains like
www2. from the URL.
You don’t have to do anything to make this work.
Parsing of values
We parse the URL parameters differently then the referrer URL. Because people generate the URL parameters themselves we don’t want to touch those too much. What we do is we decode their values (so you can use forbidden characters) and convert hostnames to more general names. For example we convert
Referrer URLs contain the full URL that the browser gives us. It’s something like
https://www.referrer.com/search?query=sensitive+information. From this URL we store only
referrer.com as the referrer and we keep
referrer.com/search as the original referrer. We drop the query, protocol, and common subdomain.