The Mixpanel integration is available on the [Pro](🔗) plan.
Mixpanel can be a useful integration tool for seeing all events and revenue that occur for your app even if it’s not active for a period of time. You can use Mixpanel’s array of product analytical tools to help get new customers, and engage and retain old customers.
With our Mixpanel integration, you can:
Formulate a data model using interactions between a user and your product.
Use interactive reports to understand when a user converts and why.
With accurate and up-to-date subscription data in Mixpanel, you'll be set to turbocharge your product analytics ⚡️
The Mixpanel integration tracks the following events:
|Event||Default Event Name||Description||App Store||Play Store||Amazon||Stripe||Promo|
|Initial Purchase||rc_initial_purchase_event||A new subscription has been purchased.||✅||✅||✅||✅||❌|
|Trial Started||rc_trial_started_event||The start of an auto-renewing subscription product free trial.||✅||✅||✅||✅||❌|
|Trial Converted||rc_trial_converted_event||When an auto-renewing subscription product converts from a free trial to normal paid period.||✅||✅||✅||✅||❌|
|Trial Cancelled||rc_trial_cancelled_event||When a user turns off renewals for an auto-renewing subscription product during a free trial period.||✅||✅||✅||✅||❌|
|Renewal||rc_renewal_event||An existing subscription has been renewed or a lapsed user has resubscribed.||✅||✅||✅||✅||❌|
|Cancellation||rc_cancellation_event||A subscription or non-renewing purchase has been cancelled. See [cancellation reason](🔗)s for more details.||✅||✅||✅||✅||✅|
|Uncancellation||rc_uncancellation_event||A non-expired cancelled subscription has been re-enabled.||✅||✅||✅||❌||❌|
|Non Subscription Purchase||rc_non_subscription_purchase_event||A customer has made a purchase that will not auto-renew.||✅||✅||✅||✅||✅|
|Subscription paused||rc_subscription_paused_event||A subscription has been paused.||❌||✅||❌||❌||❌|
|Expiration||rc_expiration_event||A subscription has expired and access should be removed. If you have [Platform Server Notifications](🔗) configured, this event will occur as soon as we are notified (within seconds to minutes) of the expiration. If you do not have notifications configured, delays may be approximately 1 hour.||✅||✅||✅||✅||✅|
|Billing Issues||rc_billing_issue_event||There has been a problem trying to charge the subscriber. This does not mean the subscription has expired. Can be safely ignored if listening to CANCELLATION event + cancel_reason=BILLING_ERROR.||✅||✅||✅||✅||❌|
|Product Change||rc_product_change_event||A subscriber has changed the product of their subscription. This does not mean the new subscription is in effect immediately. See [Managing Subscriptions](🔗) for more details on updates, downgrades, and crossgrades.||✅||✅||❌||✅||❌|
For events that have revenue, such as trial conversions and renewals, RevenueCat will automatically record this amount along with the event in Mixpanel.
## 1. Set Mixpanel User Identity
If you're using the Mixpanel SDK, you can set the Distinct Id to match the RevenueCat App User Id. This way, events sent from the Mixpanel SDK and events sent from RevenueCat can be synced to the same user.
Use the `
.identify()` method on the Mixpanel SDK to set the same App User ID that is set in RevenueCat.
#### Custom Mixpanel Subscriber Attribute
We recommend keeping the Mixpanel SDK identifier the same as RevenueCat's App User ID as described above. Alternatively, if you want Mixpanel events tied to a different identifier, you can set a subscriber attribute for `
$mixpanelDistinctId` that is sent with events instead of RevenueCat's App User ID.
If a user has that subscriber attribute set it will be used instead of the RevenueCat App User ID in the Mixpanel events.
## 2. Send RevenueCat Events to Mixpanel
After you've set up the _Purchases SDK_ and Mixpanel SDK, you can "turn on" the integration and configure the event names from the RevenueCat dashboard.
Navigate to your project in the RevenueCat dashboard and find the _Integrations_ card in the left menu. Select **+ New**
Choose _Mixpanel_ from the Integrations menu
Add your Mixpanel Project token
Enter the event names that RevenueCat will send or choose the default event names
Select whether you want sales reported as gross revenue (before app store commission), or after store commission and/or estimated taxes.
# Sample Events
Below are sample JSONs that are delivered to Mixpanel for events.