> 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/amplitude.md).

# Amplitude

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

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

## What it does

| Direction         | What it sends                                                      | What you do with it                                      |
| ----------------- | ------------------------------------------------------------------ | -------------------------------------------------------- |
| Jimo to Amplitude | Experience events: tour, survey, checklist, banner and hint events | Dashboards and funnels in Amplitude                      |
| Amplitude to Jimo | The Amplitude 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%2FRSIwiL9JqiuEgXzDHP1p%2FF2-52a-analytics-flow-amplitude.png?alt=media&amp;token=bcb91525-3a21-43c6-a6ac-6fe5c1a42692" alt="Jimo sends experience events to Amplitude when Jimo to Amplitude is on; Amplitude events reach Jimo through one jimo.push line when Amplitude to Jimo is on, for Who, segments and the On event trigger"><figcaption></figcaption></figure>

## Before you start

* The Amplitude JavaScript SDK loaded and used in your app. Jimo sends its events through it.
* For Amplitude to Jimo, a developer adds one line to the function your app already uses to track Amplitude 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 Amplitude card and click **Enable**.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FqDFhw7DaDoIZzOvQ0R8J%2F04a76aeb969a6acb9a39e99f6752aed5.png?alt=media&amp;token=184203b4-a10a-460a-901c-20b78515d371" alt="Amplitude card in Settings > Integrations"><figcaption></figcaption></figure>

### Send Jimo events to Amplitude

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

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2F5LK8hsh7Z3pePG2ziKjG%2Fab0c5489cf577af06d46dabf52fdda24.png?alt=media&amp;token=0227eab9-c6d1-4cf0-9360-3e17b8da5ac1" alt="Jimo to Amplitude 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://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2F8SYgANA0NdBRTbCWoGLa%2F721b6ebf4ff935ef958feb7b99a18096.png?alt=media&amp;token=6f47bbfd-795f-4b27-9536-78b392c7de40" alt="An Amplitude dashboard built on Jimo events"><figcaption></figcaption></figure>

### Send Amplitude events to Jimo

{% stepper %}
{% step %}

### Turn on the option

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

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FDCIhCfUSnvDHKkO7SD1R%2F92bf3b8099fbb769aef54e3f943e6ee9.png?alt=media&amp;token=fdb8cd01-eb61-4709-ab0e-252f5e16d189" alt="Amplitude to Jimo option turned on"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Add the Jimo call to your tracking function

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

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

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

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

{% endstep %}
{% endstepper %}

## What flows

| Direction         | What arrives                                                                                                                                                                                                | Where you see it                                                                                                                                       |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Jimo to Amplitude | 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 Amplitude, with your other events                                                                                                                   |
| Amplitude 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 Amplitude data in Jimo

* **Target:** build an audience on Amplitude 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://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FNr9Ej5UTRLUsgbKE4tpJ%2F5a5e299756642623ef8903ed36c3f28d.png?alt=media&amp;token=add89875-5bed-42cb-9cd6-c8f00969cf02" alt="Audience built on Amplitude events"><figcaption></figcaption></figure>

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

## Verify

* **Jimo to Amplitude:** complete a tour or a survey yourself, then look for the matching **Jimo Tour Completed** or **Jimo Survey Completed** event in Amplitude.
* **Amplitude 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 Amplitude 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.

#### Amplitude to Jimo starts at setup

Only events sent after you add the Jimo call reach Jimo. Past Amplitude 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)
