Airbridge

Airbridge is a unified mobile measurement platform that helps you discover true sources of growth through mobile attribution, incrementalist measurement, and marketing mix modeling.

This integration is maintained by Airbridge.

About the integration

The Braze and Airbridge integration lets you pass all non-organic install attribution data from Airbridge to Braze to build personalized marketing campaigns.

Prerequisites

Integration

Step 1: Map device ID

The server-to-server integration can be enabled by including the following code snippets in your apps.

Android

If you have an Android app, you will need to pass a unique Braze device ID to Airbridge.

• android

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
// MainApplciation.java
@Override
public void onCreate() {
    super.onCreate();
    // Initialize Airbridge SDK
    AirbridgeConfig config = new AirbridgeConfig.Builder("APP_NAME", "APP_TOKEN")
        // Make Airbridge SDK explicitly start tracking
        .setAutoStartTrackingEnabled(false)
        .build();
    Airbridge.init(this, config);
    
    // Set device alias into Airbridge SDK
    Airbridge.getCurrentUser().setAlias("braze_device_id", Braze.getInstance(this).getDeviceId());
    // Explicitly start tracking
    Airbridge.startTracking();
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
// MainApplication.kt
override fun onCreate() {
    super.onCreate()
    // Initialize Airbridge SDK
    val config = AirbridgeConfig.Builder("YOUR_APP_NAME", "YOUR_APP_SDK_TOKEN")
        // Make Airbridge SDK explicitly start tracking
        .setAutoStartTrackingEnabled(false)
        .build()
    Airbridge.init(this, config)

    // Set device alias into Airbridge SDK
    Airbridge.getCurrentUser().setAlias("braze_device_id", Braze.getInstance(this).deviceId)
    // Explicitly start tracking
    Airbridge.startTracking()
}

iOS

If you have an iOS app, you may opt to collect IDFV by setting the useUUIDAsDeviceId field to false. If not set, iOS attribution will likely not map accurately from Airbridge to Braze. For more information, refer to Collecting IDFV.

• ios

1
2
3
4
5
6
7
8
9
10
11
// AppDelegate.swift
func application(
  _ application: UIApplication,
  didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]?
) {
    AirBridge.setAutoStartTrackingEnabled(false)
    AirBridge.getInstance("YOUR_APP_TOKEN", appName:"YOUR_APP_NAME", withLaunchOptions:launchOptions)

    AirBridge.state()?.addUserAlias(withKey:"braze_device_id", value:Appboy.sharedInstance()?.getDeviceId())
    AirBridge.startTracking()
}

1
2
3
4
5
6
7
8
9
10
// AppDelegate.m
-           (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
  AirBridge.autoStartTrackingEnabled = NO;
  [AirBridge getInstance:@"YOUR_APP_TOKEN" appName:@"YOUR_APP_NAME" withLaunchOptions:launchOptions];

    [AirBridge.state addUserAliasWithKey:@"braze_device_id" value:Appboy.sharedInstance.getDeviceId];
    [AirBridge startTracking];
}

React Native

• typescript

1
2
3
4
Braze.getInstallTrackingId(function (error, brazeID) {
    Airbridge.state.setDeviceAlias("braze_device_id", brazeID)
    Airbirdge.state.startTracking()
})

Cordova

• typescript

1
2
3
4
AppboyPlugin.getDeviceId(function (brazeID) {
    Airbridge.state.setDeviceAlias("braze_device_id", brazeID)
  Airbridge.state.startTracking()
})

Flutter

• typescript

1
2
3
4
BrazePlugin.getInstallTrackingId().then((brazeID) {
    Airbridge.state.setDeviceAlias("braze_device_id", brazeID)
  Airbridge.state.startTracking()
})

Unity

• c#

1
2
3
string BrazeID = AppboyBinding.GetInstallTrackingId();
AirbridgeUnity.SetDeviceAlias("braze_device_id", BrazeID);
AirbridgeUnity.StartTracking()

Step 2: Get the Braze data import key

In Braze, navigate to Partner Integrations > Technology Partners and select Airbridge.

Here, you will find the REST endpoint and generate your Braze data import key. After the key is generated generated, you can create a new key or invalidate an existing one. The data import key and the REST endpoint are used in the next step when setting up a postback in Airbridge’s dashboard.

Step 3: Configure Braze in Airbridge’s dashboard

1. In Airbridge, navigate to Integrations > Third-party Integrations in the left sidebar and select Braze.
2. Provide the data import key and REST endpoint that you found in the Braze dashboard.
3. Select the event type (Install Event or Install & Deeplink Open Event) and save.

For more detailed instructions, visit Airbridge.

Step 4: Confirm the integration

Once Braze receives attribution data from Airbridge, the status connection indicator on the Airbridge technology partners page in Braze will change from “Not Connected” to “Connected”. A timestamp of the last successful request will also be included.

Note that this will not happen until we receive data about an attributed install. Organic installs, which should be excluded from the Airbridge postback, are ignored by our API and are not counted when determining if a successful connection was established.

Available data fields

Airbridge can send four types of attribution data to Braze listed in the following data field chart. This data can be viewed in the Airbridge dashboard and is used for user install attribution and filtering.

Assuming you configure your integration as suggested, Braze will map install data to segment filters.

Your user base can be segmented by attribution data in the Braze dashboard using the Install Attribution filters.

Meta Business attribution data

Attribution data for Meta Business campaigns is not available through our partners. This media source does not permit their partners to share attribution data with third parties and, therefore, our partners cannot send that data to Braze.

Airbridge click tracking URLs in Braze (optional)

Using click tracking links in your Braze campaigns will allow you to easily see which campaigns are driving app installs and re-engagement. As a result, you’ll be able to measure your marketing efforts more effectively and make data-driven decisions on where to invest more resources for the maximum ROI.

To get started with Airbridge click tracking links, visit Airbridge. After set up is completed, you can directly insert the Airbridge click tracking links into your Braze campaigns. Airbridge will then use its probabilistic attribution methodologies to attribute the user that has clicked on the link. We recommend appending your Airbridge tracking links with a device identifier to improve the accuracy of attributions from your Braze campaigns. This will deterministically attribute the user that has clicked on the link.

• android
• ios

1
2
3
{% if most_recently_used_device.${platform} == 'android' %}
aifa={{most_recently_used_device.${google_ad_id}}}
{% endif %}

1
2
3
{% if most_recently_used_device.${platform} == 'ios' %}
idfv={{most_recently_used_device.${id}}}
{% endif %}