Amplitude's Branch streaming integration forwards your Amplitude events to [Branch](https://branch.io/) with a few clicks.

## Set up the integration

### Prerequisites

To configure streaming from Amplitude to Branch, you need the following information from Branch.

**Branch Key**: The Branch Key used for authentication. Refer to the [Branch documentation](https://help.branch.io/using-branch/docs/profile-settings#branch-key-and-secret) for help locating your Branch Key.

### Create a new sync

1. In Amplitude Data, click **Catalog** and select the **Destinations** tab.
2. In the Event Streaming section, click **Branch**.
3. Enter a sync name, then click **Create Sync**.

### Enter credentials

Enter your **Branch Key**.

### Configure event forwarding

Under **Send Events**, enable the toggle ("Events are sent to Branch") if you want to stream events to Branch. When enabled, Amplitude automatically forwards events to Branch when it ingests them. Amplitude doesn't send events on a schedule or on-demand using this integration. Amplitude sends events to Branch as [Branch custom events](https://help.branch.io/developers-hub/docs/tracking-commerce-content-lifecycle-and-custom-events#track-custom-events) with a maximum event name length of 40 characters.

1. In **Select and filter events** choose which events you want to send. Choose only the events you need in Branch. _Transformed events aren't supported._
2. In **Map properties to destination**:
    _Transformed user properties aren't supported._

    1. Choose one of the following ways to identify your users in Branch.
        - **Developer ID**: Any unique identifier for each user in Branch.
            1. Select an Amplitude user property that corresponds to your Branch **Developer ID**, from the left dropdown.
            2. Select **Developer ID**, from the corresponding right dropdown.
        - **Browser Fingerprint ID**: A Branch internal-only field for tracking browsers.
            1. Select an Amplitude user property that corresponds to your Branch **Browser Fingerprint ID**, from the left dropdown.
            2. Select **Developer ID**, from the corresponding right dropdown.
        - **IDFA** or **IDFV**: A Branch iOS advertising ID or iOS vendor ID.
            1. Select an Amplitude user property with the value `iOS`, from the left dropdown.
            2. Select **OS**, from the corresponding right dropdown.
            3. Select an Amplitude user property that corresponds to your Branch **IDFA** or **IDFV**, from the left dropdown.
            4. Select **IDFA** or **IDFV**, from the corresponding right dropdown.
        - **Android ID** or **AAID**: A Branch Android hardware ID or Android/Google advertising ID.
            1. Select an Amplitude user property with the value `Android`, from the left dropdown.
            2. Select **OS**, from the corresponding right dropdown.
            3. Select an Amplitude user property that corresponds to your Branch **Android ID** or **AAID**, from the left dropdown.
            4. Select **Android ID** or **AAID**, from the corresponding right dropdown.

    2. (optional) Map other Amplitude user properties to Branch properties.
        1. Select an Amplitude user property that corresponds to a Branch property, from the left dropdown.
        2. Select the Branch property, from the corresponding right dropdown.

    Refer to the full list of [Branch properties supported by Amplitude](#supported-branch-properties).

3. (optional) In **Select additional properties**, select any more event and user properties you want to send to Branch. If you don't select any properties here, Amplitude doesn't send any. Amplitude sends these properties to Branch as Branch custom data. _Transformed event properties and transformed user properties aren't supported._

### Enable sync

When you finish your configuration, toggle the **Status** to "Enabled" at the top of the page and click **Save**.

## Supported Branch properties

- **Developer Identity**
- **Browser Fingerprint ID**
- **IDFA**
- **IDFV**
- **OS**
- **Android ID**
- **AAID**
- OS Version
- Environment
- User Agent
- HTTP Origin
- HTTP Referrer
- Country
- IP Address
- Language
- Device Brand
- Branch Device Token
- Downloaded App Version
- Device Model
- Screen DPI
- Screen Height
- Screen Width