Merge pull request #660 from plausible/Hricha-Shandily-patch-14

add prop goals

Author: metmarkosaric

docs/custom-event-goals.md

@@ -167,7 +167,9 @@ Click on the "**+ Add goal**" button to go to the goal creation form.
 
 Select `Custom event` as the goal trigger and enter the name of the custom event you are triggering. The name must match the one you added as a CSS class name on your site for conversions to appear in your analytics dashboard. So in our example where you added a CSS class name `plausible-event-name=Button+Click`, the goal to add to your Plausible account is `Button Click` (plus is replaced by a space).
 
-<img alt="Add your custom event goal" src={useBaseUrl('img/add-custom-event-goal.png')} />
+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. This allows you to track something like “Purchase (Business – yearly)” as its own goal, rather than grouping all purchases together.
+
+<img alt="Add your custom event goal" src={useBaseUrl('img/custom-events-in-plausible-setup-modal.png')} />
 
 Next, click on the "**Add goal**" button and you'll be taken back to the Goals page. When you navigate back to your Plausible dashboard, you should see the number of visitors who triggered the custom event. Custom events are listed at the bottom of your dashboard and will appear as soon as the first conversion has been tracked.
 

docs/pageview-goals.md

@@ -22,6 +22,8 @@ Select `Pageview` as the goal trigger and enter the pathname of the page you wou
 
 Next, you'll see the Display Name which gets self-populated. You can optionally edit it. You can also edit this later at any time. 
 
+When creating a pageview 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. For example, you can create a pageview goal for /dashboard that only counts visits where account_type = trial, letting you measure dashboard engagement specifically from trial users.
+
 Then click the "**Add goal**" button and you’ll be taken back to the goals page. When you navigate back to your Plausible Analytics dashboard, you should see the number of visitors who reached the specified page or group of pages. Goal conversions are listed at the very bottom of the dashboard.
 
 ## How to group your pages

docs/scroll-depth.md

@@ -36,6 +36,8 @@ Click on the "**+ Add goal**" button to go to the goal creation form.
 
 Select `Scroll Depth` as the goal trigger, select the scroll depth percentage threshold (from 1% to 100%) and enter the pathname of the page you would like to track. The pathname must match the page path you can see in your Plausible Analytics dashboard.
 
+When creating a scroll depth 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. For example, you could create a 75% scroll depth goal for blog posts that only counts when author = jane_doe, letting you measure deep engagement specifically with that author’s content.
+
 <img alt="Scroll depth goals" src={useBaseUrl('img/scroll-depth-goal.png')} />
 
 Do you want to analyze the scroll depth for a specific section of your site? You can use an asterisk (`*`) to match patterns in your page path URLs. Asterisks can be placed on either end or in the middle of any page path URL.