Branch S2S Event


Branch is the mobile marketing and linking platform to supercharge your app growth. Branch provides powerful links and solutions that help you acquire, engage, and measure across all devices, channels, and platforms.

mParticle’s Branch S2S integration supports the following platforms:

  • Alexa
  • Android
  • Data feeds
  • Fire TV
  • iOS
  • Roku
  • Smart TV
  • tvOS
  • Web
  • XBox

Which Branch integration should I use?

mParticle supports two separate integrations for sending event data to Branch:

  • An embedded kit integration that bundles key functionality of the Branch SDK with the mParticle SDK and sends event data directly to Branch from an iOS or Android device.
  • A server-to-server (S2S) integration (current page) that forwards data to Branch server-side, via mParticle.

Most customers should use the embedded kit

We strongly recommend using the embedded kit integration if you fall under any of the following categories:

  • Existing mParticle and Branch customers already using the embedded kit
  • Existing mParticle customers newly implementing Branch
  • Customers who are implementing both mParticle and Branch for the first time.

Use case for the S2S integration

The S2S integration has been created primarily to support existing Branch customers, who already have implemented the standalone Branch SDK in their apps, and wish to use mParticle to add additional event-forwarding capability. If you fall into this category, it is recommended that you use the S2S event integration, while taking care not to duplicate any data you are already sending to Branch client-side via their standalone SDK. Keep in mind that for your S2S data to be used by Branch, you will need to include at least one device identity. See Supported IDs for more.

Supported Features

  • Event Forwarding


To set up the Branch S2S integration:

  1. Obtain your Branch Key and Secret from your Branch dashboard.
  2. Enable the Branch server side integration.

Data Processing Notes

Branch will not accept data more than 24 hours old.

Supported IDs

Device IDs

  • Android ID
  • Google Advertising ID (GAID)
  • Apple Advertising ID (IDFA)
  • Apple Vendor ID (IDFV)
  • Fire Advertising ID
  • Microsoft Advertising ID
  • Roku Advertising ID

User IDs

  • Customer ID

Supported Events

mParticle forwards the following event types to Branch:

  • Commerce Event
  • Custom Event
  • Screen View
  • Session Start

Configuration Settings

Setting Name Data Type Default Value Description
Branch Key string Your app Key can be found on the Account Settings > App page of the Branch dashboard.
Branch Secret string Your app Secret can be found on the Account Settings > App page of the Branch dashboard (only used for server-side integration).

Connection Settings

Setting Name Data Type Default Value Description
Branch Developer ID string The mParticle User Identity type to forward as the Branch Developer ID.

Was this page helpful?