On this page

Branch

Amplitude's Branch streaming integration forwards your Amplitude events to Branch 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 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 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.

  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

Was this helpful?