Introduction
With the integration, MoEngage will forward all campaign data that we are generating to mParticle. The data points sent to mParticle from MoEngage are available here -> Campaign Interaction Events.
Steps
You need to setup MoEngage feed as an input in mParticle as shown below -
1. On the Mparticle dashboard, click on the Connections >> Feed >> Input feed.
2. Select MoEngage as custom input feed.
3. On your MoEngage Dashboard >> App Marketplace, search for mParticle and go to the Integrate tab. Click on "+ Add Integration" button to add a new integration.
4. Fill up the details and click on "Connect".
| Field | Details |
|---|---|
| Server to Server Key | Paste the Server to Server Key that you found in the mParticle Dashboard during the Feed Configuration. |
| Server to Server Secret | Paste the Server to Server Secret that you found in the mParticle Dashboard during the Feed Configuration. |
| Events | Select the event(s) you want to forward to mParticle. |
| Data Residency | Select the region of your mParticle account. |
5. Once you have enabled the data export integration from MoEngage, you should start seeing the campaign events in mParticle.
Limitations
The mParticle Integration only takes care of sending events to MoEngage from mParticle. To leverage MoEngage capabilities like push notifications, in-apps would require some additional integration which is listed in the below table -
| Integration | Details |
|---|---|
| Android SDK | For showing push notifications, capturing performance stats, showing in-app messages and real time triggers on your Android app. |
| iOS SDK | For showing push notifications, capturing performance stats, showing in-app messages and real time triggers on your iOS app. |
| User Mapping | If you need to send push notifications or in-app messages to your users basis behavioral data from mParticle, you would need to pass the a unique user id to MoEngage SDK which should be the same as the mParticle customer_id. |
| Logout | Please ensure that you are not calling MoEngage logout methods from Android or iOS as this may lead to data getting corrupted. For mParticle integration, we need the user unique_id immediately on the first app_open after install. You could use the device ids like GAID, IDFV for this or the MPID or any other customer_id that you are tracking with mParticle. |
| InApp Messages | For showing an in-app message immediately after the user performs an action on your app. To do this, you would need to send such a trigger event via MoEngage SDK directly. Please take care to not use the same event as in mParticle for this case as it may lead to duplication of events. |
| Geo fencing | Geo-fencing would need separate integration as well. Android | iOS |
Please note that for MoEngage services like Push Notifications, In-App Messaging and other channels to work, you will need to integrate the MoEngage SDK. You can refer MoEngage developer documentation here.