The Amplitude Professional Services team has compiled this Mixpanel to Amplitude Implementation Guide to help you implement Amplitude and start getting insights right out of the gate.
With the goal of driving tangible conversion, retention, and product outcomes, this guide provides you with recommended use cases and business questions, a proposed taxonomy, and example charts that can be used for your implementation.
Learn about how Whisk migrated from Mixpanel to Amplitude on the Amplitude Blog.
The steps below provide a roadmap to the process of migrating to Amplitude.
You can send data to Amplitude client-side, server-side, or through a third party.
Amplitude provides a workbook with the most common use cases from other Amplitude customers who've migrated from Mixpanel. For more information, see the Mixpanel to Amplitude Migration Workbook
Key points:
Key questions:
Key questions:
Key questions:
Amplitude provides a suggested Mixpanel to Amplitude Taxonomyfor tracking a minimum set of Events, Event Properties, User Properties.
Send live event data from your website to Amplitude and/or migrate your existing historical data from Mixpanel to Amplitude.
Amplitude's recommendation depends on the method you use to track events.
For client-side event tracking:
For server-side event tracking:
Amplitude offers several methods that map to Mixpanel methods.
'mixpanel.track()'
method, which takes an event name and sets of properties.'amplitude.getinstance().logEvent()'
method. This also takes an event name and set of properties as a JSON object.Super properties in Mixpanel are properties that attach to all subsequent events. Amplitude's User Properties function similarly in that once set, these properties attach to all subsequent events that Amplitude ingests.
'mixpanel.register()'
method.'amplitude.identify()'
method.distinct_id
(a randomly generated identifier on a specific platform) and user_id
(explicitly set by the instrumenting teams) to identify a user with the 'mixpanel.identify()'
method.device_id
(a randomly generated id on a specific platform) and user_id
(explicitly set by the instrumenting teams) to identify a user with the 'amplitude.identify()'
method.For more on how Amplitude resolves user identifies, see Track unique users
Amplitude offers a few options to migrate your historical data from Mixpanel to Amplitude:
Along with the ingestion methods above, here are some features or areas to consider when managing your customer data:
Amplitude provides a tool that can import historical Mixpanel events into your Amplitude project. When you add your Mixpanel project's API key or service account credentials, this tool uses Mixpanel's Export API to export event data from Mixpanel, and import it to your Amplitude project. The integration doesn't support user profile information.
If you need to import user profile information, Amplitude provides the following options:
Make sure you provide the correct authentication to the Mixpanel import tool.
If you use your Mixpanel project's API key, be sure to reference the correct project. Each project in Mixpanel has its own API key.
If you use a Mixpanel service account, ensure you enter the credentials as follows:
Service account value | Amplitude field |
---|---|
Username | The username field in the import tool |
Password | The API Key field |
Project ID | The Project ID field |
If you don't have the username and password for your Mixpanel project's service account, create a new service account associated with your project, and copy the values.
Ensure your Mixpanel service account has the necessary permissions to access the information you need. Test your credentials with Mixpanel's Download Data page. If the page responds with a 200
status, your service account has the necessary permissions.
The data set may be too large to process. Try again with a more narrow time range.
Amplitude detects and excludes duplicate events. If your data contains a large number of duplicates, the events that Amplitude imports may be fewer than expected.
Some Mixpanel events may not be compatible with Amplitude events due to missing information. If your Mixpanel instrumentation doesn't capture fields like name
, date
, or device ID
, Amplitude may not import them.
Amplitude is fully GDPR compliant.
For more information about compliance, see Security and Privacy.
Amplitude maintains a user privacy API that allows you to service end user data deletion requests.
For any feedback or questions on this implementation guide, submit them here.
Thanks for your feedback!
December 21st, 2024
Need help? Contact Support
Visit Amplitude.com
Have a look at the Amplitude Blog
Learn more at Amplitude Academy
© 2024 Amplitude, Inc. All rights reserved. Amplitude is a registered trademark of Amplitude, Inc.