Merge pull request #558 from plausible/metmarkosaric-patch-23

docs/countries.md

@@ -1,5 +1,5 @@
 ---
-title: Locations
+title: Top countries, regions and cities
 ---
 
 import useBaseUrl from '@docusaurus/useBaseUrl';
@@ -8,8 +8,10 @@ Your "**Locations**" report shows where in the world your visitors are coming fr
 
 Click on any country to see the list of regions within that country where your visitors are coming from. Click on any region to see the list of cities within that region. You can also use the "**Countries**", "**Regions**" and "**Cities**" tabs on the top of the report.
 
-To improve the accuracy, visitors that use VPN services and the Tor browser are grouped under the "**Anonymous VPN Service**" entry in the "**Countries**" tab. This eliminates noise that VPNs add to locations and makes it easy to view the percentage of visitors using VPNs.
+## Visitors using VPNs and similar services 
 
+To improve the location accuracy, visitors using VPN services or the Tor browser are grouped under the "**Anonymous VPN Service**" entry in the "**Countries**" tab. This method reduces the noise caused by analytics tools recording VPN server locations instead of actual user locations, while also making it easier to view the percentage of visitors using VPNs.
+
 You can use the "**Filter**" button on the top of your dashboard to segment the traffic by multiple countries, regions or cities at the same time. This allows you to group specific geographical regions and display only that traffic.
 
 <img alt="Countries - multiple filters" src={useBaseUrl('img/countries-filtering-multiple-filters.png')} />

docs/custom-locations.md

@@ -9,7 +9,7 @@ This is especially helpful to redact and aggregate multiple pages whose URLs con
 Follow the steps below to learn how you can specify a custom location for your pages and aggregate page URLs that contain identifiers:
 
 ## 1. Add the `manual` script extension
-To specify a custom location for your event, you must use [Plausible's manual script extension](script-extensions.md#plausiblemanualjs). 
+To specify a custom location for your event, you must use [Plausible's manual script extension](script-extensions.md). 
 
 To do so, change your Plausible script snippet `src` attribute from `https://plausible.io/js/script.js` to `https://plausible.io/js/script.manual.js`.
 
@@ -54,7 +54,7 @@ plausible('pageview', { u: "https://yourdomain.com/my-custom-location" + window.
 ```
 
 :::note
-The `+ window.location.search` is needed to persist query parameters from your actual URL. Plausible uses `ref`, `source`, `utm_source`, `utm_medium`, `utm_campaign`, `utm_content` and `utm_term` query parameters for source acquisition. [Learn more here](manual-link-tagging.md).
+The `+ window.location.search` is needed to persist query parameters from your actual URL. Plausible uses `ref`, `source`, `utm_source`, `utm_medium`, `utm_campaign`, `utm_content` and `utm_term` query parameters for source acquisition. [Learn more here](top-referrers.md).
 :::
 
 At this point, your entire setup should look like this:

docs/custom-query-params.md

@@ -2,7 +2,7 @@
 title: Tracking custom query parameters
 ---
 
-Query parameters `ref`, `source`, `utm_source`, `utm_medium`, `utm_campaign`, `utm_content` and `utm_term` are valid and supported by Plausible out of the box. The parameters themselves are stripped from the page paths so they are not shown in the "**Top Pages**" report but they are used for source attribution of  marketing campaigns. You can check all the clicks on links with UTM tags in the "**Campaigns**" tab of the "**Top Sources**" report. Read more about [tagging links with query parameters here](manual-link-tagging.md).
+Query parameters `ref`, `source`, `utm_source`, `utm_medium`, `utm_campaign`, `utm_content` and `utm_term` are valid and supported by Plausible out of the box. The parameters themselves are stripped from the page paths so they are not shown in the "**Top Pages**" report but they are used for source attribution of  marketing campaigns. You can check all the clicks on links with UTM tags in the "**Campaigns**" tab of the "**Top Sources**" report. Read more about [tagging links with query parameters here](top-referrers.md).
 
 Other than the source attribution query parameters listed above, Plausible strips all other query parameters for privacy purposes. This means that pages like `yoursite.com/blog/index.php?article=some_article&page=11` will be reported as `yoursite.com/blog/index.php` in the "**Top Pages**" report of your Plausible dashboard.
 
@@ -83,7 +83,7 @@ At this point, your entire setup should look like this:
 ```
 
 :::note
-The `+ window.location.search` is needed to persist source acquisition query parameters from your actual URL. Plausible uses `ref`, `source`, `utm_source`, `utm_medium`, `utm_campaign`, `utm_content` and `utm_term` query parameters for source acquisition. [Learn more here](manual-link-tagging.md).
+The `+ window.location.search` is needed to persist source acquisition query parameters from your actual URL. Plausible uses `ref`, `source`, `utm_source`, `utm_medium`, `utm_campaign`, `utm_content` and `utm_term` query parameters for source acquisition.
 :::
 
 That's it! You're now tracking the complete URLs of the pages that include custom parameters. 

docs/devices.md

@@ -1,5 +1,5 @@
 ---
-title: Devices
+title: Top devices, browsers and operating systems
 ---
 
 import useBaseUrl from '@docusaurus/useBaseUrl';

docs/guided-tour.md

@@ -68,12 +68,14 @@ You can sort any report by such performance metrics by clicking on any metric he
 
 ## Top Sources
 
-See all the top referral sources of traffic ranked by the number of unique visitors. You can click on the "**Details**" button to see the full list which also includes additional metrics such as the bounce rate and visit duration of the individual referral. [Read more here](top-referrers.md).
+See all the acquisition channels and sources of traffic ranked by the number of unique visitors. You can click on the "**Details**" button to see the full list which also includes additional metrics such as the bounce rate and visit duration of the individual referral.
 
-You can click into the "**Campaign**" tabs of the Top Sources report to see your campaigns isolated from other traffic sources. These are visitors coming from UTM tagged links such as those in your emails, social media or in your paid advertising campaigns. Click on "**Medium**", "**Source**", "**Campaign**", "**Term**" and "**Content**" to explore these. You can learn more about [link tagging here](manual-link-tagging.md).
+You can use the "**Campaigns**" dropdown section in the Top Sources report to view your campaigns separately from other traffic sources. These are visitors coming from UTM tagged links such as those in your emails, social media or in your paid advertising campaigns. Click on "**Medium**", "**Source**", "**Campaign**", "**Term**" and "**Content**" to explore these. 
 
 Note that the referral sources including UTM and other query parameters are counted only when they start a new session on your site.
 
+[Read more here](top-referrers.md).
+
 ## Top Pages
 
 See all the most visited pages on your site ranked by the number of unique visitors. You can click on the "**details**" button to see the full list with additional metrics. The number of pageviews, bounce rate, and time on page for the individual pages are included too.

docs/manual-link-tagging.md

@@ -4,68 +4,4 @@ title: Paid campaigns, UTM tags and conversion attribution
 
 import useBaseUrl from '@docusaurus/useBaseUrl';
 
-Whenever you post a link in social media, paid advertising or send it in an email newsletter, you can choose to add a special query parameter to the link. When for instance `?ref=<value>` query parameter is present, Plausible Analytics will show it as the referral source.
-
-Tagging your links helps you minimize the amount of traffic that falls within the "**Direct / None**" category. It also helps you better track your marketing campaigns and see which campaigns are responsible for most conversions. 
-
-`ref`, `source`, `utm_source`, `utm_medium`, `utm_campaign`, `utm_content` and `utm_term` query parameters are all valid and supported.
-
-:::tip Referral sources are counted only when they start a new session
-This is why you don't see all the referral sources of your own visits if you for instance click to test several different UTM tagged links at the same time. You would need to start a new session by using a different browser, a different IP address or a different device for the new source to be included in the report
-:::
-
-## How to UTM tag links in your marketing campaigns
-
-Here's an example of what you can do when you want to send a newsletter to your subscribers. 
-
-If you simply link to your site with `yourdomain.com`, anyone who clicks on it would fall within the "**Direct / None**" referral source. 
-
-But if you link to `yourdomain.com?ref=Newsletter` anyone who clicks on that will show "**Newsletter**" as the referrer source. This will allow you to see how many people have clicked on your link in the newsletter.
-
-Here are examples of links with the different query parameters that are supported by Plausible Analytics:
-
-* `yourdomain.com?ref=Newsletter`
-* `yourdomain.com?source=Newsletter`
-* `yourdomain.com?utm_source=Newsletter`
-
-For any clicks on any of the above links, "**Newsletter**" would be listed as a referral source in your Plausible Analytics dashboard. 
-
-You can also go a bit deeper and track your links in more detail using UTM tags:
-
-* `yourdomain.com?utm_source=Newsletter&utm_medium=Email&utm_campaign=NovemberNewsletter&utm_content=Link`
-
-For any clicks on the above link, "**Newsletter**" would be listed as a referral source in your Plausible Analytics dashboard, "**Email**" would be listed as the medium, "**NovemberNewsletter**" would be listed as the campaign and "**Link**" would be listed as the content. 
-
-Read more about "[how to use UTM parameters to track your campaigns and understand the dark traffic](https://plausible.io/blog/utm-tracking-tags)".
-
-:::tip Prefer to completely stop tracking UTM tags and other query parameters on your site? 
-Please [follow these instructions](stop-tracking-utm-tags.md)
-:::
-
-## Segment between organic traffic and paid marketing campaigns
-
-Note that UTM tags are case sensitive. In the "**Top Sources**" report of your Plausible dashboard, each source is consolidated into a single entry regardless of capitalization stemming from UTM tagging differences.
-
-For instance, clicks that you get from Facebook which are not tagged by UTMs are labeled with a referral source "**Facebook**" by Facebook itself. If you tag some links that you share on Facebook with the utm_source=facebook, clicks on those links will be consolidated alongside other Facebook clicks in the "**Facebook**" source in the “**All**” tab of the "**Top Sources**" report. This is in order to make it easier for you to keep track and get a combined overview of all the clicks from Facebook.
-
-Want to see the specific source data? Just click on any entry to see specific source breakdowns or explore the "**Campaigns**" tab of the "**Top Sources**" report. To isolate your UTM tagged clicks from the organic clicks, you can segment the traffic by using the "**UTM Medium**", "**UTM Source**", "**UTM Campaign**", "**UTM Content**" and "**UTM Term**" reports within the "**Campaigns**" tab.
-
-You can also use [the "**Filter**" button on the top of your dashboard](filters-segments.md) to filter the stats by multiple UTM tags at the same time for more powerful segmenting of traffic. It's also possible to filter out traffic from a specific UTM tag.
-
-:::tip Does your site use custom query parameters in URLs?
-A page like `yoursite.com/blog/index.php?article=some_article&page=11` will be reported as `yoursite.com/blog/index.php` in the "**Top Pages**" report of your Plausible dashboard as we strip custom parameters. You can manually enable these custom parameters to be tracked. [See how here](custom-query-params.md).
-:::
-
-## Custom events and conversion attribution 
-
-Goals and custom events allow you to track actions that you want your visitors to take on your site. Actions such as registering for a trial account, purchasing a product or completing a checkout form of an ecommerce store.
-
-<img alt="Conversion rate" src={useBaseUrl('img/conversion-rate.png')} />
-
-By [setting up goals and custom events](goal-conversions.md), you can track the number of conversions, conversion rate, referrer sources and entry pages that are driving conversions and the top pages that people convert on. You can also track [ecommerce revenue](ecommerce-revenue-tracking.md). And you can [set up funnels](funnel-analysis.md) to track the user journey too.
-
-<img alt="Custom goal conversion rate" src={useBaseUrl('img/custom-goal-conversion-rate.png')} />
-
-Click on any specific referral source in your dashboard to see the number of conversions and the conversion rate (CR) of that referral source for any of your goals. You can also click on any goal in your dashboard to see the number of conversions and the conversion rate of that specific goal coming from any referral source or any landing page. This works even if your site operates [across multiple subdomains](subdomain-hostname-filter.md).
-
-Due to the privacy-first nature of our product and the fact that we don't use cookies and other long term identifiers, the conversion attribution in Plausible is based on last click attribution. The referral source of the visit on which the purchase was made will be credited for that conversion. 
+See more on [how Plausible records your paid campaigns, UTM-tagged links and conversion attribution](https://plausible.io/docs/top-referrers).

docs/metrics-definitions.md

@@ -111,7 +111,7 @@ The total revenue of orders tracked. This is a part of the [revenue attribution
 
 ## UTM parameters
 
-To minimize the amount of traffic that falls within the "Direct / None" category, you can add special query parameters (UTMs) to your links. UTMs help you better understand where your traffic is coming from. Plausible Analytics supports `utm_source`, `utm_medium`, `utm_campaign`, `utm_content` and `utm_term`. Read more about [tagging your links](manual-link-tagging.md).
+To minimize the amount of traffic that falls within the "Direct / None" category, you can add special query parameters (UTMs) to your links. UTMs help you better understand where your traffic is coming from. Plausible Analytics supports `utm_source`, `utm_medium`, `utm_campaign`, `utm_content` and `utm_term`. Read more about [tagging your links](top-referrers.md).
 
 ## Unique Conversions
 

docs/script-extensions.md

@@ -110,7 +110,7 @@ It's especially helpful to redact and aggregate multiple pages whose URLs contai
 
 #### Track custom query parameters for complete page URLs
 
-By default, Plausible strips all query parameters for privacy purposes [except](manual-link-tagging.md) `ref`, `source`, `utm_source`, `utm_medium`, `utm_campaign`, `utm_content` and `utm_term`. 
+By default, Plausible strips all query parameters for privacy purposes [except for](top-referrers.md) `ref`, `source`, `utm_source`, `utm_medium`, `utm_campaign`, `utm_content` and `utm_term`. 
 
 This means that pages like `yoursite.com/blog/index.php?article=some_article&page=11` will be reported as `yoursite.com/blog/index.php` in the "**Top Pages**" report of your Plausible dashboard.
 

docs/stop-tracking-utm-tags.md

@@ -2,11 +2,11 @@
 title: Stop tracking UTM tags and other query parameters
 ---
 
-By default, Plausible strips all query parameters for privacy purposes [except for](manual-link-tagging.md) `ref`, `source`, `utm_source`, `utm_medium`, `utm_campaign`, `utm_content` and `utm_term`. If you prefer to stop tracking these parameters as well, please follow these instructions:
+By default, Plausible strips all query parameters for privacy purposes [except for](top-referrers.md) `ref`, `source`, `utm_source`, `utm_medium`, `utm_campaign`, `utm_content` and `utm_term`. If you prefer to stop tracking these parameters as well, please follow these instructions:
 
 ## 1. Add the `manual` script extension
 
-You should use [our manual script extension](script-extensions.md#plausiblemanualjs). To do so, please change your Plausible script snippet `src` attribute from `https://plausible.io/js/script.js` to `https://plausible.io/js/script.manual.js`.
+You should use [our manual script extension](script-extensions.md). To do so, please change your Plausible script snippet `src` attribute from `https://plausible.io/js/script.js` to `https://plausible.io/js/script.manual.js`.
 
 The new snippet will look like this (make sure to change the `data-domain` attribute to the domain you added to your Plausible account):
 
@@ -53,4 +53,4 @@ At this point, your entire setup should look like this:
 </script>
 ```
 
-That's it! You're now no longer tracking any UTM tags or other parameters. We will use the [referrer header](top-referrers.md#1-automatic-by-the-referer-header) to display the sources of the traffic instead. If the referring site doesn't send any referrer header, the traffic will fall within the "Direct / None" source.
+That's it! You're now no longer tracking any UTM tags or other parameters. We will use the [referrer header](top-referrers.md) to display the sources of the traffic instead. If the referring site doesn't send any referrer header, the traffic will fall within the "**Direct / None**" source.

docs/top-pages.md

@@ -1,5 +1,5 @@
 ---
-title: Top Pages
+title: Top content, landing pages and exit pages
 --- 
 
 import useBaseUrl from '@docusaurus/useBaseUrl';