> For the complete documentation index, see [llms.txt](https://help.usejimo.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.usejimo.com/docs/integrations/mixpanel.md).

# Mixpanel

Send Jimo experience events to Mixpanel, and Mixpanel events to Jimo for targeting and triggers.

The Mixpanel integration works in both directions. Jimo sends experience events to Mixpanel for your dashboards, and Mixpanel events come into Jimo to target and trigger experiences.

## What it does

| Direction        | What it sends                                                      | What you do with it                                      |
| ---------------- | ------------------------------------------------------------------ | -------------------------------------------------------- |
| Jimo to Mixpanel | Experience events: tour, survey, checklist, banner and hint events | Dashboards and funnels in Mixpanel                       |
| Mixpanel to Jimo | The Mixpanel events your app tracks                                | Audiences in Who, segments, and the **On event** trigger |

Each direction is a separate option in the integration settings. Turn on only the ones you need.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2Fmp4D69qGIYvuqwMAJ8mk%2FF2-52c-analytics-flow-mixpanel.png?alt=media&amp;token=02c7713f-77ed-4fbe-a200-73ce4444af15" alt="Jimo sends experience events to Mixpanel when Jimo to Mixpanel is on; Mixpanel events reach Jimo through one jimo.push line when Mixpanel to Jimo is on, for Who, segments and the On event trigger"><figcaption></figcaption></figure>

## Before you start

* The Mixpanel JavaScript SDK loaded and used in your app. Jimo sends its events through it.
* For Mixpanel to Jimo, a developer adds one line to the function your app already uses to track Mixpanel events.
* A Jimo role with access to the Integrations settings. See [Integration setup](https://help.usejimo.com/docs/integrations/integration-setup.md).

## Connect

In [Settings > Integrations](https://i.usejimo.com/settings/integrations), hover the Mixpanel card and click **Enable**.

<div align="left"><figure><img src="https://i.gyazo.com/bb135f45fe28c35c805229a420d215b4.png" alt="Mixpanel card in Settings > Integrations" width="375"><figcaption></figcaption></figure></div>

### Send Jimo events to Mixpanel

Turn on the option **Jimo → Mixpanel** in the integration settings.

<figure><img src="https://i.gyazo.com/f531fdebdd157ff632beff8824af4bef.png" alt="Jimo to Mixpanel option turned on"><figcaption></figcaption></figure>

The events and their properties are listed in [Events for analytics integrations](https://help.usejimo.com/docs/integrations/events-for-analytics-integrations.md).

<figure><img src="https://i.gyazo.com/66209788efefb0827ea979ac11be82f2.png" alt="A Mixpanel dashboard built on Jimo events"><figcaption></figcaption></figure>

### Send Mixpanel events to Jimo

{% stepper %}
{% step %}

### Turn on the option

Turn on **Mixpanel → Jimo** in the integration settings.

<figure><img src="https://i.gyazo.com/e1b2689c783e26ccbcb1377ff25be35b.png" alt="Mixpanel to Jimo option turned on"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Add the Jimo call to your tracking function

Most apps track Mixpanel events through one shared function. Add the Jimo call next to the Mixpanel call, so every event reaches both tools.

```javascript
// Your shared tracking function
const trackEvent = (name, properties) => {
  window.mixpanel.track(name, properties); // You should have this already

  window.jimo.push(["do", "mixpanel:track", [name, properties]]);
};

// Example
trackEvent("purchase", { amount: 199 });
```

{% endstep %}
{% endstepper %}

## What flows

| Direction        | What arrives                                                                                                                                                                                                | Where you see it                                                                                                                                       |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Jimo to Mixpanel | The events listed in [Events for analytics integrations](https://help.usejimo.com/docs/integrations/events-for-analytics-integrations.md), named **Jimo Tour Started**, **Jimo Survey Completed** and so on | In Mixpanel, with your other events                                                                                                                    |
| Mixpanel to Jimo | The events your tracking function passes to `jimo.push`, from the day you add the call                                                                                                                      | Listed in [Success Tracker > Events](https://help.usejimo.com/docs/analyze/success-tracker/events.md), and available in Who, segments and **On event** |

## Use Mixpanel data in Jimo

* **Target:** build an audience on Mixpanel events in [Who](https://help.usejimo.com/docs/publish/target-right-people-who.md), or save it as a [segment](https://help.usejimo.com/docs/analyze/users-and-segments/audience/segments/create-a-segment.md).

<figure><img src="https://i.gyazo.com/dc2c3ee3dea4418a05a537983b179610.png" alt="Audience built on Mixpanel events"><figcaption></figcaption></figure>

* **Trigger:** show an experience right after a Mixpanel event. In the experience's settings, set **Show on** to **On event** and select the Mixpanel event. See [Show on](https://help.usejimo.com/docs/publish/trigger-on-the-right-spot-show-on.md#on-event).

## Verify

* **Jimo to Mixpanel:** complete a tour or a survey yourself, then look for the matching **Jimo Tour Completed** or **Jimo Survey Completed** event in Mixpanel.
* **Mixpanel to Jimo:** fire a tracked event in your app, then check that it is listed in [Success Tracker > Events](https://help.usejimo.com/docs/analyze/success-tracker/events.md). The list shows each event once, with its **Source** and when it was **Last received at**, not a history over time: to follow an event over time, create a feature usage [tracker](https://help.usejimo.com/docs/analyze/success-tracker/trackers.md).

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FHQ6OzATEzsI5Ysw2PSZd%2FF2-03-incoming-event.png?alt=media&amp;token=cb7ffdec-4caf-4022-aa84-a47bec0e0c71" alt="Success Tracker > Events, with the columns Name, Source, Created at and Last received at. The row of an event received from Segment is outlined, and A marks its Source."><figcaption></figcaption></figure>

## Limits

#### Jimo to Mixpanel only sends experience events

The events listed in [Events for analytics integrations](https://help.usejimo.com/docs/integrations/events-for-analytics-integrations.md). Changelog posts and resource center interactions are not in that list.

#### Mixpanel to Jimo starts at setup

Only events sent after you add the Jimo call reach Jimo. Past Mixpanel events are not imported.

## Related

* [Events for analytics integrations](https://help.usejimo.com/docs/integrations/events-for-analytics-integrations.md)
* [Integrations](https://help.usejimo.com/docs/integrations/integrations-list.md)
* [Attributes and events](https://help.usejimo.com/docs/getting-started/install-jimo/attributes-and-events.md)
