Amplitude

Amplitude is a product analytics platform.

The Userflow-Amplitude integration enables you to analyze how users interact with your flows/checklists, and correlate it to other behavioral analytics that you collect in Amplitude.

• What you can do with this integration
• Amplitude projects and Userflow environments
• Setup guide: Userflow event streaming to Amplitude
  • Stopping event streaming
• Setup guide: Amplitude cohort sync to Userflow

What you can do with this integration

• Userflow-generated events, such as Flow Started and Checklist Task Completed, can be continuously streamed into your Amplitude project of choice.
• Cohorts defined in Amplitude can be synced to Userflow for content targeting.

Amplitude projects and Userflow environments

It’s recommended to use a separate Amplitude project for each of your environments (Production, Staging etc.). The same is true in Userflow. This is to ensure that e.g. Staging data doesn’t pollute Production data.

A Userflow-Amplitude integration is between a single Userflow environment and a single Amplitude project. If you have both a Staging and a Production environment, you therefore have to run the below setup guide for both Production and for Staging.

We strongly recommend that you start with your Staging environment/project, and verify that it works as you expect, before connecting your Production environment/project.

Required User ID match for integration

To match data between users in Amplitude and Userflow it is a requirement that you use the same user id to identify users in both platforms.

Setup guide: Userflow event streaming to Amplitude

1. Sign into Amplitude and navigate to Settings.

2. Then navigate to Projects.

3. Select the project you want to stream Userflow events to:

4. Copy the Api Key:

5. Sign into Userflow and navigate to the environment you want to stream Userflow events from:

6. Go to Settings → Integrations. Then click Add integration:

7. Find and click Amplitude in the list:

8. Click Add Amplitude (activate/upgrade your plan if you don’t yet have access):

9. Paste the API Key that you copied from Amplitude in step 4 into the Amplitude API Key field and click Save:

10. Click the Stream events from Userflow to Amplitude switch and confirm in the dialog that appears:

11. Event streaming will start immediately:

12. Go to Amplitude and navigate to User Look-Up from the main menu:

13. Make sure that the right project is selected in the top. Then verify that Userflow events start showing up. It may take a minute for Amplitude to show them:

Stopping event streaming

1. Find your Amplitude integration in Userflow under Settings → Integrations.
2. If the Stream events from Userflow to Amplitude switch is gray, then it’s already stopped. If it’s green, then it’s currently running.
3. Click the Stream events from Userflow to Amplitude switch and confirm in the dialog that appears.
4. Event streaming will stop immediately.

Setup guide: Amplitude cohort sync to Userflow

This feature allows you to continuously sync cohorts from Amplitude to Userflow segments (we call these lists of users “segments”, while Amplitude calls them “cohorts”, but they’re the same thing).

1. Setup the Amplitude integration in Userflow as mentioned in the previous section.
2. In Userflow, under Settings → Integrations → Amplitude, click Reveal Integration Secret.
3. Copy the Integration Secret to your clipboard.
4. In Amplitude, navigate to Cohorts.
5. Pick the cohort you want to sync to Userflow.
6. Click Sync to… → Destinations Page → View All Destinations.
7. Find and click Userflow.
8. Click Add another destination.
9. Give it a name, such as the account name and environment name from Userflow.
10. Paste the Integration Secret you copied from Userflow.
11. Important! Under User ID Mapping, choose User ID on the Amplitude side. It’s important that you use the same user ID in Amplitude and in Userflow.
12. Click Save.
13. Navigate back to the cohort you wanted to sync to Userflow.
14. You may have to reload the page for the next step to work.
15. Click Sync to… → Userflow.
16. Choose whether you want to do a one-time sync or a recurring sync.
17. Click Save sync.
18. Once Amplitude starts syncing (should happen immediately), you’ll be able to see the cohort as a segment on your Users page in Userflow.