Skip to main content

Introduction

Branch, one of MoEngage’s Technology Partners, allows you to track install acquisition data to enhance your marketing automation campaigns on MoEngage.

Scope

Use the Publisher Name and Campaign Name of install in MoEngage.

Integration

Prerequisites
  • Ensure you have an active Branch account with admin access.
  • Ensure you have access to the Settings section on your MoEngage dashboard.

Steps

To integrate Branch with MoEngage, follow the steps below.

Step 1: Get the MoEngage attribution tracking key

Log in to the MoEngage Dashboard and follow these steps:
  1. Navigate to Settings > Analytics > Acquisition tracking.
  2. Turn on Acquisition Tracking, and select Branch from the dropdown. This generates an Attribution Key. Acquisition Tracking settings with Branch selected and Attribution Key generated
  3. Click Save.
  4. Copy the Attribution Key. You will need it to configure MoEngage on the Branch dashboard.

Step 2: Configure settings on the Branch dashboard

To configure the settings on the Branch dashboard, follow the steps in the Branch integration document. Enter the following fields on the Branch dashboard: MoEngage configuration fields on the Branch dashboard
FieldDescription
Data CenterSelect one of the following depending on the MoEngage Data Center you have signed up with. For details on identifying your MoEngage data center, refer to Data Centers in MoEngage.
  • DC-01
  • DC-02
  • DC-03
Data API IDThe Data API ID and Data API Key are available at Settings > Account > APIs. The Data API ID is the same as the Workspace ID. The Data API Key is available on the same screen under API Keys > Data.
Data API KeyEnter the Attribution Key generated in Step 1.
App IDFetch the Workspace ID. The Workspace ID of your MoEngage account is available at Settings > Account > APIs > Workspace ID. The Data API ID and the Workspace ID of your MoEngage account are the same.

How to use the acquisition data in MoEngage

After MoEngage starts receiving data from Branch, you can leverage this data in the following ways.

User attributes

MoEngage tracks two user attributes: Campaign Name and Publisher Name. You can use these attributes in your campaigns, segmentation, and analytics. The Publisher Name and Campaign Name of install give you added insight into the persona of the user. You can leverage this data to enhance your onboarding campaigns and user funnels, and to personalize your marketing automation activities on MoEngage. The next sections list a few popular use cases for leveraging this data. Campaign Name and Publisher Name user attributes in MoEngage

Analyze the performance of different publishers

Branch Integration can help in analyzing the effectiveness of your app install campaigns and sources in MoEngage. With the help of the data you are already tracking in MoEngage like user events, conversion goals, and uninstalls, you can compare the performance of different app install campaigns you are running and also analyze the relative performance of installs from different publishers to optimize your marketing spends. To analyze this data, view the MoEngage acquisition dashboard. Acquisition analysis dashboard grouped by publisher If you use MoEngage Analytics, you can leverage the Publisher Name and Campaign Name information of installs to analyze your user funnels.

Analyze the performance of different campaigns

After the integration is enabled, you can also view your acquisition data analysis on the acquisition dashboard by navigating to Analyze > Acquisitions in the dashboard sidebar. Acquisition analytics dashboard grouped by campaign

Enhanced onboarding campaigns

You can use the Publisher Name and Campaign Name of install—available as user properties in MoEngage—to create segments and personalize the push notifications, in-app messages, emails, and SMS that you send through MoEngage. Install attribution data gives you an insight into how users could progress in their lifecycle right when they install the app. This is a very useful piece of information and can help you enhance the performance of your onboarding campaigns by improving retention, reducing the time to first conversion, and driving a higher LTV per user.
Publisher categoryUse case
Publishers where average sessions per user are lowSend push notifications periodically to increase the average number of sessions per user, right from the time users install the app.
Publishers where average LTV is highThese are your potential premium users. Implement a campaign strategy to nurture them into your premium-user segment.
Publishers where the uninstall rate is highIdentify users with a higher propensity to churn immediately after install, and incentivize them to make a first purchase—which can reduce your churn rate.

Data tracking

Custom tracking

At times, your users may install your app from publishers not tracked by Branch, or from publishers that do not allow Branch to forward the install source information at a user level to MoEngage. One workaround is to fetch the install information from such publishers and forward it to MoEngage using the following APIs.
https://api.moengage.com/v1/installInfo?publisher_name=<publisher_name_of_install>&campaign_name=<campaign_name_of_install>&src=branch&appId=<ENTER_APP_ID_HERE>&advertising_id=<device_GAID>&appAttributionKey=<ENTER_APP_KEY_HERE>
Details about the API parameters:
KeyValue
publisher_namePublisher name of the install.
campaign_nameCampaign name of the install.
srcbranch
appIdWorkspace ID of your MoEngage account. You can find this by navigating to Settings > Account > APIs.
advertising_id (Android only)Google Advertising ID of the device on which the install was detected.
idfv (iOS only)IDFV of the iOS device on which the install was detected.
appAttributionKeyAvailable on the MoEngage dashboard by navigating to Settings > Analytics > Acquisition tracking.

Frequently Asked Questions

According to Facebook data sharing policies, install data from Facebook can only be viewed in Branch and not sent to other platforms. These appear as Organic Installs in MoEngage. You can alternatively use the MoEngage APIs to send Facebook install data to MoEngage separately.