Custom goal events

Screen views tell you a user saw something. Goal events tell you they did something. Use them to track actions like profile completion, first purchase, feature adoption, or any other milestone you care about.

Goal events are tracked using the `Grometrics.track()` method. One line of code per event. No configuration needed in the dashboard before firing — events are created automatically when the first one arrives.

Prerequisites

Grometrics SDK installed and verified. Works on web and mobile.

Web: script installation. Mobile: iOS, Android, React Native, and Flutter.

Step 1: Fire events from your code

Call `Grometrics.track()` wherever the action completes. Not when the screen loads — when the action finishes.

1// after profile form submission succeeds2Grometrics.track('profile_completed');34// with optional properties5Grometrics.track('profile_completed', {6  had_avatar: true,7  fields_filled: 4,8});

Step 2: Create goals in the dashboard

Go to Conversions > Goals > Create Goal. Type the event name exactly as it appears in your code. Names are case-sensitive. Grometrics starts counting completions and calculating the conversion rate automatically.

You can also let events auto-create. Any event name fired via `track()` that doesn't have a matching goal will appear in your events list, and you can promote it to a goal from there.

Event naming rules

Common event examples

1Grometrics.track('account_created');2Grometrics.track('profile_completed');3Grometrics.track('first_project_created');4Grometrics.track('first_message_sent');5Grometrics.track('onboarding_completed');

1Grometrics.track('invite_sent');2Grometrics.track('file_uploaded');3Grometrics.track('comment_posted');4Grometrics.track('share_clicked');56Grometrics.track('pricing_page_viewed');7Grometrics.track('trial_started');8Grometrics.track('upgrade_clicked');9Grometrics.track('checkout_initiated');

1Grometrics.track('paywall_viewed');2Grometrics.track('paywall_dismissed');3Grometrics.track('trial_started');

What you'll see in the dashboard

Click a goal card to see the detail view: completion trend chart, breakdown by source, breakdown by page or screen, and a list of recent visitors who completed the goal.

Using goals in funnels

Goals can be used as funnel steps. Go to Conversions > Funnels > Create Funnel and select Goal as the step type. You can mix goals with screen views and RevenueCat transaction events in the same funnel.

This shows the sequential drop-off between activation milestones. See the activation metrics guide for how to interpret the results and set targets.

Setting a primary KPI

You can pin one goal as your primary KPI in Settings > General > Primary KPI. This highlights it on the dashboard with a colour of your choice, so the number you care most about is always visible.

Requirements

The visitor must have at least one pageview or screen view before goal events are accepted. If `track()` is called before any pageview or screen view has been recorded, the event may be rejected.

This is automatic in normal usage. The SDK records a pageview or screen view on init, which happens before any user action could trigger a goal event.