πΈ Rybbit - open-source and privacy-friendly alternative to Google Analytics that is 10x more intuitive.
Enhance goals documentation with interactive tabs and steps components, improving clarity on goal creation and types
Bill Yang438b6be9e157
diff --git a/docs/content/docs/goals.mdx b/docs/content/docs/goals.mdxindex 58f6579a6..4687ef25e 100644--- a/docs/content/docs/goals.mdx+++ b/docs/content/docs/goals.mdx@@ -2,12 +2,20 @@title: Goalsdescription: Track conversions by monitoring page visits and custom events---+import { Tab, Tabs } from 'fumadocs-ui/components/tabs';+import { Step, Steps } from 'fumadocs-ui/components/steps';++Goals let you define specific actions β visiting a page or triggering an event β and measure how often your visitors complete them. Each goal tracks a conversion rate against total sessions, giving you a clear picture of how effectively your site drives key outcomes.## Creating a Goal-Click **Create Goal** to open the goal form. Every goal has:++<Steps>+<Step>+### Click "Create Goal"+Every goal has:- **Name** (optional) β A friendly label like "Completed Checkout" or "Signed Up"- **Type** β Either **Page Goal** or **Event Goal**@@ -17,8 +25,14 @@ Click **Create Goal** to open the goal form. Every goal has:You cannot change a goal's type after creation. If you need a different type, create a new goal.</Callout>-### Page Goals+</Step>+<Step>+### Choose a Goal Type++There are two types of goals: **Page Goals** and **Event Goals**.+<Tabs items={['Page Goals', 'Event Goals']}>+<Tab value="Page Goals">Page goals track when a user visits a URL matching a given path pattern.- The value must be a path starting with `/` (not a full URL)@@ -28,13 +42,18 @@ Page goals track when a user visits a URL matching a given path pattern.The form provides autocomplete suggestions based on actual paths seen on your site.-### Event Goals-+</Tab>+<Tab value="Event Goals">Event goals track when a custom event with a specific name is fired. The value is the event name (e.g., `signup_clicked`, `purchase_completed`).Events must be tracked using the Rybbit tracking script. See [Track Events](/docs/track-events) for setup instructions.+</Tab>+</Tabs>+</Step>+<Step>+### Add Property Filters (optional)-### Property Filters+You can narrow a goal to only count conversions when specific properties match:@@ -43,6 +62,8 @@ You can narrow a goal to only count conversions when specific properties match:Toggle **Match specific URL parameters** or **Match specific event properties** to add filters. You can add multiple filters per goal β all filters must match for a session to count as a conversion.+</Step>+</Steps>## Goal MetricsEach goal card displays:@@ -54,6 +75,8 @@ Goals respect the global date range and filters (country, device, browser, etc.)## Viewing Converted Sessions++Click a goal card to expand it and see the sessions that converted. Each session shows:- Entry and exit pagesdiff --git a/docs/public/docs/goals/1.png b/docs/public/docs/goals/1.pngnew file mode 100644index 000000000..18f278a91Binary files /dev/null and b/docs/public/docs/goals/1.png differdiff --git a/docs/public/docs/goals/2.png b/docs/public/docs/goals/2.pngnew file mode 100644index 000000000..56075d1ceBinary files /dev/null and b/docs/public/docs/goals/2.png differdiff --git a/docs/public/docs/goals/3.png b/docs/public/docs/goals/3.pngnew file mode 100644index 000000000..361f51fc7Binary files /dev/null and b/docs/public/docs/goals/3.png differdiff --git a/docs/public/docs/goals/4.png b/docs/public/docs/goals/4.pngnew file mode 100644index 000000000..1fe49e4f1Binary files /dev/null and b/docs/public/docs/goals/4.png differ