> ## Documentation Index
> Fetch the complete documentation index at: https://help.airbridge.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Braze

Airbridge supports integration with Braze. With the integration, you can send the attribution data from Airbridge to Braze and leverage the data for effective customer relations management.

## Integration

Airbridge SDK collects and sends data to the Braze server. We recommend using both of the following methods together for a complete integration.

By setting the Braze SDK's device ID as a Device Alias in the Airbridge SDK, you can match all devices including non-logged-in users. In addition, by setting the Braze External ID as a User Alias in the Airbridge SDK, you can leverage [Braze Audience](https://www.braze.com/docs/en/user_guide/audience/your_audience)-based precise targeting for logged-in users.

### Minimum SDK version required

* Airbridge Android SDK: 2.19.5
* Airbridge iOS SDK: 1.18.0
* Airbridge React Native SDK: 1.5.0
* Airbridge Cordova SDK: 2.0.2
* Airbridge Flutter SDK: 3.0.2
* Airbridge Unity SDK: 1.9.0

### SDK setup

<Danger>
  **Attention**

  Once the SDK setup is complete, make sure to complete the required setup process in the Airbridge dashboard to implement the integration successfully.
</Danger>

Add the codes below to the Airbridge SDK. Without adding the codes, Braze won't be properly integrated with Airbridge even if the necessary setup is completed in the Airbridge dashboard.

<AccordionGroup>
  <Accordion title="SDK integration (Android)">
    #### Android SDK

    <CodeGroup>
      ```kotlin Kotlin lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
      // MainApplication.kt
      override fun onCreate() {
          super.onCreate()
          // Initialize Airbridge SDK
          val option = AirbridgeOptionBuilder("YOUR_APP_NAME", "YOUR_APP_SDK_TOKEN")
              .setAutoStartTrackingEnabled(false)
              .build()
          Airbridge.initializeSDK(this, option)

          // Set device alias into Airbridge SDK
          Airbridge.setDeviceAlias("braze_device_id", Braze.getInstance(this).deviceId)
          // Set user alias into Airbridge SDK
          Airbridge.setUserAlias("braze_external_id", "some-braze-external-id-value")
          
          // Explicitly start tracking
          Airbridge.startTracking()
      }
      ```

      ```java Java lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
      // MainApplication.java
      @Override
      public void onCreate() {
          super.onCreate();
          // Initialize Airbridge SDK
          AirbridgeOption option = new AirbridgeOptionBuilder("APP_NAME", "APP_TOKEN")
              .setAutoStartTrackingEnabled(false)
              .build();
          Airbridge.initializeSDK(application, option);
          
          // Set device alias into Airbridge SDK
          Airbridge.setDeviceAlias("braze_device_id", Braze.getInstance(this).getDeviceId());
          // Set user alias into Airbridge SDK
          Airbridge.setUserAlias("braze_external_id", "some-braze-external-id-value");
          
          // Explicitly start tracking
          Airbridge.startTracking();
      }
      ```
    </CodeGroup>

    #### Android SDK (Deprecated)

    <CodeGroup>
      ```kotlin Kotlin lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
      // MainApplication.kt
      override fun onCreate() {
          super.onCreate()
          // Initialize Airbridge SDK
          val config = AirbridgeConfig.Builder("YOUR_APP_NAME", "YOUR_APP_SDK_TOKEN")
              .setAutoStartTrackingEnabled(false)
              .build()
          Airbridge.init(this, config)

          // Set device alias into Airbridge SDK
          Airbridge.setDeviceAlias("braze_device_id", Braze.getInstance(this).deviceId)
          // Set user alias into Airbridge SDK
          Airbridge.setUserAlias("braze_external_id", "some-braze-external-id-value")
          
          // Explicitly start tracking
          Airbridge.startTracking()
      }
      ```

      ```java Java lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
      // MainApplciation.java
      @Override
      public void onCreate() {
          super.onCreate();
          // Initialize Airbridge SDK
          AirbridgeConfig config = new AirbridgeConfig.Builder("APP_NAME", "APP_TOKEN")
              .setAutoStartTrackingEnabled(false)
              .build();
          Airbridge.init(this, config);
          
          // Set device alias into Airbridge SDK
          Airbridge.setDeviceAlias("braze_device_id", Braze.getInstance(this).getDeviceId());
          // Set user alias into Airbridge SDK
          Airbridge.setUserAlias("braze_external_id", "some-braze-external-id-value");
          
          // Explicitly start tracking
          Airbridge.startTracking();
      }
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="SDK integration (iOS)">
    #### iOS SDK

    <CodeGroup>
      ```swift Swift lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
      // AppDelegate.swift
      func application(
          _ application: UIApplication,
          didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
      ) -> Bool {

          let option = AirbridgeOptionBuilder(name: "YOUR_APP_NAME", token: "YOUR_APP_SDK_TOKEN")
              .setAutoStartTrackingEnabled(false)
              .build()
          Airbridge.initializeSDK(option: option)

          // Set device alias into Airbridge SDK
          if let brazeDeviceID = Appboy.sharedInstance()?.getDeviceId() {
              Airbridge.setDeviceAlias(key: "braze_device_id", value: brazeDeviceID)
          }
          // Set user alias into Airbridge SDK
          Airbridge.setUserAlias(key: "braze_external_id", value: "some-braze-external-id-value")
          
          // Explicitly start tracking
          Airbridge.startTracking()

          return true
      }
      ```

      ```objective-c Objective-C lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
      // AppDelegate.m
      - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
      {
          AirbridgeOptionBuilder* optionBuilder = 
              [[AirbridgeOptionBuilder alloc] initWithName:@"YOUR_APP_NAME"
                                                     token:@"YOUR_APP_SDK_TOKEN"];

          [optionBuilder setAutoStartTrackingEnabled:NO];
          AirbridgeOption* option = [optionBuilder build];
          [Airbridge initializeSDKWithOption:option];

          // Set device alias into Airbridge SDK
          [Airbridge setDeviceAliasWithKey:@"braze_device_id" 
                                     value:Appboy.sharedInstance.getDeviceId];
          // Set user alias into Airbridge SDK
          [Airbridge setUserAliasWithKey:@"braze_external_id" 
                                   value:@"some-braze-external-id-value"];
          
          // Explicitly start tracking
          [Airbridge startTracking];

          return YES;
      }
      ```
    </CodeGroup>

    #### iOS SDK (Deprecated)

    <CodeGroup>
      ```swift Swift lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
      // AppDelegate.swift
      func application(
          _ application: UIApplication,
          didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
      ) -> Bool {
        
          AirBridge.setAutoStartTrackingEnabled(false)
          AirBridge.getInstance("YOUR_APP_TOKEN", appName:"YOUR_APP_NAME", withLaunchOptions:launchOptions)

          // Set device alias into Airbridge SDK
          if let brazeDeviceID = Appboy.sharedInstance()?.getDeviceId() {
            AirBridge.state()?.setDeviceAlias(key: "braze_device_id", value: brazeDeviceID)
          }
          // Set user alias into Airbridge SDK
          AirBridge.state()?.setUserAlias(key: "braze_external_id", value: "some-braze-external-id-value")

          // Explicitly start tracking
          AirBridge.startTracking()

          return true
      }
      ```

      ```objective-c Objective-C lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
      // AppDelegate.m
      - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
      {
          AirBridge.autoStartTrackingEnabled = NO;
          [AirBridge getInstance:@"YOUR_APP_SDK_TOKEN"
                         appName:@"YOUR_APP_NAME"
               withLaunchOptions:launchOptions];

          // Set device alias into Airbridge SDK
          [AirBridge.state setDeviceAliasWithKey: @"braze_device_id"
                                           value: Appboy.sharedInstance.getDeviceId];
          // Set user alias into Airbridge SDK
          [AirBridge.state setUserAliasWithKey:@"braze_external_id" 
                                         value:@"some-braze-external-id-value"];
                                         
          // Explicitly start tracking
          [AirBridge startTracking];

          return YES;
      }
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="SDK integration (React Native)">
    #### React Native SDK

    Set `autoStartTrackingEnabled` to `false` in the [airbridge.json](/en/developers/react-native-sdk-v4#configure-sdk-settings).

    ```typescript lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
    Braze.getInstallTrackingId(function (error, brazeID) {
        // Set device alias into Airbridge SDK
        Airbridge.setDeviceAlias("braze_device_id", brazeID)
        // Set user alias into Airbridge SDK
        Airbridge.setUserAlias("braze_external_id", "some-braze-external-id-value")

        // Explicitly start tracking
        Airbridge.startTracking()
    })
    ```

    #### React Native SDK (Deprecated)

    Set `autoStartTrackingEnabled` to `false` in the [airbridge.json](/en/developers/deprecated-react-native-sdk-v2#airbridge-json).

    ```typescript lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
    Braze.getInstallTrackingId(function (error, brazeID) {
        // Set device alias into Airbridge SDK
        Airbridge.state.setDeviceAlias("braze_device_id", brazeID)
        // Set user alias into Airbridge SDK
        Airbridge.state.setUserAlias("braze_external_id", "some-braze-external-id-value")

        // Explicitly start tracking
        Airbridge.state.startTracking()
    })
    ```
  </Accordion>

  <Accordion title="SDK integration (Cordova)">
    Set `autoStartTrackingEnabled` to `false` in the [airbridge.json](/en/developers/deprecated-cordova-ionic-sdk-v2#airbridge-json).

    ```typescript lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
    AppboyPlugin.getDeviceId(function (brazeID) {
        // Set device alias into Airbridge SDK
        Airbridge.state.setDeviceAlias("braze_device_id", brazeID)
        // Set user alias into Airbridge SDK
        Airbridge.state.setUserAlias("braze_external_id", "some-braze-external-id-value")
     
        // Explicitly start tracking
        Airbridge.state.startTracking()
    })
    ```
  </Accordion>

  <Accordion title="SDK integration (Flutter)">
    #### Flutter SDK

    Set `autoStartTrackingEnabled` to `false` in the [airbridge.json](/en/developers/flutter-sdk-v4#configure-sdk-settings).

    ```javascript lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
    BrazePlugin.getInstallTrackingId().then((brazeID) {
        // Set device alias into Airbridge SDK
        Airbridge.setDeviceAlias("braze_device_id", brazeID)
        // Set user alias into Airbridge SDK
        Airbridge.setUserAlias("braze_external_id", "some-braze-external-id-value")
     
        // Explicitly start tracking
        Airbridge.startTracking()
    })
    ```

    #### Flutter SDK (Deprecated)

    Set `autoStartTrackingEnabled` to `false` in the [airbridge.json](/en/developers/deprecated-flutter-sdk-v3#airbridge-json).

    ```javascript lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
    BrazePlugin.getInstallTrackingId().then((brazeID) {
        // Set device alias into Airbridge SDK
        Airbridge.state.setDeviceAlias("braze_device_id", brazeID)
        // Set user alias into Airbridge SDK
        Airbridge.state.setUserAlias("braze_external_id", "some-braze-external-id-value")
     
        // Explicitly start tracking
        Airbridge.state.startTracking()
    })
    ```
  </Accordion>

  <Accordion title="SDK integration (Unity)">
    #### Unity SDK

    Set `Auto Start Tracking Enabled` to `false` in the [project settings](/en/developers/unity-sdk-v4#configure-sdk-settings).

    ```c# lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
    string BrazeID = AppboyBinding.GetInstallTrackingId();

    // Set device alias into Airbridge SDK
    Airbridge.SetDeviceAlias("braze_device_id", BrazeID);
    // Set user alias into Airbridge SDK
    Airbridge.SetUserAlias("braze_external_id", "some-braze-external-id-value");

    // Explicitly start tracking
    Airbridge.StartTracking();
    ```

    #### Unity SDK (Deprecated)

    Set `Auto Start Tracking Enabled` to `false` in the [project settings](/en/developers/deprecated-unity-sdk-v1#set-up-project).

    ```c# lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
    string BrazeID = AppboyBinding.GetInstallTrackingId();

    // Set device alias into Airbridge SDK
    AirbridgeUnity.SetDeviceAlias("braze_device_id", BrazeID);
    // Set user alias into Airbridge SDK
    AirbridgeUnity.SetUserAlias("braze_external_id", "some-braze-external-id-value");

    // Explicitly start tracking
    AirbridgeUnity.StartTracking();
    ```
  </Accordion>
</AccordionGroup>

### Airbridge dashboard setup

The Airbridge dashboard setup must be completed to implement the integration. For detailed instructions, refer to the user guide below.

* [Amplitude Integration User Guide](/en/guides/braze)

<link rel="alternate" hrefLang="en" href="https://help.airbridge.io/en/developers/braze" />

<link rel="alternate" hrefLang="ko" href="https://help.airbridge.io/ko/developers/braze" />