Overview

MoEngage is an insights-led Customer Engagement platform for consumer brands, that empowers marketers and product owners with AI-driven insights to create omnichannel experiences that consumers love. The integration enables MoEngage to receive events captured through the Branch SDK, providing up-to-date insights into user actions and preferences.

How does it work?

Once the Branch SDK is integrated into an app, Branch can detect which Branch Links are leading to installs, re-opens, and users' actions. Enabling this integration and providing your MoEngage key will result in Branch automatically forwarding referred events to MoEngage, allowing marketers to activate user behaviors into personalized content.

Branch Events Sent to MoEngage

Branch will send referred installs and opens, as well as any custom, commerce, user lifecycle, and content events you track with Branch. Non-referred events, clicks, web session starts, and pageviews will be excluded. Branch also sends all the analytics tags that are attached to the link that drove the referred event. This will allow you to analyze which campaigns, channels, etc. are helping you acquire and engage users.

Prerequisites

In order to enable MoEngage, you need to have completed the following:

1. Admin access to your Branch Dashboard.
2. Enabled Data Feeds for your Branch account.
   • Contact your Branch account manager or visit https://branch.io/pricing
3. Implemented the latest Branch SDK into your mobile app (iOS | Android)
   • Track events
4. Admin access to your MoEngage account.

Enable MoEngage

1. Retrieve Credentials from MoEngage

In order to enable the MoEngage integration, you need the following:

• Preferred Data Center
• Data API ID
• Data API Key
• App ID

Branch requires these credentials to not only authenticate but to ensure your Branch data is being sent to the correct account. You can gather these from the MoEngage App via Settings > APIs > General Settings Tab

Additional details can be found here.

2. Connect MoEngage in Branch

In the Branch Dashboard in Data Feeds → Data Integrations tab, find and search for MoEngage.

Enter the credentials gathered from the previous step and select a Data Center. Enter them into the respective fields in the Branch Dashboard, and click Enable.

3. Pass Metadata to the Branch SDK

👍

Developer Required

Developers of your mobile app are required for this step

MoEngage requires you to pass through the correct identifiers to the Branch SDKs. In order to do so, pass the Customer ID value that you set when using the MoEngage SDK for Tracking User Attributed (iOS | Android) to the Branch SDK using the following method:

For a given app session, the unique MoEngage Customer ID needs to be passed to the Branch SDK (before the Branch SDK initializes) in order for Branch to properly send events to MoEngage.

// Call before Branch SDK initialization
MoEngageSDKAnalytics.sharedInstance.setUniqueID(UNIQUE_ID)
Branch.getInstance().setRequestMetadataKey("$moengage_customer_id", value: UNIQUE_ID)

// Call before Branch SDK initialization
[[MoEngageSDKAnalytics sharedInstance] setUniqueID:UNIQUE_ID];
[[Branch getInstance] setRequestMetadataKey:@"$moengage_customer_id" value: UNIQUE_ID;

// Call before Branch SDK initialization
MoEAnalyticsHelper.INSTANCE.setUniqueId(context, UNIQUE_ID);
Branch.getInstance().setRequestMetadata("$moengage_customer_id", UNIQUE_ID);

// Call before Branch SDK initialization
MoEAnalyticsHelper.setUniqueId(context, UNIQUE_ID)
Branch.getInstance().setRequestMetadata("$moengage_customer_id", UNIQUE_ID)

4. Verify Data Sent

Once the above steps are complete, you are now ready to start launching campaigns. Branch-attributed conversions will be sent to MoEngage. To verify data is being sent from Branch to MoEngage, you can look at the Branch Dashboard's Liveview Webhook Records and apply the following filter:

📘

Wait Period

Please be patient as data may take some time to flow through Branch's attribution systems and onto MoEngage. If data has not appeared in MoEngage after 30 minutes of completing a test conversion, review the above steps to see if you may have missed something.

Additionally, you can verify that the events have reached MoEngage, through the Recent events screen of the MoEngage Dashboard: