Usage Data: Mixpanel

Real-time product usage data is a central component of ChurnZero. With usage data in ChurnZero, your teams can analyze usage trends at the Contact and Account levels, incorporate usage into customer health scores, automate tasks and communications based on customer usage metrics, and more. Mixpanel customers can import their usage data into ChurnZero through a simple integration.

To integrate Mixpanel into ChurnZero instance, you will need to provide your ChurnZero representative the following information:

1. The Mixpanel properties that house the Account External ID and Contact External ID. These are the unique identifiers of contacts and accounts that we will match on to ensure the Mixpanel Events are categorized under the correct customers and users. 
2. The timezone of your Mixpanel Instance
3. Authentication Method- You have two options, either API Secret or Service Account:
   
   1. Service Account- If you are going to use a service account, we need the Service Account Username, Secret, and ProjectID.
   2. Mixpanel API Secret (Legacy)- Note: Mixpanel is deprecating their use of API secret. We support this for legacy integrations, but any new connections should use a Service Account. Read more here.
4. Provide the names of the Mixpanel Events that should sync to ChurnZero.
   • The list of Events that are relevant for your Customer Success team is typically significantly shorter than the full list of Events being sent to Mixpanel.
   • The Event Names you provide need to exactly match the Event Names in Mixpanel.
   • If your Mixpanel Event Names will not be clear to your Customer Success Team, you can provide a "Pretty Name" for each Event.
     

You will also need to ensure that the Mixpanel Distinct ID is designated as super property so we can look up by User ID. This usually is the case by default.

Your ChurnZero contact will then do the final integration configuration. When they are finished, you will see your Mixpanel Events show on the Usage tab of a ChurnZero Account Profile.

• NOTE: Once the Mixpanel integration is enabled for the first time, it will pull in the events of the last six days.
  • For example: If the integration was first enabled on 1/23/2024, it pulls in events that have occurred since 1/17/2024 and the date "1/17/2024" appears in the 'Last Sync' field of the Mixpanel setup page in ChurnZero.

Note: We also recommend installing our JavaScript in addition to this integration. ChurnZero’s Javascript is required to use in-app functionality, time-in-app metrics and for seeing which customers are currently online.