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.

Browser installs use window.grometrics.event(); mobile tracker instances use track(). No dashboard configuration is needed before firing — events are created 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 the matching event method wherever the action completes. Not when the screen loads — when the action finishes.

1// after profile form submission succeeds2window.grometrics.event('profile_completed');34// with optional properties5window.grometrics.event('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. Grometrics matches event names without case sensitivity, then counts past and future matching events as completions and calculates the conversion rate automatically.

You can also let events auto-create. Any event name sent through the SDK 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

1window.grometrics.event('account_created');2window.grometrics.event('profile_completed');3window.grometrics.event('first_project_created');4window.grometrics.event('first_message_sent');5window.grometrics.event('onboarding_completed');

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

1await tracker.track('paywall_viewed');2await tracker.track('paywall_dismissed');3await tracker.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.

Visitor CSV exports include both the number of evaluated saved-goal completions and the names of the goals each visitor completed. Funnel completion is reported in the Funnels tab and is not added to the visitor's goal count.

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. An SDK event sent before that context exists may be rejected.

Start tracking first and record a pageview or screen view before product actions. React Native can capture screens from navigation callbacks; native apps call trackScreen from their navigation lifecycle.