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

# Branch

> Learn how to set up the Branch mobile measurement integration with Rockerbox

## Overview

If you use [Branch](https://branch.io/) for mobile app installs and engagement, Rockerbox can take in data from Branch to identify cross-device users. When Branch identifies a match between two devices, Rockerbox can use that information to tie together the user's journey across those devices.

<Info>Rockerbox can only support instances where Branch guarantees 100% match accuracy. See [Branch's matching documentation](https://docs.branch.io/resources/matching/#methods-with-100-match-accuracy) for details.</Info>

In order to tie on-site visitors to in-app actions, you need Branch and Rockerbox connected in both places: your website and your app.

## Setup Process

### 1. Install Branch Web SDK

You must have the [Branch Web SDK](https://docs.branch.io/web/integrate/) installed on all pages of your website. The Rockerbox pixel will automatically detect the Branch Web SDK and pull in any identifiers for your account.

### 2. Configure Branch Webhooks

In your Branch dashboard, navigate to **Data Import & Export > Data Feeds > Webhooks > Add New Webhook**.

Using your webhook endpoint, configure a POST to be sent for each of the following Branch events:

* `INSTALL`
* `REINSTALL`
* `RB_IDENTIFY`

Webhook URL format:

```text wrap theme={null}
https://webhooks.getrockerbox.com/branch?advertiser=YOUR_ACCOUNT_NAME
```

Each event should use the same Rockerbox URL. You will need to create a separate webhook for each event (3 total).

If you have additional events you are tracking with Branch (e.g. `COMPLETE_REGISTRATION`), you can create additional webhooks to send them to Rockerbox.

### 3. Contact Rockerbox

Contact [support@rockerbox.com](mailto:support@rockerbox.com) to confirm the integration is active and data is flowing.

## Verification

After setup:

1. Confirm webhook events are being sent to Rockerbox
2. Verify cross-device matching is working in your Rockerbox dashboard
3. Contact [support@rockerbox.com](mailto:support@rockerbox.com) for QA assistance