Developer Guide
SDK Integration

React Native SDK

Last updated March 27, 2024

SDK Installation

Package Installation

npm

Install airbridge-react-native-sdk using npm.

1
npm install --save airbridge-react-native-sdk

React-native link or CocoaPods

Execute the following command.

12
cd ios
pod install

Project Setup

Import

Add the following code to the index.js file of the project to import the Airbridge SDK.

1
import Airbridge from 'airbridge-react-native-sdk';

Project Setup (Android)

MainApplication.java

Add the following code to the onCreate function within the android/app/src/main/java/.../MainApplication.java file.

12345678910
import co.ab180.airbridge.reactnative.AirbridgeRN;

//...

@Override
public void onCreate() {
    super.onCreate();
    AirbridgeRN.init(this, "YOUR_APP_NAME", "YOUR_APP_TOKEN");
    ...
}

APP_NAME can be found at the "Airbridge dashboard → Settings → Tokens → App Name". APP_TOKEN can be found at the "Airbridge dashboard → Settings → Tokens → App SDK Token".

Project Setup (iOS)

AppDelegate.m

Add the following code to the import section of the ios/[Project Name]/AppDelegate.m file.

1
#import <AirbridgeRN/AirbridgeRN.h>

Attention
Use a bridge header if you are using Swift.

Add the following code to the application:idFinishLaunchingWithOptions: function within the ios/[Project Name]/AppDelegate.m file.

1234
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    [AirbridgeRN getInstance:@"YOUR_APP_TOKEN" appName:@"YOUR_APP_NAME" withLaunchOptions:launchOptions];
    ...
}

123
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    AirbridgeRN.getInstance("YOUR_APP_TOKEN", appName:"YOUR_APP_NAME", withLaunchOptions:launchOptions)
}

APP_NAME can be found at the "Airbridge dashboard → Settings → Tokens → App Name". APP_TOKEN can be found at the "Airbridge dashboard → Settings → Tokens → App SDK Token".

React Native Settings

`airbridge.json`

Create an airbridge.jsonfile in the project folder.
Configure settings in JSON format.

When using React Native 0.59.X or lower with iOS, the below setup is needed for iOS.

1. Go to "Xcode → Project file → Build Phases → Copy Bundle Resources".

2. Click "+" and add airbridge.json file.

Example

12345678910111213
{
    "sessionTimeoutSeconds": 300,
    "autoStartTrackingEnabled": true,
    "userInfoHashEnabled": true,
    "trackAirbridgeLinkOnly": false,
    "facebookDeferredAppLinkEnabled": false,
    "metaInstallReferrer": "YOUR_META_APP_ID",
    "sdkSignatureSecretID": "YOUR_SDK_SIGNATURE_SECRET_ID",
    "sdkSignatureSecret": "YOUR_SDK_SIGNATURE_SECRET",
    "locationCollectionEnabled": false,
    "trackingAuthorizeTimeoutSeconds": 30,
    "logLevel": "warning"
}

Attention
trackingAuthorizeTimeoutSeconds in the above code is the default value. Please adjust accordingly depending on your user experience and ATT prompt settings. Please refer to Tracking Authorize Timeout Settings for more details.

Name	Type	Default	Description
sessionTimeoutSeconds	Number	300	An app open event will not be sent when the app is reopened within the designated period.
autoStartTrackingEnabled	Boolean	true	When set to false, no events will be sent until `Airbridge.state.startTracking()` is called.
userInfoHashEnabled	Boolean	true	When set to false, user email and user phone information are sent without being hashed.
trackAirbridgeLinkOnly	Boolean	false	When set to true, deep link events are sent only when app is opened with an Airbridge deep link.
facebookDeferredAppLinkEnabled	Boolean	false	When set to true and the Facebook SDK is installed, Facebook Deferred App Link data is collected.
locationCollectionEnabled	Boolean	false	When set to true, location information is collected. (Android Only) Two permissions must be allowed in AndroidManifest.xml android.permission.ACCESS_FINE_LOCATION android.permission.ACCESS_COARSE_LOCATION
trackingAuthorizeTimeoutSeconds	Number	0	When timeout is set, Install event is delayed until `Request tracking authorization alert` is clicked. (iOS only)
sdkSignatureSecretID	String	null	Protects against SDK spoofing. Both sdkSignatureSecretID and sdkSignatureSecret values must be applied.
sdkSignatureSecret	String	null	Protects against SDK spoofing. Both sdkSignatureSecretID and sdkSignatureSecret values must be applied.
logLevel	String	Warning	Adjusts the log record level for Airbridge. logLevel: "debug" \| "info" \| "warning" \| "error" \| "fault"

Testing the SDK

Check if install events are sent when the application is installed and opened.

Check in the Airbridge Dashboard

Events from the Airbridge SDK are shown at the "Airbridge Dashboard → Raw Data → App Real-time Logs".

Go to the "Airbridge Dashboard → Raw Data → App Real-time Logs".
Search for the device's ADID (IDFA, IDFV, GAID).

Logs may be delayed for up to 5 minutes.

Deep Link Setup

Dashboard Setup

Please refer to the following guides for setting up deep links in the Airbridge dashboard.

Project Setup

setDeeplinkListener

123456
Airbridge.deeplink.setDeeplinkListener((deeplink) => {
    // code that will run when a deep link or deferred deep link occurs
    // deeplink = YOUR_SCHEME://...

    console.log(deeplink);
});

All deep links that open apps are sent to DeeplinkCallback Of those deep links, "Airbridge deep links" will be sent using the URI Scheme (YOUR_SCHEME://...) that was set in the Airbridge dashboard.

Project Setup (Android)

AndroidManifest.xml

In the MainActivity section of the android/app/src/main/AndroidManifest.xml file, add android:LaunchMode and intent-filter parameters as below.

12345678910111213141516171819202122232425262728293031
<activity android:name=".MainActivity"
    android:launchMode="singleTask"
    ...>
    <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />

        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />

        <data android:scheme="http" android:host="YOUR_APP_NAME.deeplink.page" />
        <data android:scheme="https" android:host="YOUR_APP_NAME.deeplink.page" />
    </intent-filter>
    <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />

        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />

        <data android:scheme="http" android:host="YOUR_APP_NAME.airbridge.io" />
        <data android:scheme="https" android:host="YOUR_APP_NAME.airbridge.io" />
    </intent-filter>
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />

        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />

        <data android:scheme="YOUR_SCHEME" />
    </intent-filter>
    ...
<activity/>

Enter your app name at APP_NAME.
Enter your scheme value set in the Airbridge dashboard at YOUR_SCHEME. (e.g. abc://)

MainActivity.java

Insert the following code in the android/app/src/main/java/.../MainActivity.java file.

123456789101112
@Override
protected void onResume() {
    super.onResume();

    AirbridgeRN.processDeeplinkData(getIntent());
}

@Override
public void onNewIntent(Intent intent) {
    super.onNewIntent(intent);
    setIntent(intent);
}

Project Setup (iOS)

Scheme

Go to "Xcode → Project file → Info → URL Types".
From the Airbridge dashboard, copy "iOS URI Scheme" to Xcode's "URL Schemes". (Do not include://)

Universal Link

Go to "Xcode → Project file → Signing & Capabilities".
Click "+ Capability" and add "Associated Domains".
Add applinks:YOUR_APP_NAME.airbridge.ioto "Associated Domains".
Add applinks:YOUR_APP_NAME.deeplink.pageto "Associated Domains".

YOUR_APP_NAME can be found at the "Airbridge dashboard → Settings → Tokens → App Name".
Please refer to Troubleshooting → Webcredentials if you want to use the autofill feature.

Send Deep Link Information to SDK

1. Open ios/[Project name]/AppDelegate.

2. Send deeplink information to the SDK when the application is opened through schemes by calling the handleURLSchemeDeeplinkmethod at the beginning of the following function.

12345678910
- (BOOL)application:(UIApplication *)application
            openURL:(NSURL *)url
            options:(NSDictionary<UIApplicationOpenURLOptionsKey, id>*)options
{
    NSLog(@"openURL : %@", url);

    [AirbridgeRN.deeplink handleURLSchemeDeeplink:url];

    return YES;
}

12345678910
func application(_ app: UIApplication,
                 open url: URL,
                 options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool
{
    NSLog(@"openURL : %@", url)

    AirbridgeRN.deeplink()?.handleURLSchemeDeeplink(url)
    
    return true
}

3. When targeting iOS 8.x or earlier, also call the handleURLSchemeDeeplinkmethod at the beginning of the following function.

1234567891011
- (BOOL)application:(UIApplication*)application
            openURL:(NSURL*)url
  sourceApplication:(NSString*)sourceApplication 
         annotation:(id)annotation
{
    NSLog(@"openURL : %@", url);

    [AirbridgeRN.deeplink handleURLSchemeDeeplink:url];

    return YES;
}

1234567891011
func application(_ application: UIApplication,
                 open url: URL,
                 sourceApplication: String?,
                 annotation: Any) -> Bool
{
    NSLog(@"openURL : %@", url)

    AirbridgeRN.deeplink()?.handleURLSchemeDeeplink(url);
    
    return true;
}

4. Send deep link information to the SDK when the application is opened through an universal link by calling the handleUniversalLinkmethod at the beginning of the following function.

12345678910
-  (BOOL)application:(UIApplication*)application
continueUserActivity:(NSUserActivity*)userActivity
  restorationHandler:(void (^)(NSArray* _Nullable))restorationHandler
{
    NSLog(@"continueUserActivity : %@", userActivity.webpageURL);

    [AirbridgeRN.deeplink handleUniversalLink:userActivity.webpageURL];

    return YES;
}

123456789101112
func application(_ application: UIApplication,
                 continue userActivity: NSUserActivity,
                 restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool
{
    if let webpageURL = userActivity.webpageURL {
        NSLog("continueUserActivity : %@", webpageURL)
      
        AirbridgeRN.deeplink()?.handleUniversalLink(webpageURL)
    }
    
    return true
}

Custom Domain Setup (Optional)

Please refer to the below guides to setup your custom domain with Airbridge.

iOS: Guide

Android: Guide

Test Deep Link

Click on your URI scheme to test if your deep link has been properly set up in the Airbridge SDK.

YOUR_APP_URI_SCHEME://

The results will show on the "Airbridge dashboard → Row Data → App Real-time Log" tab if everything is working.

User Setup

User Identifier Setup

Once a user identifier information is sent to the SDK, all events thereafter will contain the corresponding user identifier information.

Name	Description	Limitations
ID	User ID	-
email	User Email	Hashed by default (SHA256, can be disabled)
phone	User phone number	Hashed by default (SHA256, can be disabled)
attributes	User attributes	- Maximum 100 attributes - "key" type is string, maximum 128 characters - "key" must satisfy `^[a-z_][a-z0-9_]*$`regex - "value" type is primitive or string - Maximum 1024 characters when "value" is string
alias	Another User ID	- Maximum 10 aliases -`"key"`type is String, maximum 128 characters -`"key"`must satisfy `^[a-z_][a-z0-9_]*$`regex - `"value" type is String, maximum 1024 characters

Example

12345678910111213
Airbridge.state.setUser({
    ID: 'persondoe1',
    email: 'persondoe1@example.com',
});

Airbridge.state.setUser({
    email: 'persondoe2@example.com',
    phone: '+14151231234',
});

Airbridge.state.updateUser({
    ID: 'persondoe3',
});

The above code operates in the following order.

User = { ID: 'personID1', email: 'persondoe1@airbridge.io' }
User = { ID: 'personID1', email: 'persondoe1@airbridge.io', phone: '1(123)123-1234' }
User = { ID: 'personID3', email: 'persondoe2@airbridge.io', phone: '1(123)123-1234)' }

User Attribute Setup

Additional user attributes can be set for various purposes such as MTA (Multi-Touch Attribution) analysis, internal data analysis and 3rd party solution integrations.

123456
Airbridge.state.updateUser({
    attributes: {
      age_group: "30",
      gender: "Female"
    }
});

Testing

Make sure that your user information settings are being properly sent through the SDK.

Configure user identifier information.
Send an event using the SDK.
Click the event at "Airbridge dashboard → Raw Data → App Real-time Logs"
Check if the user information is correctly sent under the userblock.

Device Setup

Setup Device Alias

Setup a device alias through the Airbridge SDK. The alias will be sustained even after the app closes, unless otherwise deleted.

123
Airbridge.setDeviceAlias("ADD_YOUR_KEY", "AND_YOUR_VALUE");
Airbridge.removeDeviceAlias("DELETE_THIS_KEY");
Airbridge.clearDeviceAlias();

`setDeviceAlias(key: string, value: string)`	Add the key value pair to the device identifier.
`removeDeviceAlias(key: string)`	Delete the corresponding device alias.
`clearDeviceAlias()`	Delete all device aliases.

Event Setup

When important user actions occur, in-app events can be sent to measure the performance of each channel.

All event parameters are optional. However, more information about the event will help provide a more accurate analysis.

action, label, value, customAttributes and semanticAttributes can be used for event options.

123456
/**
 * Send event to server.
 * @param {string} category event name
 * @param {EventOption} [option={}] event options
 */
trackEvent(category: string, option?: EventOption): void;

User Events

Send user events with the SDK.

action, label, value, customAttributes and semanticAttributes can be used for user events.

User identifiers are set with setUser and then sent with AirbridgeCategory.SIGN_UP for user sign ups.

123456
Airbridge.state.setUser({
    ID: 'test',
    email: 'test@ab180.co',
    phone: '000-0000-0000',
});
Airbridge.trackEvent(AirbridgeCategory.SIGN_UP);

User identifiers are set with setUser and then sent with AirbridgeCategory.SIGN_IN for user logins.

123456
Airbridge.state.setUser({
    ID: 'test',
    email: 'test@ab180.co',
    phone: '000-0000-0000',
});
Airbridge.trackEvent(AirbridgeCategory.SIGN_IN);

Sign Out

Send the sign out event with AirbridgeCategory.SIGN_OUT, and then reset the user identifiers with Airbridge.state.setUser({}).

12
Airbridge.trackEvent(AirbridgeCategory.SIGN_OUT);
Airbridge.state.setUser({});

E-commerce Events

Send e-commerce events with the SDK.

action, label, value, customAttributes and semanticAttributes can be used for e-commerce events.
It is possible to include product information using semanticAttributes. Custom key values can be used along with the pre-defined values.

View Home Screen

1
Airbridge.trackEvent(AirbridgeCategory.HOME_VIEW);

View Product Detail

1234567891011121314
Airbridge.trackEvent(AirbridgeCategory.PRODUCT_DETAILS_VIEW, {
    semanticAttributes: {
        [AirbridgeAttributes.PRODUCTS]: [
            {
                [AirbridgeProduct.PRODUCT_ID]: 'coke_zero',
                [AirbridgeProduct.NAME]: 'Coke Zero',
                [AirbridgeProduct.PRICE]: 1.99,
                [AirbridgeProduct.CURRENCY]: 'USD',
                [AirbridgeProduct.POSITION]: 1,
                [AirbridgeProduct.QUANTITY]: 1,
            },
        ]
    }
});

View Product List

1234567891011121314151617181920212223
Airbridge.trackEvent(AirbridgeCategory.PRODUCT_LIST_VIEW, {
    semanticAttributes: {
        [AirbridgeAttributes.PRODUCT_LIST_ID]: 'ID-1234567890'
        [AirbridgeAttributes.PRODUCTS]: [
            {
                [AirbridgeProduct.PRODUCT_ID]: 'coke_zero',
                [AirbridgeProduct.NAME]: 'Coke Zero',
                [AirbridgeProduct.PRICE]: 1.99,
                [AirbridgeProduct.CURRENCY]: 'USD',
                [AirbridgeProduct.POSITION]: 1,
                [AirbridgeProduct.QUANTITY]: 1,
            },
            {
                [AirbridgeProduct.PRODUCT_ID]: 'burger_cheese_double',
                [AirbridgeProduct.NAME]: 'Double Cheeseburger',
                [AirbridgeProduct.PRICE]: 3.99,
                [AirbridgeProduct.CURRENCY]: 'USD',
                [AirbridgeProduct.POSITION]: 2,
                [AirbridgeProduct.QUANTITY]: 1,
            },
        ]
    }
});

View Search Result

1234567891011121314151617181920212223
Airbridge.trackEvent(AirbridgeCategory.SEARCH_RESULT_VIEW, {
    semanticAttributes: {
        [AirbridgeAttributes.QUERY]: 'product'
        [AirbridgeAttributes.PRODUCTS]: [
            {
                [AirbridgeProduct.PRODUCT_ID]: 'coke_zero',
                [AirbridgeProduct.NAME]: 'Coke Zero',
                [AirbridgeProduct.PRICE]: 1.99,
                [AirbridgeProduct.CURRENCY]: 'USD',
                [AirbridgeProduct.POSITION]: 1,
                [AirbridgeProduct.QUANTITY]: 1,
            },
            {
                [AirbridgeProduct.PRODUCT_ID]: 'burger_cheese_double',
                [AirbridgeProduct.NAME]: 'Double Cheeseburger',
                [AirbridgeProduct.PRICE]: 3.99,
                [AirbridgeProduct.CURRENCY]: 'USD',
                [AirbridgeProduct.POSITION]: 2,
                [AirbridgeProduct.QUANTITY]: 1,
            },
        ]
    }
});

Add to Cart

12345678910111213141516171819202122232425
Airbridge.trackEvent(AirbridgeCategory.ADD_TO_CART, {
    value: 5.98,
    semanticAttributes: {
        [AirbridgeAttributes.CART_ID]: 'ID-1234567890',
        [AirbridgeAttributes.CURRENCY]: 'USD',
        [AirbridgeAttributes.PRODUCTS]: [
            {
                [AirbridgeProduct.PRODUCT_ID]: 'coke_zero',
                [AirbridgeProduct.NAME]: 'Coke Zero',
                [AirbridgeProduct.PRICE]: 1.99,
                [AirbridgeProduct.CURRENCY]: 'USD',
                [AirbridgeProduct.POSITION]: 1,
                [AirbridgeProduct.QUANTITY]: 1,
            },
            {
                [AirbridgeProduct.PRODUCT_ID]: 'burger_cheese_double',
                [AirbridgeProduct.NAME]: 'Double Cheeseburger',
                [AirbridgeProduct.PRICE]: 3.99,
                [AirbridgeProduct.CURRENCY]: 'USD',
                [AirbridgeProduct.POSITION]: 2,
                [AirbridgeProduct.QUANTITY]: 1,
            },
        ]
    }
});

Purchase

1234567891011121314151617181920212223242526
Airbridge.trackEvent(AirbridgeCategory.ORDER_COMPLETED, {
    value: 5.98,
    semanticAttributes: {
        [AirbridgeAttributes.TRANSACTION_ID]: 'transactionID-purchase',
        [AirbridgeAttributes.CURRENCY]: 'USD',
        [AirbridgeAttributes.IN_APP_PURCHASED]: true,
        [AirbridgeAttributes.PRODUCTS]: [
            {
                [AirbridgeProduct.PRODUCT_ID]: 'coke_zero',
                [AirbridgeProduct.NAME]: 'Coke Zero',
                [AirbridgeProduct.PRICE]: 1.99,
                [AirbridgeProduct.CURRENCY]: 'USD',
                [AirbridgeProduct.POSITION]: 1,
                [AirbridgeProduct.QUANTITY]: 1,
            },
            {
                [AirbridgeProduct.PRODUCT_ID]: 'burger_cheese_double',
                [AirbridgeProduct.NAME]: 'Double Cheeseburger',
                [AirbridgeProduct.PRICE]: 3.99,
                [AirbridgeProduct.CURRENCY]: 'USD',
                [AirbridgeProduct.POSITION]: 2,
                [AirbridgeProduct.QUANTITY]: 1,
            },
        ]
    }
});

Verify Event Transmission

Make sure that the events are being properly sent through the SDK.

Send an event with the SDK.
Check if the event shows up at "Airbridge dashboard → Raw Data → Web Real-time Logs".

Advanced Setup

Install Restricted SDK

Restricted SDK does not collect device IDs, including Ad ID. The restricted SDK will be available starting from v2.5.3.

Install using NPM

1
npm install --save airbridge-react-native-sdk-restricted

Install react-native link or CocoaPods

12
cd ios
pod install

Setup Project

Obtain the object in the project's index.js file with the following code.

1
import Airbridge from 'airbridge-react-native-sdk-restricted';

SDK Signature Setup

Protection against SDK spoofing is possible once you set your SDK Signature.
This feature is available for the Airbridge React Native SDK v2.3.0 and above.

Add the following lines in the airbridge.json file.

1234
{
    "sdkSignatureSecretID": "YOUR_SDK_SIGNATURE_SECRET_ID",
    "sdkSignatureSecret": "YOUR_SDK_SIGNATURE_SECRET"
}

Please ask your CSM for the "SDK Signature Secret ID" and "SDK Signature Secret" values.

Session Timeout

Configure the sessionTimeoutSeconds parameter of airbridge.json. App open events will not be sent again if the user re-opens the app within the sessionTimeoutSeconds value.

Session timeout is in milliseconds and must range between 0 and 604800000 (7 days).
Default value is 1000 * 60 * 5 (5 minutes).

Hash User Indentifier

Email addresses and phone numbers are hashed by default. (SHA256)
You can stop hashing email and phone information by configuring the userInfoHashEnabled parameter of airbridge.json.

You must take appropriate measures internally when personal information is not hashed.

Track Facebook Deferred App Links

The Airbridge SDK can track Facebook Deferred App Links by utilizing the facebookDeferredAppLinkEnabled parameter of airbridge.json.

Install the Facebook SDK:
https://developers.facebook.com/docs/ios/getting-started.
Set facebookDeferredAppLinkEnabledof airbridge.json to true.

Attention
The Facebook SDK must be configured beforehand. Reference

Track Airbridge Deep Links Only

The SDK will send all deep link events when the app is opened using a deep link.
If you're having difficulty tracking the re-engagement performance due to various deep link actions within the app, set trackAirbridgeLinkOnly of airbridge.json to true. The SDK will only send deep link events that use Airbridge deep links.

Airbridge deep links are defined as...

Deep links registered on the Airbridge dashboard
airbridge.iodeep links
deeplink.pagedeep links
Contains the airbridge_referrerquery information

Privacy Protection (Opt-Out)

When autoStartTrackingEnabled of airbridge.json is set to false, the Airbridge SDK will not send events to the Airbridge server until the Airbridge.state.startTracking method is called.

This feature is useful for compliances such as GDPR and CCPA.

Tracking Authorize Timeout (iOS only)

When the AppTrackingTransparency.framework is used to present an app-tracking authorization request to the user, IDFA will not be collected when the install event occurs because the install event occurs before the selection.

When trackingAuthorizeTimeoutSeconds of airbridge.json is set to true, the install event will be sent after the timeout period or delayed until an ATT option is selected.

Location Tracking (Android Only)

Track a user's location through the locationCollectionEnabled parameter of the airbridge.json file.

12
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

Attention
Location information must be collected for legal purposes only.

Tracking Link Execution

Use the code below to execute and track deep links in the app.

12
Airbridge.placement.click('https://abr.ge/~~~', 'ablog://main', 'https://airbridge.io');
Airbridge.placement.impression('https://abr.ge/~~~');

click

The click function adds a "click" statistic to the corresponding tracking link, then moves to the pre-set app, web or fallback.
Call the click function when the tracking link is clicked on.

The deep link and fallback are "backup links" used when there is no Internet connection.
Deep link parameters are only available in Custom URL Scheme format.
(All these parameters are optional)

impression

The impression function adds an "impression" statistic to the corresponding tracking link.
Call the impression function when the tracking is displayed.

Attention
If you are using a "custom domain" for your tracking link, it can not be used with a "custom short ID".
example: http://deeplink.customdomain.com/custom -> Not possible
example: http://deeplink.customdomain.co/autogenerated -> Possible
example: https://abr.ge/autogenerated -> Possible

Get deviceUUID

1
await Airbridge.state.deviceUUID()

Uninstall tracking

This feature is available only for React Native SDK v2.1.0+.
Airbridge Android SDK v2.6.0+
Airbridge iOS SDK v1.28.2+

Please refer to this guide for details.

Send Push Token

1
Airbridge.registerPushToken(token);

Forward the push token to Airbridge using the registerPushToken method.
Make sure the notification is not shown on the device if the remote message value is airbridge-uninstall-tracking.

Hybrid App Setup

Additional events such as app installs, app open and deep link opens can't be tracked with just the web SDK. The following simple setup allows in-app events to be called for a hybrid app.

123456
let webInterface = Airbridge.createWebInterface(
        'YOUR_WEB_TOKEN',
        (command) => { 
            return `...`;
        }
    )

Airbridge.CreateWebInterface allows you to control the web interface.
Please refer to the guide below for more information.

React Native Hybrid App Integration Guide

Troubleshooting

Update 1.X.X → 2.X.X

The event API has been replaced to the below.

123456
/**
 * Send event to server.
 * @param {string} category event name
 * @param {EventOption} [option={}] event options
 */
trackEvent(category: string, option?: EventOption): void;

Refer to the React native 2.X.X migration guide for details.

Bitcode Compile Error

An error like below may occur when creating iOS builds with React Native SDK v1.5.0+.

1
ld: XCFrameworkIntermediates/AirBridge/AirBridge.framework/AirBridge(AirBridge-arm64-master.o)' does not contain bitcode. You must rebuild it with bitcode enabled (Xcode setting ENABLE_BITCODE)

Since React Native SDK v1.5.0+ uses Airbridge iOS SDK v1.28.0+, Bitcode is no longer supported. Please refer to the Bitcode compile error guide for more details.

Update 1.1.X → 1.2.X

npm

Change version of Airbridge React Native SDK in package.json.

123
...
    "airbridge-react-native-sdk": "1.2.1",
...

Execute the following command.

123
npm install
cd ios
pod install

Android

Modify android/app/src/main/java/.../MainActivity

12
-     AirbridgeRN.deeplink()?.handleURLSchemeDeeplink(url, withSourceBundle: sourceApplication)
+     AirbridgeRN.deeplink()?.handleURLSchemeDeeplink(url)

iOS

Modify ios/[Project Name]/AppDelegate

12
-     AirbridgeRN.deeplink()?.handleURLSchemeDeeplink(url, withSourceBundle: sourceApplication)
+     AirbridgeRN.deeplink()?.handleURLSchemeDeeplink(url)

Settings

Add an airbridge.jsonfile to the project folder.
Add the parameters shown in the example below in JSON format.

12345678
{
    "sessionTimeoutSeconds": 300,
    "autoStartTrackingEnabled": true,
    "userInfoHashEnabled": true,
    "trackAirbridgeLinkOnly": false,
    "facebookDeferredAppLinkEnabled": false,
    "locationCollectionEnabled": false
}

Description

Name	Type	Default	Description
sessionTimeoutSeconds	number	300	An app open event will not be sent when the app is reopened within the designated period.
autoStartTrackingEnabled	boolean	true	When set to false, no events will be sent until `airbridge.state.startTracking()` is called.
userInfoHashEnabled	boolean	true	When set to false, user email and user phone information are sent without being hashed.
trackAirbridgeLinkOnly	boolean	false	When set to true, deep link events are sent only when app is opened with an Airbridge deep link.
facebookDeferredAppLinkEnabled	boolean	false	When set to true and the Facebook SDK is installed, Facebook Deferred App Link data is collected.
locationCollectionEnabled	boolean	false	When set to true, location information is collected. (Android Only) Two permissions must be allowed in `AndroidManifest.xml`android.permission.ACCESS_FINE_LOCATION android.permission.ACCESS_COARSE_LOCATION
trackingAuthorizeTimeoutSeconds	number	0	When set timeout, Install event is delayed until Request tracking authorization alert is clicked. (iOS only)

Update 1.0.X → 1.1.X

Installation

Uninstall the old version of the Airbridge SDK.

1
npm uninstall react-native-airbridge-bridge

Install the new version of the Airbridge SDK.

1
npm install --save airbridge-react-native-sdk

After Installation, execute the following command.

12
cd ios
pod install

setDeeplinkListener

Remove the getInitialDeeplink function and use the setDeeplinkListener function only.

1234567
- Airbridge.deeplink.getInitialDeeplink().then((deeplink) => {
-
- });
. 
. Airbridge.deeplink.setDeeplinkListner((deeplink) => {
. 
. });

Android

AndroidManifest.xml

In the MainActivity section of the android/app/src/main/AndroidManifest.xml file, add intent-filter parameters as below.

1234567891011121314151617181920212223242526
+ <intent-filter android:autoVerify="true">
+     <action android:name="android.intent.action.VIEW" />
+
+     <category android:name="android.intent.category.DEFAULT" />
+     <category android:name="android.intent.category.BROWSABLE" />
+
+     <data android:scheme="http" android:host="YOUR_APP_NAME.deeplink.page" />
+     <data android:scheme="https" android:host="YOUR_APP_NAME.deeplink.page" />
+ </intent-filter>
. <intent-filter android:autoVerify="true">
.     <action android:name="android.intent.action.VIEW" />
. 
.     <category android:name="android.intent.category.DEFAULT" />
.     <category android:name="android.intent.category.BROWSABLE" />
. 
.     <data android:scheme="http" android:host="YOUR_APP_NAME.airbridge.io" />
.     <data android:scheme="https" android:host="YOUR_APP_NAME.airbridge.io" />
. </intent-filter>
. <intent-filter>
.     <action android:name="android.intent.action.VIEW" />
. 
.     <category android:name="android.intent.category.DEFAULT" />
.     <category android:name="android.intent.category.BROWSABLE" />
. 
.     <data android:scheme="EXAMPLE_SCHEME" />
. </intent-filter>

MainActivity.java

Modify android/app/src/main/java/.../MainActivity.java as below.

12345678910111213141516
. import co.ab180.airbridge.reactnative.AirbridgeRN;
. 
. public class MainActivity extends ReactActivity {
+     @Override
+     protected void onResume() {
+         super.onResume();
+ 
+         AirbridgeRN.getDeeplink().fetch(getIntent());
+     }
+  
.     @Override
.     public void onNewIntent(Intent intent) {
.         super.onNewIntent(intent);
.         setIntent(intent);
.     }
. }

iOS

Universal Link

Go to "Xcode → Project file → Signing & Capabilities".
Click "+ Capability" and add "Associated Domains".
Add applinks:YOUR_APP_NAME.deeplink.pageto "Associated Domains"

YOUR_APP_NAME can be found at the "Airbridge dashboard → Settings → Tokens → App Name".

AppDelegate.m`

Modify ios/.../AppDelegate.m as below.

123456789101112131415161718192021222324
. - (BOOL)application:(UIApplication *)application
.             openURL:(NSURL *)url
.             options:(NSDictionary<UIApplicationOpenURLOptionsKey, id>*)options
. {
-     [AirbridgeRN.instance handleURLSchemeDeeplink:url
-                                withSourceBundle:options[UIApplicationOpenURLOptionsSourceApplicationKey]];
+     [AirbridgeRN.deeplink handleURLSchemeDeeplink:url
+                                withSourceBundle:options[UIApplicationOpenURLOptionsSourceApplicationKey]];
. 
.     return YES;
. }
. 
. - (BOOL)application:(UIApplication*)application
.             openURL:(NSURL*)url
.   sourceApplication:(NSString*)sourceApplication 
.          annotation:(id)annotation
. {
-     [AirbridgeRN.instance handleURLSchemeDeeplink:url
-                                withSourceBundle:sourceApplication];
+     [AirbridgeRN.deeplink handleURLSchemeDeeplink:url
+                                withSourceBundle:sourceApplication];
. 
.     return YES;
. }

When targeting iOS 8.x or earlier, also make the following changes.

123456789
. -  (BOOL)application:(UIApplication*)application
. continueUserActivity:(NSUserActivity*)userActivity
.   restorationHandler:(void (^)(NSArray* _Nullable))restorationHandler
. {
-     [AirbridgeRN.instance handleUniversalDeeplink:userActivity.webpageURL];
+     [AirbridgeRN.deeplink handleUniversalLink:userActivity.webpageURL];
. 
.     return YES;
. }

Update 0.2.X → 1.X.X

Reinstalling the Airbridge SDK

Unlink the old version of the SDK.

1
react-native unlink react-native-airbridge-bridge

Follow the steps below when an error occurs with react-native unlink react-native-airbridge-bridge

(Android) Modify android/app/src/main/java/.../MainApplication.javaas below.

1
- import com.reactlibrary.AirbridgeBridgePackage;

12345678
. @Override
. protected List<ReactPackage> getPackages() {
.     return Arrays.<ReactPackage>asList(
+         new MainReactPackage()
-         new MainReactPackage(),
-         new AirbridgeBridgePackage()
.     );
. }

2. (iOS) Open ios/xxx.xcodeproj.

3. (iOS) Remove AirbridgeBridge.xcodeprojin Libraries

Uninstall the old version of the SDK.

1
npm uninstall react-native-airbridge-bridge

Install the new version of the SDK.

1
npm install --save airbridge-react-native-sdk

Link the new version of the SDK.

1
react-native link airbridge-react-native-sdk

index.js

Modify index.js as below.

12
- const Airbridge = require('react-native-airbridge-bridge');
+ import Airbridge from 'airbridge-react-native-sdk';

build.gradle (Android)

Modify android/app/build.gradle as below.

123456
. dependencies {
.     ...
-     implementation 'io.airbridge:sdk-android:1.5.+'
-     implementation 'com.android.installreferrer:installreferrer:1.0'
.     ...
. }

AndroidManifest.xml (Android)

Modify android/app/src/main/AndroidManifest.xml as below.

permission (Android)

12
-     <uses-permission android:name="android.permission.INTERNET" />
-     <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

MainActivity

123
.     <activity android:name=".MainActivity"
          ...
+         android:launchMode="singleTask">

MainApplication.java (Android)

Modify android/app/src/main/java/.../MainApplication.java as below.

1
- import io.airbridge.*;

1234567
. @Override
. public void onCreate() {
.     super.onCreate();
-     AirBridge.init(this, "[앱 이름]", "[앱 토큰]");
+     AirbridgeRN.init(this, "[앱 이름]", "[앱 토큰]");
.     ...
. }

MainActivity.java (Android)

Modify android/app/src/main/java/.../MainActivity.java as below.

123456789
+ import co.ab180.airbridge.reactnative.AirbridgeRN;

+ public class MainActivity extends ReactActivity {
+   @Override
+   public void onNewIntent(Intent intent) {
+       super.onNewIntent(intent);
+       setIntent(intent);
+   }
+ }

Podfile (iOS)

Modify ios/Podfile as below.

123
target '[Project Name]' do
-   pod 'AirBridge', '1.6.2'
end

Run the command below in terminal.

1
pod install

AppDelegate.m

(iOS)

Modify ios/.../AppDelegate.m as below.

12
- #import <AirBridge/AirBridge.h>
+ #import <AirbridgeRN/AirbridgeRN.h>

1234567
.           - (BOOL)application:(UIApplication *)application 
. didFinishLaunchingWithOptions:(NSDictionary *)launchOptions 
. {
-     [AirBridge getInstance:@"YOUR_APP_TOKEN(앱 토큰)" appName:@"YOUR_APP_NAME(앱 이름)" withLaunchOptions:launchOptions];
+     [AirbridgeRN getInstance:@"YOUR_APP_TOKEN(앱 토큰)" appName:@"YOUR_APP_NAME(앱 이름)" withLaunchOptions:launchOptions];
.     ...
. }

123456789
. - (BOOL)application:(UIApplication *)application
.             openURL:(NSURL *)url
.             options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options
. {
-     [[AirBridge instance] handleURL:url];
+     [AirbridgeRN.instance handleURLSchemeDeeplink:url withSourceBundle:options[UIApplicationOpenURLOptionsSourceApplicationKey]];.
.
.     return YES;
. }

12345678910
. - (BOOL)application:(UIApplication *)application 
.             openURL:(NSURL *)url
.   sourceApplication:(NSString *)sourceApplication 
.          annotation:(id)annotation
. {
-     [[AirBridge instance] handleURL:url];
+     [AirbridgeRN.instance handleURLSchemeDeeplink:url withSourceBundle:options[UIApplicationOpenURLOptionsSourceApplicationKey]];
. 
.     return YES;
. }

When targeting iOS 8.x or earlier, also make the following changes.

123456789
.   - (BOOL)application:(UIApplication *)application 
.  continueUserActivity:(NSUserActivity *)userActivity
.    restorationHandler:(void (^)(NSArray * _Nullable))restorationHandler
. {
-     [[AirBridge instance] handleURL:url];
+     [AirbridgeRN.instance handleUniversalDeeplink:userActivity.webpageURL];
. 
.     return YES;
. }

Was this page helpful?

Have any questions or suggestions?

React Native SDKself.__wrap_n!=1&&self.__wrap_b(":R96fnkv79uuba:",0.5)

SDK Installation

Package Installation

Project Setup

Import

Project Setup (Android)

Project Setup (iOS)

Attention

React Native Settings

airbridge.json

Attention

Testing the SDK

Deep Link Setup

Dashboard Setup

Project Setup

Project Setup (Android)

Project Setup (iOS)

Universal Link

Custom Domain Setup (Optional)

Test Deep Link

User Setup

User Identifier Setup

User Attribute Setup

Testing

Device Setup

Setup Device Alias

Event Setup

User Events

Sign In

E-commerce Events

Verify Event Transmission

Advanced Setup

Install Restricted SDK

Install using NPM

Install react-native link or CocoaPods

Setup Project

SDK Signature Setup

Session Timeout

Hash User Indentifier

Track Facebook Deferred App Links

Attention

Track Airbridge Deep Links Only

Privacy Protection (Opt-Out)

Tracking Authorize Timeout (iOS only)

Location Tracking (Android Only)

Attention

Tracking Link Execution

Attention

Get deviceUUID

Uninstall tracking

Hybrid App Setup

Troubleshooting

Update 1.X.X → 2.X.X

Bitcode Compile Error

Update 1.1.X → 1.2.X

Update 1.0.X → 1.1.X

Update 0.2.X → 1.X.X

React Native SDK

`airbridge.json`