Branch

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.
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:

Field	Description
Data Center	Select 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 ID	The 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 Key	Enter the Attribution Key generated in Step 1.
App ID	Fetch 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.

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.

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.

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 category	Use case
Publishers where average sessions per user are low	Send 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 high	These are your potential premium users. Implement a campaign strategy to nurture them into your premium-user segment.
Publishers where the uninstall rate is high	Identify 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.

Android

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>

iOS

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>&idfv=<device_idfv>&appAttributionKey=<ENTER_APP_KEY_HERE>

Details about the API parameters:

Key	Value
publisher_name	Publisher name of the install.
campaign_name	Campaign name of the install.
src	branch
appId	Workspace 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.
appAttributionKey	Available on the MoEngage dashboard by navigating to Settings > Analytics > Acquisition tracking.

Frequently Asked Questions

Can I see the install data from Facebook in MoEngage?

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.