Project Setup

This tutorial walks you through best practices of how to set up Mixpanel, and the considerations to take into account for how and when to create projects, data views, and classified data.

Creating Your Mixpanel Projects

Within your Mixpanel organization, we recommend at the minimum having separate development and production projects. Keeping your development data separate is important to maintain the integrity of your Mixpanel data. It's easy to prevent development data from cluttering your production project, but hard to detangle in later stages of a project.

In certain instances, it may make sense to create separate production projects as well. For example, if your app or web offer fundamentally different functionality, it may make sense to use separate projects so as not to clutter your analytics.

In general though, if you want to track and study cross-platform user behaviour, we recommend using a single production project. Example scenarios:

Your platform teams - web, android, iOS - are separate and just need access to their own data. You can use event properties, e.g. platform = ‘web’, to create data views and give relevant teams access to the views they need. The bonus in this scenario is that you for boards / reports is automatically shared with the different platform teams, and automatically filtered to their specific platform.

You have a B2B and a B2C platform and want to be able to analyze the certain users’ behaviour across both platforms. For instance, you’re a restaurant with a B2B app to manage multiple restaurants and reservations. You also have a B2C app for customers to make reservations. You want to analyze metrics across different entities: customers, restaurants, and reservations of which certain actions can be done either on the B2B or B2C platform. Being able to analyze conversions across these entities where actions can be done on either platform requires data to be in 1 project and having Group Analytics as an add-on.
You have sensitive data that you do want to send into Mixpanel, but want to prevent some users from getting access. In this case, you can still use a single project, but leverage classified data to mark those event or user properties as classified so that only users with access can query and see results on them.

You want to share your Mixpanel metrics perhaps with users outside your organization, who only access to consume reports but not need to be query underlying data - e.g. exec stakeholders who want to see summery metrics, or external vendors that need specific reports. For this, you could turn on and provide public boards.

Adding End Users to Your Mixpanel Organization and Projects

Each Mixpanel customer is assigned an organization which serves as the controlling entity for managing all your Mixpanel analytics needs. Within this, organization owners and admins will have access to monitor your pricing and billing plan and usage to date. They will also be able to invite end users to the organization, a step they need to take before end users can be added to a project.

There are two general approaches to user management in Mixpanel.

Organization owners and admins can create teams at the organization level and then add teams to the different projects. Typically, larger enterprise customers prefer to use this, along with Single Sign-On, for better management of users. Each Mixpanel customer is assigned an organization which serves as the controlling entity for managing all your Mixpanel analytics needs. Within this, organization owners and admins will have access to monitor your pricing and billing plan and usage to date. They will also be able to invite end users to the organization, a step they need to take before end users can be added to a project.

There are two general approaches to user management in Mixpanel.

Organization owners and admins can create teams at the organization level and then add teams to the different projects. Typically, larger enterprise customers prefer to use this, along with Single Sign-On, for better management of users.

Creating Mixpanel Teams at the Organizational Level

Adding Teams and / or End Users to Projects

Organization owners and admins can assign projects or teams directly to user accounts at the organization level by minimally provisioning them with an organization membership.

Once project owners and admins are assigned, they can then add end users to projects and provision their roles.

Other Project Data Configurations

Developer Environments Server-Side Best Practices

Was this page useful?