Segment (Export)

Overview

With a push of a button you can send your Branch data to your Segment dashboard, helping you to understand the power of Branch as an acquisition pathway, export your data to your entire suite of analytics tools and build custom audiences upon Branch data.

This documentation explains how to send Branch-referred events to Segment. If you'd like to send Segment events to your Branch dashboard, please review the Segment Import integration.

How does it work?

Once the Branch SDK is integrated into an app, Branch can detect which links are leading to installs, re-opens, and users' actions. Enabling this integration and providing your Segment credentials will result in Branch automatically forwarding attributed events to Segment, in the exact format Segment expects.

Branch events sent to Segment

Branch will send attributed installs and opens, as well as any content events, lifecycle events,custom events and commerce events you track with Branch. Non-referred events, clicks, web session starts, and pageviews will be excluded. Branch also sends all the data that is attached to the link that drove the referred event. This will allow you to analyze which campaigns, channels, etc. are helping you acquire and engage users.

All of the above properties are received as flat properties[key], even though some are stored as dictionaries in Branch. They are grouped in our documentation for legibility.

WebSDK events not supported

We do not support Segment export for Branch WebSDK events

What does it look like?

Branch events will appear as an event prepended with branch_ in your Segment debugger.

Additionally, individual events, such as those seen in Live View or visible when looking at People, will have Branch link data included. Here's an example:

Prerequisites

In order to enable Segment (export), you need to have completed the following:

1. Admin access to your Branch Dashboard.

2. Have the Advanced Data Feeds add-on enabled on your Branch account. Advanced Data Feeds can be included as an add-on to both the Engagement and Performance products.

3. Implemented the Branch SDK into your mobile app (iOS | Android)

4. Implement the Segment mobile SDK

5. Admin access to your Segment account.

Enable Segment (Export)

1. Retrieve your Segment Token

Find your Segment Token and enter it into the Branch Dashboard.

1. Navigate to https://app.segment.com and log into the Dashboard.

2. In the dashboard, navigate to your desired Workspace.

3. In that Workspace, navigate to Sources and select the Source that has your app listed. Branch is not yet an independent Source, so Branch events appear within your app's Source.

   

4. Click through to Settings > API Keys

   

5. Copy your key and secret - you'll enter it into the Branch dashboard in a minute.

2. Enable Segment (Export) in Branch

1. On the Branch Dashboard (dashboard.branch.io), navigate to the Integrations page.

2. Search for Segment and click on the tile.

3. Enter your Segment Token under the "Export" section and hit Enable.

   

3. Configure App

Pass Segment Anonymous ID

When you're ready to send data through Branch, you'll need to make sure you pass through the configured Segment Anonymous ID the Branch SDKs. In order to do so, you'll ask the Segment SDK to provide you with the Segment Anonymous ID, and pass this value through setRequestMetadataKey on the Branch SDKs.

Here's a sample snippet showing this. NOTE you must set the correct key before calling sessionBuilder()...init(). You must also initialize the Segment SDK before setting the request metadata in the Branch SDK.

iOS

Inside didFinishLaunchingWithOptions

Branch *branch = [Branch getInstance];
[[Branch getInstance] setRequestMetadataKey:@"$segment_anonymous_id" value:[[SEGAnalytics sharedAnalytics] getAnonymousId]];

Swift

Inside didFinishLaunchingWithOptions

if let branch = Branch.getInstance() {
    branch.setRequestMetadataKey("$segment_anonymous_id", value:"1234" as NSObject!);
}

Android

Before you initialize in your Application#onCreate or Deep Link Activity's #onCreate.

Branch.getInstance().setRequestMetadata("$segment_anonymous_id", com.segment.analytics.Analytics.with(this).getAnalyticsContext().traits().anonymousId());

...

Branch.sessionBuilder(this)...init();"

In the above snippet, this is the Activity context.

4. Verify Data Sent

Once the above steps are complete, you are now ready to start launching campaigns. Branch-attributed conversions will be sent to Segment. To verify data is being sent from Branch to Segment, you can look at the Branch Dashboard's Liveview Webhook Records and apply the following filter: