> ## Documentation Index
> Fetch the complete documentation index at: https://moengage.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Branch

## Introduction

[Branch](https://branch.io/), 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

<Info>
  **Prerequisites**

  * Ensure you have an active Branch account with admin access.
  * Ensure you have access to the **Settings** section on your MoEngage dashboard.
</Info>

## 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**. <img src="https://mintcdn.com/moengage/7JhYx0SFgvEG_Jfv/images/partner_38390672824980.png?fit=max&auto=format&n=7JhYx0SFgvEG_Jfv&q=85&s=b2857b5d1eb60d10c5fa9bdce9e0cc08" alt="Acquisition Tracking settings with Branch selected and Attribution Key generated" width="928" height="592" data-path="images/partner_38390672824980.png" />
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](https://docs.branch.io/integrations/moengage/#setup).

Enter the following fields on the Branch dashboard:

<img src="https://mintcdn.com/moengage/cJSG0nHne5L3-Q_X/images/partner_31665308965140.png?fit=max&auto=format&n=cJSG0nHne5L3-Q_X&q=85&s=b5f037ac6e04b30fa18129986942797c" alt="MoEngage configuration fields on the Branch dashboard" width="2848" height="1298" data-path="images/partner_31665308965140.png" />

| 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](https://www.moengage.com/docs/user-guide/data/key-concepts/data-centers-in-moengage). <ul><li>DC-01</li><li>DC-02</li><li>DC-03</li></ul> |
| **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.

<img src="https://mintcdn.com/moengage/V7W8fvZbxtTmKTAn/images/partner_11468475332500.png?fit=max&auto=format&n=V7W8fvZbxtTmKTAn&q=85&s=f25badf4157e56a615464103370d4823" alt="Campaign Name and Publisher Name user attributes in MoEngage" width="410" height="231" data-path="images/partner_11468475332500.png" />

### 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](https://app.moengage.com/v3/#/acquisition).

<img src="https://mintcdn.com/moengage/V7W8fvZbxtTmKTAn/images/partner_11468492536468.png?fit=max&auto=format&n=V7W8fvZbxtTmKTAn&q=85&s=8dbb171c09e46397ba1de524b6b70741" alt="Acquisition analysis dashboard grouped by publisher" width="1351" height="338" data-path="images/partner_11468492536468.png" />

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.

<img src="https://mintcdn.com/moengage/V7W8fvZbxtTmKTAn/images/partner_11468493754388.png?fit=max&auto=format&n=V7W8fvZbxtTmKTAn&q=85&s=8df6eb733991b1336424b88341fee2d8" alt="Acquisition analytics dashboard grouped by campaign" width="1199" height="354" data-path="images/partner_11468493754388.png" />

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

<Tabs>
  <Tab title="Android">
    ```text wrap theme={null}
    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>
    ```
  </Tab>

  <Tab title="iOS">
    ```text wrap theme={null}
    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>
    ```
  </Tab>
</Tabs>

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

<AccordionGroup>
  <Accordion title="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.
  </Accordion>
</AccordionGroup>