Supabase Auth
Learn how to track a lead conversion event with Supabase Auth and the Dub SDK
When it comes to conversion tracking, a lead
event happens when a user performs an action that indicates interest in your product or service. This could be anything from:
- Signing up for an account
- Adding a product to cart
- Joining a mailing list
In this guide, we will be focusing on tracking new user sign-ups for a SaaS application that uses Supabase Auth for user authentication.
Prerequisites
Before you get started, make sure you follow the Dub Conversions quickstart guide to get Dub Conversions set up for your links:
- Install the @dub/analytics client-side SDK
- Install the Dub server-side SDK
- Enable conversion tracking for your links
Configure Supabase Auth
Next, configure Supabase Auth to track a lead conversion event in the auth callback function.
Here’s how it works in a nutshell:
- In the
/api/auth/callback
route, check if:- the
dub_id
cookie is present. - the user is a new sign up (created in the last 10 minutes).
- the
- If the
dub_id
cookie is present and the user is a new sign up, send a lead event to Dub usingdub.track.lead
- Delete the
dub_id
cookie.
Here’s the full list of attributes you can pass when sending a lead event:
Property | Description | Required |
---|---|---|
clickId | The unique dub_id parameter that the lead conversion event is attributed to. | Yes |
eventName | The name of the event. Example: “Sign up”. | Yes |
customerId | The unique ID of the customer in your system. Will be used to identify and attribute all future events to this customer. | Yes |
customerEmail | The email address of the customer. If not passed, a random email address will be generated. | No |
customerName | The name of the customer. If not passed, a random name will be generated (e.g. “Big Red Caribou”). | No |
customerAvatar | The avatar URL of the customer. If not passed, a random avatar URL will be generated. | No |
Supabase Auth + Next.js App Router Example
Check out a real-world example of this in action – Extrapolate uses Supabase Auth and Next.js App Router to track new user sign-ups.
View your conversions
Once you’ve set this up, all your tracked lead events will show up on your Analytics dashboard. We provide 3 different views to help you understand your conversions:
- Time-series: A time-series view of the number of leads over time.
- Funnel chart: A funnel chart view visualizing the conversion & dropoff rates across the different steps in the conversion funnel (clicks → leads → sales).
- Real-time events stream: A real-time events stream of every single lead event that occurs across all your links in your workspace.
Example Apps
Was this page helpful?