Introduction

Amplitude enables you to drive growth through robust product and behavioral analytics. Gain a thorough understanding of exactly what behaviors and traits are common among user segments to inform powerful targeting.

Scope

• Enable deeper behavioral and product analysis with MoEngage and Amplitude.
• Gauge the efficacy of segmentation and experimentation on the customer experience through Amplitude and send personalized messages through MoEngage.
• Export behavioral cohorts directly from Amplitude to MoEngage or utilize Streams to export data from MoEngage to Amplitude.

Benefits and Use Cases

The following use-cases provide integration value addition to your analytics + user engagement activities:

E-commerce

Understand the seasonal changes in purchase trends that are happening and send rich push notifications to such users using MoEngage. For example, target the cohort of users who purchase high-value items during summers and send rich push notifications with similar recommended items.

Travel

You can create a cohort in Amplitude of millennial users who are also premium users of your app and send them popular and unique holiday destination recommendations using MoEngage emails.

Steps

Enabling Amplitude and MoEngage Integration for your account.

1. For enabling the cohort sync integration, please reach out to Amplitude and get this enabled for your account.
2. Once you have the integration enabled for your Amplitude account, you will be able to configure MoEngage as a destination in Amplitude. See the below steps for setting this up.
3. To enable the data export integration from MoEngage to Amplitude, please reach out to your MoEngage customer success manager or write to support@moengage.com with a few details mentioned in this section - Exporting Campaign Data from MoEngage to Amplitude

Setting up MoEngage as a destination on Amplitude

To setup MoEngage as a destination on Amplitude, follow the below steps:

1. Log in to Amplitude and Navigate to Sources and Destinations.
   
2. On the Sources & Destinations Page, go to Destinations and click on Add Destination -> MoEngage. On doing this, you will see a pop-up with the following details:
   
3. Log in to your MoEngage Dashboard and navigate to Settings to get the Workspace ID and Secret Key.

   info	Information We have revamped our dashboard settings UI. Acquisition Settings are available in Settings -> Analytics and Data -> Acquisition tracking. For more information, refer to Summary of Changes - Settings UI Revamp.

   Revamped UI Old UI

   Navigate to Settings -> APIs.

   1. Click on the copy icon to copy the Workspace ID. 

   2. Click on the copy icon in the Data tile in the API Keys section to copy the Secret Key.

   

   Navigate to Settings-> API -> DATA API SETTINGS. You can see the Workspace ID and Secret Key. 

    

4. The Attribute Mapping is as follows:
   
   • User Id - This will be the primary key to map a user between Amplitude and MoEngage. Please ensure that you are identifying users with the same unique user id in both Amplitude and MoEngage.
   • moe_anonymous_id: This will be the secondary identifier that will be used to map users between Amplitude and MoEngage and will be essential to map the anonymous users between Amplitude and MoEngage. Please ensure that you are setting moe_anonymous_id as a user attribute in MoEngage and the attribute selection made on the Amplitude dashboard and moe_anonymous_id in MoEngage have the same value so that the mapping is possible.
5. Complete the Destination Setup:

After everything is configured on the Amplitude dashboard, click Save to add MoEngage as a destination.

Exporting Cohorts from Amplitude to MoEngage

To export specific behavioral cohorts from Amplitude to MoEngage, please follow the below steps:

1. Open a cohort in Amplitude that you want to sync with MoEngage and click "Sync To" -> Select MoEngage.
   
   The Sync your cohort to MoEngage pop-up is displayed.
   
   
2. Select one of the following:
   • One-Time Sync: This will only send the users under the cohort to MoEngage once and the cohort will not sync thereafter.
   • Scheduled Sync: This option will ensure that the updated information of the cohorts like the new users who qualify for this cohort and the existing users who are removed from the cohort are sent to MoEngage every hour or day.
   • Near Real Time Sync: This option will ensure that the updated information of the cohorts like the new users who qualify for this cohort and the existing users who are removed from the cohort are sent to MoEngage every minute.

Using Cohorts in MoEngage Campaigns

After the sync, the cohort is available as a custom segment in MoEngage as described:

The custom segment is used in any MoEngage campaigns to send personalized messages to the users under this segment.

Exporting Campaign Data from MoEngage to Amplitude

To setup exports to Amplitude, go to MoEngage Dashboard >> App Marketplace. Search for Amplitude and go to the Integrate tab.

1. Click on "+ Add Integration".
2. Fill up the form: Amplitude API Key - This is available on your Amplitude Account -> Settings -> ProjectName -> General -> API Key as shown below - 
   
   
   
3. Select the events you want to forward and select a Data Residency.
4. Click on Connect.

All the events sent by MoEngage are displayed in Amplitude by filtering basis $source = MOENGAGE. These events are sent to Amplitude in near real-time and will rely on the common user identifier between Amplitude and MoEngage for user identification. 

The following MoEngage source-specific documents for setting unique user id in MoEngage:

• Android
• iOS 
• Web
• Data API (Server-side integration)

Export Data

Following data points are sent by default to Amplitude: