Merge pull request #698 from plausible/compare-and-props

fixes

Author: metmarkosaric

docs/compare-stats.md

@@ -4,40 +4,48 @@ title: Compare your stats over time
 
 import useBaseUrl from '@docusaurus/useBaseUrl';
 
-You can compare your website stats over time to get valuable insights and spot trends more easily. The comparison feature lets you analyze one date range alongside another.
+You can compare your website stats over time to spot trends and measure progress. The comparison feature lets you analyze one date range alongside another.
 
-You can choose between “**Previous period**”, “**Year over year**” and “**Custom period**”. By default, we match days of the week (for example, Monday to Monday) to avoid differences caused by weekends, but you can switch to matching exact dates instead.
+Once enabled, the comparison drop-down gives you these options:
 
-You can also change the chart interval to view the comparison the way you prefer, [segment your audience](filters-segments.md) to focus on specific traffic, and compare against [imported Google Analytics stats](google-analytics-import.md) if available.
+- **Previous period** — compares against the period immediately before your selected date range
+- **Year over year** — compares against the same period in the previous calendar year
+- **Custom period** — compare against any date range you choose
+- **Match day of week** — aligns the comparison by day of the week to avoid weekend/weekday skew
+- **Match exact date** — aligns by calendar date instead
 
-## How to compare two different date ranges
+You can also change the chart interval, [segment your audience](filters-segments.md) to focus on specific traffic, and compare against [imported Google Analytics stats](google-analytics-import.md) if available.
 
-Here's how to track your progress and identify trends by comparing your stats:
+## How to compare two different date ranges
 
 - Select your primary date range using the date picker in the top right of your dashboard or by using one of our [keyboard shortcuts](keyboard-shortcuts.md).
 
-- Then select "**Compare**" in the date picker or press the "**X**" key [on your keyboard](keyboard-shortcuts.md) to enable the comparison feature.
+- Then select “**Compare**” in the date picker or press the “**X**” key [on your keyboard](keyboard-shortcuts.md) to enable the comparison feature.
 
-- This will enable a new comparison drop-down. "**Previous period**" is our default option but you can also compare trends "**Year over year**" or a completely "**Custom period**" too.
+- Choose your comparison option from the drop-down.
 
-<div class="browser">
-    <video autoPlay loop muted controls width="100%">
-        <source src={useBaseUrl('/video/compare-stats-over-time.mp4')} type="video/mp4" />
+<div class=”browser”>
+    <video autoPlay loop muted controls width=”100%”>
+        <source src={useBaseUrl('/video/compare-stats-over-time.mp4')} type=”video/mp4” />
     </video>
 </div>
 
-- The comparison uses "**Match day of the week**" by default to align the comparison by day of the week. You can select "**Match exact date**" in the comparison drop-down to match by date instead
+The comparison appears in three places across your dashboard:
 
-- The comparison will be shown on the top chart of your Plausible dashboard. You can see the stats for both the primary and the secondary date ranges in the chart. You can hover over to see the percent changes in the tooltip. As with everything else on the dashboard, we'll save your comparison preference for your next visit to save you a click or two
+- **Metric cards** at the top show percentage changes (with up/down arrows) against the comparison period
+- **The main chart** shows both date ranges as separate lines so you can see trends side by side. Hover over any point to see the values and percent change in the tooltip
+- **Breakdown tables** (Sources, Pages, Countries, etc.) show comparison data in a tooltip when you hover over a row
 
-<div class="browser">
-    <img alt="Comparison chart" src={useBaseUrl('img/v2/comparison-chart.webp')} />
+As with everything else on the dashboard, we'll save your comparison preference for your next visit.
+
+<div class=”browser”>
+    <img alt=”Comparison chart” src={useBaseUrl('img/v2/comparison-chart.webp')} />
 </div>
 
-- Want to disable the comparison and get back to the regular view? Press the "**X**" key on your keyboard or choose "**Disable comparison**" in the comparison drop-down
+- Want to disable the comparison and get back to the regular view? Press the “**X**” key on your keyboard or choose “**Disable comparison**” in the comparison drop-down
 
-<div class="browser">
-    <img alt="Disable comparison" src={useBaseUrl('img/v2/disable-comparison.webp')} />
+<div class=”browser”>
+    <img alt=”Disable comparison” src={useBaseUrl('img/v2/disable-comparison.webp')} />
 </div>
 
 ### Segment your audience
@@ -46,11 +54,11 @@ First, filter the dashboard in any way you want to [segment your audience](filte
 
 ### Choose a chart interval
 
-In the options menu (the **⋮** icon in the top right of the chart), you can choose the unit of time the stats on the chart are grouped by under "**Graph interval**". This gives you a more granular comparison view. The available interval options depend on the date range you've selected. For example, if you select "Last 30 days" as your primary date range, you can display the stats by day or by week.
+In the options menu (the **⋮** icon in the top right of the chart), you can choose the unit of time the stats on the chart are grouped by under "**Graph interval**". This gives you a more granular comparison view. The available interval options depend on the date range you've selected. For example, if you select "Last 28 days" as your primary date range, you can display the stats by day or by week.
 
 ## Match day of the week or match exact date
 
-Our comparison matches by day of the week by default. This means that your primary date range will be compared to the secondary date range starting with the same day of the week. This helps you eliminate discrepancies due to the weekend or weekday differences.
+The comparison can be aligned by day of the week or by exact calendar date. Matching by day of the week means your primary date range is compared to the secondary date range starting with the same day of the week. This helps you eliminate discrepancies due to weekend or weekday differences.
 
 The alternative option in the comparison drop-down is to "**Match exact date**". When choosing Sunday January 1st to January 7th 2023 as the primary date range and matching by exact date, the year over year comparison will be against Saturday January 1st to January 7th 2022.
 
@@ -66,7 +74,7 @@ Here are the details on the available comparison options:
 
 ### Previous period
 
-This is the default comparison mode. Your primary date range will be compared to the same amount of time in the period before it. If you select "**Last 7 days**" as your primary date range, the stats are compared to the previous seven days before it.
+Your primary date range will be compared to the same amount of time in the period before it. If you select "**Last 7 days**" as your primary date range, the stats are compared to the previous seven days before it.
 
 ### Year over year
 

docs/custom-event-goals.md

@@ -169,7 +169,7 @@ Select `Custom event` as the goal trigger and enter the name of the custom event
 
 ### Narrow goals with custom properties
 
-When creating a custom event goal, you can optionally narrow it down using custom properties. This lets you turn a broad goal into a more specific one by matching only events with certain property values, letting you track something like “Purchase (Business – yearly)” as its own goal rather than grouping all purchases together.
+When creating a custom event goal, you can optionally narrow it down using custom properties. This lets you turn a broad goal into a more specific one by matching only events with certain property values, letting you track something like “Purchase (Business – yearly)” as its own goal rather than grouping all purchases together. [Learn how to set up property-filtered goals](/custom-props/for-custom-events#create-property-filtered-goals).
 
 <img alt="Add your custom event goal" src={useBaseUrl('img/custom-events-in-plausible-setup-modal.png')} />
 
@@ -203,7 +203,7 @@ You can also send dynamic monetary values alongside custom events to track reven
 
 ### Attach custom properties
 
-Custom properties can be attached to events to capture dynamic elements and to further break down goal conversions. You can use custom properties to create your custom metrics to collect and analyze data that Plausible doesn't automatically track. [Learn more here](/custom-props/for-custom-events).
+You can attach custom properties to events to collect additional context alongside goal conversions. [See how to set up custom properties](/custom-props/for-custom-events).
 
 #### Automatically attached properties
 

docs/funnel-analysis.md

@@ -34,7 +34,7 @@ Funnels also work across your main domain and its subdomains ([see more](subdoma
 
 * Give your funnel a name in the "**Funnel name**" field.
 
-* Define your funnel by adding the steps you expect a visitor to take before a conversion, a purchase or a sign up. These steps consist of [pageviews goals](pageview-goals.md) and [custom events](custom-event-goals.md). You need to add a minimum of 2 steps and a maximum of 8 steps to create a funnel.
+* Define your funnel by adding the steps you expect a visitor to take before a conversion, a purchase or a sign up. These steps consist of [pageview goals](pageview-goals.md) and [custom event goals](custom-event-goals.md). You need to add a minimum of 2 steps and a maximum of 8 steps to create a funnel. If you want a step to match only a specific variation of a custom event, use a [property-filtered goal](/custom-props/for-custom-events#create-property-filtered-goals).
 
 * By default, the "**Allow other activity in between funnel steps**" option is enabled, which creates a sequential funnel. Disable it to use strict order mode instead.
 
@@ -56,6 +56,6 @@ Funnels appear at the bottom of your dashboard as soon as the first visit is tra
 
 - Track [ecommerce revenue](ecommerce-revenue-tracking.md) alongside your funnels to see which paths generate the most sales
 - Use [filters and segments](filters-segments.md) to compare funnel performance across different traffic sources or campaigns
-- Add [custom properties](custom-props/introduction.md) to your events for deeper breakdowns within each funnel step
+- Use [property-filtered goals](/custom-props/for-custom-events#create-property-filtered-goals) as funnel steps to track specific event variations, such as a sign-up for a particular plan
 
 To learn more about conversion funnel optimization, [head to our blog](https://plausible.io/blog/funnels-conversion-optimization).

docs/guided-tour.md

@@ -33,7 +33,7 @@ You can **set a different unit of time the stats on the chart are grouped by** i
     <img alt="Today intervals in top graph" src={useBaseUrl('img/v2/intervals-minutes-hours.webp')} />
 </div>
 
-Or if you select "Last 30 days", you can display the stats by day or by week. You can display the stats by days, weeks or months if you choose a wider timeframe.
+Or if you select "Last 28 days", you can display the stats by day or by week. You can display the stats by days, weeks or months if you choose a wider timeframe.
 
 <div class="browser">
     <img alt="Last 30 days intervals in top graph" src={useBaseUrl('img/v2/intervals-days-weeks-months.webp')} />