Skip to main content

Overview

This phase has three parts:
  • Plan: Decide which events to track and write them down.
  • Test: Send your events to a development project and check them there.
  • Launch: Move the same tracking to production and confirm it holds up.
You don’t need to track everything at once. Start with a handful of events for one use case, get them live, then repeat Plan, Test, and Launch for the next one.
Most rework in this phase traces back to two early choices: tracking too much, and waiting to decide how you’ll identify each person until data is already flowing. Both are easy to get right at the start and slow to fix later.
Done when:
  • You’ve picked a short list of events
  • They check out in development
  • They reach production

Choose how to set up

You can set Mixpanel up with an AI coding agent or by following the steps yourself. Both get you to the same place, so pick the one that fits how your team works. Either way, keep reading: The sections below explain what’s happening and what you’ll need to decide or review, even if an agent does the work. Set up with AI Recommended
Your agent reads your codebase, suggests events, and adds the SDK. You review every change.
Set up yourself
Follow the steps to send your first events and check them.

Plan

Pick a handful of events to start with, and write them down so your team can build from them.
Using an AI coding agent? Install with AI can suggest your first events from your code, starting with a sign-up and your most important action. If you want a complete plan, it can draft one too. You can use it in place of picking your events yourself.

Decide what to measure

Start with the problem that brought you to Mixpanel, like where people drop off when they sign up. Write down the five to 10 questions you want answered first, then pick a handful of events that answer them. Measure Value · What to Track What counts depends on your business, so here are starting points for a few common ones.
What matters most: Shoppers who buy each week.Start with these events:
  • sign_up_completed: Someone finishes creating an account.
  • item_viewed: Someone looks at an item. Include which item, its type, and its price.
  • item_added_to_cart: Someone adds an item to their cart. Include which item, how many, and the price.
  • checkout_viewed: Someone reaches checkout. Include how many items and the order total.
  • purchase_completed: Someone completes a purchase. Include the order total, payment method, and coupon code.
Small doesn’t mean thin. Cover one journey from start to finish, not a scattering of events across the product.

Choose your events

One event with properties beats one event per item. Skip personal data, and anything Mixpanel already collects. How To Build a Tracking Strategy · Default Properties · Data Privacy & PII Best Practices Name events in snake_case, with the object first and the action second, like item_added_to_cart. Names are case-sensitive, so stick to one style. If you want friendlier names in Mixpanel, set a display name in Lexicon, such as showing item_added_to_cart as Item Added to Cart. Events · Lexicon

Write down your first events

List the events you picked and the properties you want on each, in one place your engineer can build from. You don’t need a complete tracking plan yet, so fill in only your first events and add to it as you grow. Have a teammate, or your Mixpanel contact if you have one, take a look before anyone builds. Create A Tracking Plan
Start with how Mixpanel organizes data into events, users, and properties, so your plan uses the same terms. Data Model
Decide whether to analyze them as groups, not just as users. Group Analytics

Test

Send your events to a development project and check them there, so mistakes never touch your real data.
Using an AI coding agent? Create your development project first, since you’ll need its project token. Then Install with AI can do much of the rest of this section. It picks the right SDK, adds tracking and identity to your code, and checks that events arrive. You’ll still deploy the changes to your testing environment.

Create development and production projects

Make one project for testing and one for your real data. Managing Projects · Developer Environments

Give your engineers access

Implementation often involves more than one person. Make sure everyone who will implement or test has access to your development project. Start with just enough access for that, and set up broader access in Phase 2. Choose how people get access

Choose how data gets in

Pick the method that fits how your product is built. Tracking Methods · Choosing the Right Method
Autocapture records page views and clicks on web without extra code. It can’t tell which actions matter to your business, so use it alongside the events you picked, not instead of them.Events it records still count toward your billing, even if you hide them from reports, so check what it records for anything sensitive first. Autocapture

Send your first events

Send the events you picked to your development project, using the method you chose. Quickstart · SDKs · Tracking Best Practices
If you chose to analyze companies as groups, set up your group keys as you send events. Group Analytics Implementation Guide

Identify your users

Set up identity when you first send data. Identity Management Overview · Identifying Users (Simplified)
Pick a user ID that never changes before you write any identity code. Once a user ID is set, it can’t be changed.

Check your events and identity

Developers check the code, and product teammates walk through the main user flows. Then build one report from your development data that answers a top question. Ensuring Data Quality · Debugging · Insights No events showing? Sending Data FAQ

Launch

Move the same tracking to production and confirm it holds up with real users. Launch here means going live in production. Rolling Mixpanel out to your team comes later.
Used Install with AI? You’ll still launch to production through your usual release process. Review the code your agent wrote before you deploy it.

Switch to your production project

Point your product at your production project, and stop sending test data to your development project. Locate Current Project Token

Deploy and compare

Review the code, deploy it through your usual release process, then compare what arrives with what you tested. Missing or Incomplete Events

Watch for problems

Set up alerts so you hear about drops or spikes before your team does. Alerts · Data Volume Monitoring

Learn more

Mixpanel Onboarding path

A course in Mixpanel University that covers the full setup, one module at a time.

What’s next

Phase 2
Next, move on to Configure your account. You can start it alongside this phase.