Expo SDK
Note
This is a guide for installing and setting up the Expo SDK v4. For previous versions, refer to the Expo SDK (Previous) guide.
Install the Airbridge Expo SDK and implement the necessary settings following the steps below.
The Airbridge Unreal SDK can be installed using the method below. After installation, you can confirm whether the SDK has been properly installed through the Expo SDK Test.
Use npm to install airbridge-expo-sdk and airbridge-react-native-sdk.
npm install --save airbridge-expo-sdk
npm install --save airbridge-react-native-sdkAdd the following code to the app.json.
{
"expo": {
...
"plugins": [
...
[
"airbridge-expo-sdk",
{
"appName": "APP_NAME",
"appToken": "APP_TOKEN"
}
]
]
}
}
APP_NAMEis the App Name andAPP_TOKENis the App SDK Token that can be found on the [Settings]>[Tokens] page in the Airbridge dashboard.
Configure the SDK settings to use the Airbridge Expo SDK.
{
"sdkEnabled": boolean,
"logLevel": "debug" | "info" | "warning" | "error" | "fault",
"autoStartTrackingEnabled": boolean,
"autoDetermineTrackingAuthorizationTimeoutInSecond": number,
"trackMetaDeferredAppLinkEnabled": boolean,
"sessionTimeoutInSecond": number,
"metaInstallReferrerAppID": string,
"trackAirbridgeDeeplinkOnlyEnabled": boolean,
"trackingLinkCustomDomains": [string],
"hashUserInformationEnabled": boolean,
"sdkSignatureID": string,
"sdkSignatureSecret": string,
"clearEventBufferOnInitializeEnabled": boolean,
"eventBufferCountLimit": number,
"eventBufferSizeLimitInGibibyte": number,
"eventTransmitIntervalInSecond": number,
"isHandleAirbridgeDeeplinkOnly": boolean,
"collectTCFDataEnabled": boolean,
"trackingBlocklist": [string],
"calculateSKAdNetworkByServerEnabled": boolean
}1. Create an airbridge.json file at the top level of the Expo project folder, input the JSON as above, and configure the SDK settings.
2. Don't input values for keys that are not necessary for your service.
Refer to the links below for detailed guidance on the individual key values.
Note
The functions necessary to ensure compliance with privacy policies should be reviewed with legal counsel.
In the iOS environment, the IDFA can only be collected when users provide consent for data tracking through the App Tracking Transparency (ATT) prompt.
Event collection should be delayed until the user allows tracking. If the install event is collected before the user allows tracking through the ATT prompt, the install event data will lack an identifier, making performance measurement difficult. We recommend setting a sufficient delay time for event collection to collect identifiers.
1. Prepare the text you will use in the ATT prompt.
2. Provide the ATT prompt following this guide provided by Apple.
3. If the install event is not collected, the Airbridge Expo SDK delays collecting install events for 30 seconds until the user allows tracking each time the app is launched. If the user exits the app before deciding whether to allow tracking, the SDK will not collect the install event and will try again at the next app launch.
In the SDK settings, configure the autoDetermineTrackingAuthorizationTimeoutInSecond to set a sufficient delay time for collecting install events. The default value is 30 seconds, and it can be set to up to 3600 seconds (1 hour).
Attention
Set a sufficient delay time to collect the app install event. If the SDK collects install events before users can allow tracking on the ATT prompt, the IDFA won't be collected along with the install events.
Attention
Optional settings. Configure only if necessary.
The opt-in policy requires user consent before using user data.
In the SDK settings, set the autoStartTrackingEnabled to false and call the startTracking function at the point of time when you can collect events. The SDK will start collecting events when the startTracking function is called.
import { Airbridge } from 'airbridge-react-native-sdk'
...
Airbridge.startTracking()Attention
Optional settings. Configure only if necessary.
The opt-out policy allows the use of user information until the user explicitly declines.
In the SDK settings, set the autoStartTrackingEnabled to true and call the stopTracking function at the point of time when you can no longer collect events. The SDK will stop collecting events when the stopTracking function is called.
import { Airbridge } from 'airbridge-react-native-sdk'
...
Airbridge.stopTracking()Attention
Optional settings. Configure only if necessary.
With the SDK Signature, you can prevent SDK spoofing and use verified events to measure ad performance.
The SDK Signature credentials, which are the Secret ID and the Secret, are required for the SDK Signature setup. They can be found on the [Management]>[Fraud Validation Rules]>[SDK Signature] page in the Airbridge dashboard. For more details on how to find the SDK Signature credentials, refer to this Airbridge guide.
Once you have the credentials, go to the SDK settings and enter the Secret ID as sdkSignatureID and the Secret as sdkSignatureSecret.
Deep linking allows you to redirect users from ads to specific locations within your app. The data collected from the tracking link enables you to monitor the performance of the deep link in Airbridge.
When a user clicks on the Airbridge tracking link, the scheme deep link embedded in the tracking link is converted into an Airbridge Deep Link, which can be either an HTTP deep link or a scheme deep link. This Airbridge Deep Link redirects the user to the desired app location. Then, the Airbridge SDK converts the Airbridge Deep Link back to the original scheme deep link embedded in the tracking link and passes it to the app.
Example scheme deep link embedded in the tracking link: YOUR_SCHEME://product/12345
Examples of Airbridge Deep Links
HTTP deep link format 1: https://YOUR_APP_NAME.airbridge.io/~~~
HTTP deep link format 2: https://YOUR_APP_NAME.abr.ge/~~~
Scheme deep link format: YOUR_SCHEME://product/12345?airbridge_referrer=~~~
When the app is installed on the device and the tracking link is clicked, the app opens through the Airbridge Deep Link. The Airbridge SDK converts the Airbridge Deep Link into the scheme deep embedded in the tracking link and passes it to the app.
When the app is not installed on the device and the tracking link is clicked, the Airbridge SDK saves the Airbridge Deep Link. After the user is redirected to the app store or website and the app is installed and launched, the Airbridge SDK converts the saved Airbridge Deep Link into the scheme deep link embedded in the tracking link and passes it to the app.
For the deep linking setup, the following information is required.
Deep link information submitted in the Airbridge dashboard
In-app location address for user redirection
First, submit the deep link information to the Airbridge dashboard.
For the deep linking setup, the following information must be entered into the Airbridge dashboard.
iOS URI scheme: The Airbridge Deep Link is converted to a scheme deep link using the iOS URI scheme.
iOS App ID: The universal link domain of the Airbridge Deep Link is set using the iOS App ID.
Android URI scheme: The Airbridge deep link is converted to a scheme deep link using the Android URI scheme. This information is necessary for the App Link and URI scheme.
Package name: This is the Android app identifier necessary for the App Link and URI scheme.
Android sha256_cert_fingerprints: This is used for setting the App Link domain. This information is necessary for the App Link.
Attention
To properly redirect users as intended, submit different information for the production app and the development app.
Follow the steps below to submit the necessary information to the Airbridge dashboard.
1. Navigate to [Tracking Link]>[Deep Links] in the Airbridge dashboard.
2. Enter the iOS URI scheme in the iOS URI Scheme field. Include ://. For example, if the iOS URI scheme is demo, enter demo://.
3. In the Apple Developer Dashboard, navigate to [Identifier] of the app you want to set up the deep link. Find the App ID Prefix and Bundle ID.
4. The iOS App ID is in the format of App ID Prefix+ . + Bundle ID. Enter the iOS App ID into the iOS App ID field. For example, if the App ID Prefix is prefix and the Bundle ID is example, the iOS App ID is prefix.example.
1. Navigate to [Tracking Link]>[Deep Links] in the Airbridge dashboard.
2. Enter the Android URI scheme into the Android URI Scheme field. Include ://. For example, if the URI scheme is demo, enter demo://.
3. Enter the package name in the Package name field.
4. You need to find the sha256_cert_fingerprints. Run the following command from the keystore file you are deploying.
keytool -list -v -keystore YOUR_KEYSTORE.keystoreFind the SHA256 value in the results. The SHA256 value is the sha256_cert_fingerprints.
Certificate fingerprints:
MD5: 4C:65:04:52:F0:3F:F8:65:08:D3:71:86:FC:EF:C3:49
SHA1: C8:BF:B7:B8:94:EA:5D:9D:38:59:FE:99:63:ED:47:B2:D9:5A:4E:CC
SHA256: B5:EF:4D:F9:DC:95:E6:9B:F3:9A:5E:E9:D6:E0:D8:F6:7B:AB:79:C8:78:67:34:D9:A7:01:AB:6A:86:01:0E:995. Enter the SHA256 value into the sha256_cert_fingerprints field.
After entering the deep link information into the Airbridge dashboard, an additional setup is required to enable the following.
App launch with Airbridge Deep Links
Airbridge Deep Link event collection
User redirection with Airbridge Deep Links
For detailed instructions, refer to the information below.
To enable app launch with Airbridge Deep Links, add the following code to the app.json.
{
"expo": {
...
"scheme": "YOUR_SCHEME",
"android": {
...
"intentFilters": [{
"autoVerify": true,
"action": "VIEW",
"data": { "scheme": "https", "host": "APP_NAME.airbridge.io" },
"category": ["BROWSABLE", "DEFAULT"]
}, {
"autoVerify": true,
"action": "VIEW",
"data": { "scheme": "https", "host": "APP_NAME.abr.ge" },
"category": ["BROWSABLE", "DEFAULT"]
}, {
"autoVerify": true,
"action": "VIEW",
"data": { "scheme": "http", "host": "APP_NAME.airbridge.io" },
"category": ["BROWSABLE", "DEFAULT"]
}, {
"autoVerify": true,
"action": "VIEW",
"data": { "scheme": "http", "host": "APP_NAME.abr.ge" },
"category": ["BROWSABLE", "DEFAULT"]
}]
},
"ios": {
...
"associatedDomains": [
"applinks:APP_NAME.airbridge.io",
"applinks:APP_NAME.abr.ge"
]
}
}
}
YOUR_SCHEMEis the URI Scheme that can be found on the [Tracking Link]>[Deep Links] page in the Airbridge dashboard.
When an Airbridge Deep Link is executed, it is converted into a scheme deep link and passed to the OnDeeplinkReceived callback. If a deep link that is not an Airbridge Deep Link is executed, the deep link is passed directly to the callback without any conversion.
Use the deep link passed to the callback to redirect the user to the intended destination.
import { Airbridge } from 'airbridge-react-native-sdk'
...
Airbridge.setOnDeeplinkReceived((url) => {
// show proper content using url
})When a user clicks on a tracking link with deferred deep linking capabilities and your app is not installed on the device, the Airbridge SDK collects the deep link as follows.
The Airbridge SDK attempts to collect a deep link after initializing the SDK when all the following conditions are met. If the app is closed during collection, the Airbridge SDK treats it as if there is no stored Airbridge deep link.
The
Airbridge.startTrackingfunction is called with the opt-in settings in place. Or, opt-in has not been set.The ATT tracking response has been determined. Or, the event collection delay time set in the ATT prompt has expired.
Deferred deep links are automatically passed to OnDeeplinkReceived, so no additional setup is required.
Attention
Optional settings. Configure only if necessary.
Enter the custom domain address into the Airbridge dashboard by referring to this article
In the SDK Settings, enter the custom domain address in the
trackingLinkCustomDomains. TheYOUR_APP_CUSTOM_DOMAINshould be the Fully Qualified Domain Name (FQDN).123{ "trackingLinkCustomDomains": ["YOUR_APP_CUSTOM_DOMAIN"] }Attention
The custom domain address you add to the SDK should be the same as the custom domain address entered into the Airbridge dashboard.
The Airbridge SDK collects user actions from the app as per settings and sends them as in-app events.
SDK setup for hybrid apps
You can set up the React Native SDK to handle Airbridge-related tasks within the in-app website without changing the website's code for your hybrid app.
Call the Airbridge.trackEvent function to send events. Refer to the information below about the required Airbridge.trackEvent function components and their types.
static trackEvent(
category: string,
): void
static trackEvent(
category: string,
semanticAttributes: Record<string, any>,
): void
static trackEvent(
category: string,
semanticAttributes: Record<string, any>,
customAttributes: Record<string, any>,
): voidRefer to the component definition and available strings below.
The Standard Event Categories provided by the Airbridge SDK can be found in the AirbridgeCategory. You can also enter the Event Categories from the list of Standard Events.
Custom events can be sent by entering the event names in the event taxonomy.
Refer to the example below.
import { Airbridge, AirbridgeCategory } from 'airbridge-react-native-sdk'
...
// track standard event (provided by sdk)
Airbridge.trackEvent(AirbridgeCategory.ORDER_COMPLETED)
// track standard event (not provided by sdk)
Airbridge.trackEvent('airbridge.ecommerce.order.canceled')
// track custom event
Airbridge.trackEvent('eventViewed')Attention
The Airbridge SDK v4 attributes differ from the previous version. The previous version's attributes do not include action, label, and value.
Additional information about the event can be collected using attributes.
Action, Label: Collect information that can be used as GroupBys in the Airbridge reports
Value: Collect information that can be used for sales analysis. Airbridge can perform calculations using the collected data.
Semantic Attribute: Collect predefined attributes by Airbridge.
Custom Attributes: Collect attributes defined by Airbridge users.
You can enter Action, Label, Value, and Semantic Attributes using the semanticAttributes parameter of the Airbridge.trackEvent function and enter Custom Attributes using the customAttributes parameter.
In the Airbridge.trackEvent function, you can enter Action, Label, Value, and Semantic Attributes using the semanticAttributes parameter and Custom Attributes using the customAttributes parameter.
The semantic attributes predefined by Airbridge can be found in the user guide below.
Refer to the example below.
import { Airbridge, AirbridgeCategory, AirbridgeAttribute } from 'airbidge-react-native-sdk'
...
Airbridge.trackEvent(
AirbridgeCategory.ORDER_COMPLETED,
{
// action
[AirbridgeAttribute.ACTION]: 'Tool',
// label
[AirbridgeAttribute.LABEL]: 'Hammer',
// value
[AirbridgeAttribute.VALUE]: 10,
// semantic attribute (provided by sdk)
[AirbridgeAttribute.CURRENCY]: 'USD',
[AirbridgeAttribute.PRODUCTS]: [
{
// semantic attribute value (provided by sdk)
[AirbridgeAttribute.PRODUCT_ID]: '12345',
// semantic attribute value (not provided by sdk)
'name': 'PlasticHammer',
},
],
// semantic attribute (not provided by sdk)
'totalQuantity': 1,
},
{
// custom attribute
'promotion': 'FirstPurchasePromotion',
}
)Attention
Semantic attributes and custom attributes only allow JSON as a data type.
JSON types: string, number, boolean, Record<string, JSON>, Array<JSON>
Types that cannot be used in semantic attributes and custom attributes: Class, etc.
The Event Category of Standard Events and Semantic Attributes provided by the SDK are as follows.
Refer to the example codes for each data type below.
import { Airbridge, AirbridgeAttribute } from 'airbridge-react-native-sdk'
...
Airbridge.trackEvent(
'event',
{
[AirbridgeAttribute.VALUE]: 10,
},
{
'string': 'string',
'number': 1000,
'boolean': true,
'object': {'key': 'value'},
'array': ['value'],
},
)Attention
The default settings will apply if no additional settings are configured. Proceed after reviewing whether additional settings are necessary.
Configure additional settings for sending in-app events if necessary.
The Airbridge SDK includes session information when sending event data.
When the app moves to the background or the process is terminated, the background entry time is recorded. When the app returns to the foreground or the process is restarted, the re-entry time is recorded. If the time difference between the last background entry and re-entry exceeds the session timeout, the previous session ends and a new session begins.
The default session timeout is 300 seconds (5 minutes). In the SDK settings, you can configure setSessionTimeout up to 604,800 seconds (7 days).
Attention
The Airbridge SDK collects Open events and Foreground events that initiate a new session. However, those events are not collected during a session. To collect them while the session is being maintained, additional settings are required.
The default transmission interval is set to 0 seconds. In the SDK settings, you can adjust setEventTransmitInterval to modify it to a maximum of 86,400 seconds (1 day).
The following table shows the default and maximum values for the number of events and storage size.
In the SDK settings, If you want to limit the number of events the SDK stores, use the eventBufferCountLimit, and to limit the storage size of the SDK, use the eventBufferSizeLimitInGibibyte.
When the event deletion option is activated, all in-app events that are not transmitted during the Airbridge SDK's initialization process are deleted. By default, the event deletion option is inactive.
In the SDK settings, set setClearEventBufferOnInitializeEnabled to true to activate the event deletion option.
import Airbridge
...
let option = AirbridgeOptionBuilder(name: "YOUR_APP_NAME", token: "YOUR_APP_TOKEN")
.setClearEventBufferOnInitializeEnabled(true)
.build()
Airbridge.initializeSDK(option: option)#import <Airbridge/Airbridge.h>
...
AirbridgeOptionBuilder* optionBuilder = [[AirbridgeOptionBuilder alloc] initWithName:@"YOUR_APP_NAME"
token:@"YOUR_APP_TOKEN"];
[optionBuilder setClearEventBufferOnInitializeEnabled:YES];
AirbridgeOption* option = [optionBuilder build];
[Airbridge initializeSDKWithOption:option];The Airbridge SDK supports functions to include device identifiers in all events for transmission.
Refer to the example below.
import { Airbridge } from 'airbridge-react-native-sdk'
...
Airbridge.setDeviceAlias('string', 'string')
Airbridge.removeDeviceAlias('string')
Airbridge.clearDeviceAlias()Airbridge collects in-app events that are classified as Standard Events and Custom Events. Standard Events are events predefined by Airbridge. Refer to the example codes below.
import { Airbridge, AirbridgeCategory } from 'airbridge-react-native-sdk'
...
Airbridge.setUserID('string')
Airbridge.setUserAlias('string', 'string')
Airbridge.setUserEmail('string')
Airbridge.setUserPhone('string')
Airbridge.setUserAttribute('string', 'string')
Airbridge.trackEvent(
AirbridgeCategory.SIGN_UP,
)import { Airbridge, AirbridgeCategory } from 'airbridge-react-native-sdk'
...
Airbridge.setUserID('string')
Airbridge.setUserAlias('string', 'string')
Airbridge.setUserEmail('string')
Airbridge.setUserPhone('string')
Airbridge.setUserAttribute('string', 'string')
Airbridge.trackEvent(
AirbridgeCategory.SIGN_IN,
)import { Airbridge, AirbridgeCategory } from 'airbridge-react-native-sdk'
...
Airbridge.trackEvent(
AirbridgeCategory.SIGN_OUT,
)
Airbridge.clearUser()import { Airbridge, AirbridgeCategory } from 'airbridge-react-native-sdk'
...
Airbridge.trackEvent(
AirbridgeCategory.HOME_VIEWED,
)import { Airbridge, AirbridgeCategory, AirbridgeAttribute } from 'airbridge-react-native-sdk'
...
Airbridge.trackEvent(
AirbridgeCategory.PRODUCT_LIST_VIEWED,
{
[AirbridgeAttribute.LIST_ID]: '84e6e236-38c4-48db-9b49-16e4cc064386',
[AirbridgeAttribute.CURRENCY]: 'USD',
[AirbridgeAttribute.PRODUCTS]: [
{
[AirbridgeAttribute.PRODUCT_ID]: '0117b32a-5a6c-4d4c-b64c-7858e07dba78',
[AirbridgeAttribute.PRODUCT_NAME]: 'PlasticHammer',
[AirbridgeAttribute.PRODUCT_PRICE]: 10,
[AirbridgeAttribute.PRODUCT_QUANTITY]: 1,
[AirbridgeAttribute.PRODUCT_CURRENCY]: 'USD',
},
{
[AirbridgeAttribute.PRODUCT_ID]: 'd6ab2fbe-decc-4362-b719-d257a131e91e',
[AirbridgeAttribute.PRODUCT_NAME]: 'PlasticFork',
[AirbridgeAttribute.PRODUCT_PRICE]: 1,
[AirbridgeAttribute.PRODUCT_QUANTITY]: 1,
[AirbridgeAttribute.PRODUCT_CURRENCY]: 'USD',
},
],
},
)import { Airbridge, AirbridgeCategory, AirbridgeAttribute } from 'airbridge-react-native-sdk'
...
Airbridge.trackEvent(
AirbridgeCategory.SEARCH_RESULTS_VIEWED,
{
[AirbridgeAttribute.QUERY]: 'Plastic',
[AirbridgeAttribute.CURRENCY]: 'USD',
[AirbridgeAttribute.PRODUCTS]: [
{
[AirbridgeAttribute.PRODUCT_ID]: '0117b32a-5a6c-4d4c-b64c-7858e07dba78',
[AirbridgeAttribute.PRODUCT_NAME]: 'PlasticHammer',
[AirbridgeAttribute.PRODUCT_PRICE]: 10,
[AirbridgeAttribute.PRODUCT_QUANTITY]: 1,
[AirbridgeAttribute.PRODUCT_CURRENCY]: 'USD',
},
{
[AirbridgeAttribute.PRODUCT_ID]: 'd6ab2fbe-decc-4362-b719-d257a131e91e',
[AirbridgeAttribute.PRODUCT_NAME]: 'PlasticFork',
[AirbridgeAttribute.PRODUCT_PRICE]: 1,
[AirbridgeAttribute.PRODUCT_QUANTITY]: 1,
[AirbridgeAttribute.PRODUCT_CURRENCY]: 'USD',
},
],
},
)import { Airbridge, AirbridgeCategory, AirbridgeAttribute } from 'airbridge-react-native-sdk'
...
Airbridge.trackEvent(
AirbridgeCategory.PRODUCT_VIEWED,
{
[AirbridgeAttribute.CURRENCY]: 'USD',
[AirbridgeAttribute.PRODUCTS]: [
{
[AirbridgeAttribute.PRODUCT_ID]: '0117b32a-5a6c-4d4c-b64c-7858e07dba78',
[AirbridgeAttribute.PRODUCT_NAME]: 'PlasticHammer',
[AirbridgeAttribute.PRODUCT_PRICE]: 10,
[AirbridgeAttribute.PRODUCT_QUANTITY]: 1,
[AirbridgeAttribute.PRODUCT_CURRENCY]: 'USD',
},
],
},
)import { Airbridge, AirbridgeCategory, AirbridgeAttribute } from 'airbridge-react-native-sdk'
...
Airbridge.trackEvent(
AirbridgeCategory.ADD_PAYMENT_INFO,
{
[AirbridgeAttribute.TYPE]: 'CreditCard',
},
)import { Airbridge, AirbridgeCategory, AirbridgeAttribute } from 'airbridge-react-native-sdk'
...
Airbridge.trackEvent(
AirbridgeCategory.ADD_TO_WISHLIST,
{
[AirbridgeAttribute.LIST_ID]: '189a2f8b-83ee-4074-8158-726be54e57d4',
[AirbridgeAttribute.CURRENCY]: 'USD',
[AirbridgeAttribute.PRODUCTS]: [
{
[AirbridgeAttribute.PRODUCT_ID]: '0117b32a-5a6c-4d4c-b64c-7858e07dba78',
[AirbridgeAttribute.PRODUCT_NAME]: 'PlasticHammer',
[AirbridgeAttribute.PRODUCT_PRICE]: 10,
[AirbridgeAttribute.PRODUCT_QUANTITY]: 1,
[AirbridgeAttribute.PRODUCT_CURRENCY]: 'USD',
},
],
},
)import { Airbridge, AirbridgeCategory, AirbridgeAttribute } from 'airbridge-react-native-sdk'
...
Airbridge.trackEvent(
AirbridgeCategory.ADDED_TO_CART,
{
[AirbridgeAttribute.CART_ID]: '421eaeb7-6e80-4694-933e-f2e1a55e9cbd',
[AirbridgeAttribute.CURRENCY]: 'USD',
[AirbridgeAttribute.PRODUCTS]: [
{
[AirbridgeAttribute.PRODUCT_ID]: '0117b32a-5a6c-4d4c-b64c-7858e07dba78',
[AirbridgeAttribute.PRODUCT_NAME]: 'PlasticHammer',
[AirbridgeAttribute.PRODUCT_PRICE]: 10,
[AirbridgeAttribute.PRODUCT_QUANTITY]: 1,
[AirbridgeAttribute.PRODUCT_CURRENCY]: 'USD',
},
],
},
)import { Airbridge, AirbridgeCategory, AirbridgeAttribute } from 'airbridge-react-native-sdk'
...
Airbridge.trackEvent(
AirbridgeCategory.INITIATE_CHECKOUT,
{
[AirbridgeAttribute.TRANSACTION_ID]: '0a7ee1ec-33da-4ffb-b775-89e80e75978a',
[AirbridgeAttribute.CURRENCY]: 'USD',
[AirbridgeAttribute.PRODUCTS]: [
{
[AirbridgeAttribute.PRODUCT_ID]: '0117b32a-5a6c-4d4c-b64c-7858e07dba78',
[AirbridgeAttribute.PRODUCT_NAME]: 'PlasticHammer',
[AirbridgeAttribute.PRODUCT_PRICE]: 10,
[AirbridgeAttribute.PRODUCT_QUANTITY]: 1,
[AirbridgeAttribute.PRODUCT_CURRENCY]: 'USD',
},
{
[AirbridgeAttribute.PRODUCT_ID]: 'd6ab2fbe-decc-4362-b719-d257a131e91e',
[AirbridgeAttribute.PRODUCT_NAME]: 'PlasticFork',
[AirbridgeAttribute.PRODUCT_PRICE]: 1,
[AirbridgeAttribute.PRODUCT_QUANTITY]: 1,
[AirbridgeAttribute.PRODUCT_CURRENCY]: 'USD',
},
],
},
)import { Airbridge, AirbridgeCategory, AirbridgeAttribute } from 'airbridge-react-native-sdk'
...
Airbridge.trackEvent(
AirbridgeCategory.ORDER_COMPLETED,
{
[AirbridgeAttribute.VALUE]: 11,
[AirbridgeAttribute.TRANSACTION_ID]: '8065ef16-162b-4a82-b683-e51aefdda7d5',
[AirbridgeAttribute.CURRENCY]: 'USD',
[AirbridgeAttribute.IN_APP_PURCHASED]: true,
[AirbridgeAttribute.PRODUCTS]: [
{
[AirbridgeAttribute.PRODUCT_ID]: '0117b32a-5a6c-4d4c-b64c-7858e07dba78',
[AirbridgeAttribute.PRODUCT_NAME]: 'PlasticHammer',
[AirbridgeAttribute.PRODUCT_PRICE]: 10,
[AirbridgeAttribute.PRODUCT_QUANTITY]: 1,
[AirbridgeAttribute.PRODUCT_CURRENCY]: 'USD',
},
{
[AirbridgeAttribute.PRODUCT_ID]: 'd6ab2fbe-decc-4362-b719-d257a131e91e',
[AirbridgeAttribute.PRODUCT_NAME]: 'PlasticFork',
[AirbridgeAttribute.PRODUCT_PRICE]: 1,
[AirbridgeAttribute.PRODUCT_QUANTITY]: 1,
[AirbridgeAttribute.PRODUCT_CURRENCY]: 'USD',
},
],
},
)import { Airbridge, AirbridgeCategory, AirbridgeAttribute } from 'airbridge-react-native-sdk'
...
Airbridge.trackEvent(
AirbridgeCategory.ORDER_CANCELED,
{
[AirbridgeAttribute.VALUE]: 11,
[AirbridgeAttribute.TRANSACTION_ID]: '8065ef16-162b-4a82-b683-e51aefdda7d5',
[AirbridgeAttribute.CURRENCY]: 'USD',
[AirbridgeAttribute.IN_APP_PURCHASED]: true,
[AirbridgeAttribute.PRODUCTS]: [
{
[AirbridgeAttribute.PRODUCT_ID]: '0117b32a-5a6c-4d4c-b64c-7858e07dba78',
[AirbridgeAttribute.PRODUCT_NAME]: 'PlasticHammer',
[AirbridgeAttribute.PRODUCT_PRICE]: 10,
[AirbridgeAttribute.PRODUCT_QUANTITY]: 1,
[AirbridgeAttribute.PRODUCT_CURRENCY]: 'USD',
},
{
[AirbridgeAttribute.PRODUCT_ID]: 'd6ab2fbe-decc-4362-b719-d257a131e91e',
[AirbridgeAttribute.PRODUCT_NAME]: 'PlasticFork',
[AirbridgeAttribute.PRODUCT_PRICE]: 1,
[AirbridgeAttribute.PRODUCT_QUANTITY]: 1,
[AirbridgeAttribute.PRODUCT_CURRENCY]: 'USD',
},
],
},
)import { Airbridge, AirbridgeCategory, AirbridgeAttribute } from 'airbridge-react-native-sdk'
...
Airbridge.trackEvent(
AirbridgeCategory.START_TRIAL,
{
[AirbridgeAttribute.TRANSACTION_ID]: 'ef1e5271-0370-407c-b1e9-669a8df1dc2c',
[AirbridgeAttribute.CURRENCY]: 'USD',
[AirbridgeAttribute.PERIOD]: 'P1M',
[AirbridgeAttribute.PRODUCTS]: [
{
[AirbridgeAttribute.PRODUCT_ID]: '306a57cb-f653-4220-a208-8405d8e4d506',
[AirbridgeAttribute.PRODUCT_NAME]: 'MusicStreamingMemebership',
[AirbridgeAttribute.PRODUCT_PRICE]: 15,
[AirbridgeAttribute.PRODUCT_CURRENCY]: 'USD',
},
],
},
)import { Airbridge, AirbridgeCategory, AirbridgeAttribute } from 'airbridge-react-native-sdk'
...
Airbridge.trackEvent(
AirbridgeCategory.SUBSCRIBE,
{
[AirbridgeAttribute.VALUE]: 15,
[AirbridgeAttribute.CURRENCY]: 'USD',
[AirbridgeAttribute.TRANSACTION_ID]: 'cbe718c7-e44e-4707-b5cd-4a6a29f29649',
[AirbridgeAttribute.PERIOD]: 'P1M',
[AirbridgeAttribute.IS_RENEWAL]: true,
[AirbridgeAttribute.PRODUCTS]: [
{
[AirbridgeAttribute.PRODUCT_ID]: '306a57cb-f653-4220-a208-8405d8e4d506',
[AirbridgeAttribute.PRODUCT_NAME]: 'MusicStreamingMemebership',
[AirbridgeAttribute.PRODUCT_PRICE]: 15,
[AirbridgeAttribute.PRODUCT_CURRENCY]: 'USD',
},
],
},
)import { Airbridge, AirbridgeCategory, AirbridgeAttribute } from 'airbridge-react-native-sdk'
...
Airbridge.trackEvent(
AirbridgeCategory.UNSUBSCRIBE,
{
[AirbridgeAttribute.VALUE]: 15,
[AirbridgeAttribute.CURRENCY]: 'USD',
[AirbridgeAttribute.TRANSACTION_ID]: 'cbe718c7-e44e-4707-b5cd-4a6a29f29649',
[AirbridgeAttribute.IS_RENEWAL]: true,
[AirbridgeAttribute.PRODUCTS]: [
{
[AirbridgeAttribute.PRODUCT_ID]: '306a57cb-f653-4220-a208-8405d8e4d506',
[AirbridgeAttribute.PRODUCT_NAME]: 'MusicStreamingMemebership',
[AirbridgeAttribute.PRODUCT_PRICE]: 15,
[AirbridgeAttribute.PRODUCT_CURRENCY]: 'USD',
},
],
},
)import { Airbridge, AirbridgeCategory, AirbridgeAttribute } from 'airbridge-react-native-sdk'
...
Airbridge.trackEvent(
AirbridgeCategory.AD_IMPRESSION,
{
[AirbridgeAttribute.VALUE]: 0.01,
[AirbridgeAttribute.AD_PARTNERS]: {
'mopub': {
'app_version': '5.18.0',
'adunit_id': '12345',
'adunit_name': '12345',
'adunit_format': 'Banner',
'id': '12345',
'currency': 'USD',
'publisher_revenue': 12345.123,
'adgroup_id': '12345',
'adgroup_name': '12345',
'adgroup_type': '12345',
'adgroup_priority': '12345',
'country': 'kr',
'precision': 'publisher_defined',
'network_name': '12345',
'network_placement_id': '12345',
'demand_partner_data': '12345',
},
},
},
)import { Airbridge, AirbridgeCategory, AirbridgeAttribute } from 'airbridge-react-native-sdk'
...
Airbridge.trackEvent(
AirbridgeCategory.AD_CLICK,
{
[AirbridgeAttribute.VALUE]: 0.1,
[AirbridgeAttribute.AD_PARTNERS]: {
'mopub': {
'app_version': '5.18.0',
'adunit_id': '12345',
'adunit_name': '12345',
'adunit_format': 'Banner',
'id': '12345',
'currency': 'USD',
'publisher_revenue': 12345.123,
'adgroup_id': '12345',
'adgroup_name': '12345',
'adgroup_type': '12345',
'adgroup_priority': '12345',
'country': 'kr',
'precision': 'publisher_defined',
'network_name': '12345',
'network_placement_id': '12345',
'demand_partner_data': '12345',
},
},
},
)import { Airbridge, AirbridgeCategory, AirbridgeAttribute } from 'airbridge-react-native-sdk'
...
Airbridge.trackEvent(
AirbridgeCategory.COMPLETE_TUTORIAL,
{
[AirbridgeAttribute.DESCRIPTION]: 'Finish Initial Tutorial',
},
)import { Airbridge, AirbridgeCategory, AirbridgeAttribute } from 'airbridge-react-native-sdk'
...
Airbridge.trackEvent(
AirbridgeCategory.ACHIEVE_LEVEL,
{
[AirbridgeAttribute.LEVEL]: 13,
},
)import { Airbridge, AirbridgeCategory, AirbridgeAttribute } from 'airbridge-react-native-sdk'
...
Airbridge.trackEvent(
AirbridgeCategory.UNLOCK_ACHIEVEMENT,
{
[AirbridgeAttribute.ACHIEVEMENT_ID]: '36a0f0bb-b153-4be1-a3e0-3cb5b2b076c1',
[AirbridgeAttribute.DESCRIPTION]: 'Get Score Over 50',
[AirbridgeAttribute.SCORE]: 80,
},
)import { Airbridge, AirbridgeCategory, AirbridgeAttribute } from 'airbridge-react-native-sdk'
...
Airbridge.trackEvent(
AirbridgeCategory.RATE,
{
[AirbridgeAttribute.RATE_ID]: '531c64b3-4704-4780-a306-89014ec18daf',
[AirbridgeAttribute.RATE]: 4.5,
[AirbridgeAttribute.MAX_RATE]: 5,
[AirbridgeAttribute.CURRENCY]: 'USD',
[AirbridgeAttribute.PRODUCTS]: [
{
[AirbridgeAttribute.PRODUCT_ID]: '0117b32a-5a6c-4d4c-b64c-7858e07dba78',
[AirbridgeAttribute.PRODUCT_NAME]: 'PlasticHammer',
[AirbridgeAttribute.PRODUCT_PRICE]: 10,
[AirbridgeAttribute.PRODUCT_CURRENCY]: 'USD',
},
],
},
)import { Airbridge, AirbridgeCategory, AirbridgeAttribute } from 'airbridge-react-native-sdk'
...
Airbridge.trackEvent(
AirbridgeCategory.SHARE,
{
[AirbridgeAttribute.DESCRIPTION]: 'Share Promotion',
[AirbridgeAttribute.SHARED_CHANNEL]: 'CopyLink',
},
)import { Airbridge, AirbridgeCategory, AirbridgeAttribute } from 'airbridge-react-native-sdk'
...
Airbridge.trackEvent(
AirbridgeCategory.SCHEDULE,
{
[AirbridgeAttribute.SCHEDULE_ID]: '75712915-2cd9-4e42-a85e-8d42f356f4c6',
[AirbridgeAttribute.DATE_TIME]: '2024-01-01T00:00:00+00:00',
[AirbridgeAttribute.PLACE]: 'ConferenceRoom',
[AirbridgeAttribute.PRODUCTS]: [
{
[AirbridgeAttribute.PRODUCT_ID]: 'abb3e65d-17bc-4b28-89e3-5e356c0ea697',
[AirbridgeAttribute.PRODUCT_NAME]: 'ConferenceRoom',
},
],
},
)import { Airbridge, AirbridgeCategory, AirbridgeAttribute } from 'airbridge-react-native-sdk'
...
Airbridge.trackEvent(
AirbridgeCategory.SPEND_CREDITS,
{
[AirbridgeAttribute.TRANSACTION_ID]: '22eb193d-be11-4fe4-95da-c91a196faf1c',
[AirbridgeAttribute.CURRENCY]: 'USD',
[AirbridgeAttribute.PRODUCTS]: [
{
[AirbridgeAttribute.PRODUCT_ID]: '0117b32a-5a6c-4d4c-b64c-7858e07dba78',
[AirbridgeAttribute.PRODUCT_NAME]: 'PlasticHammer',
[AirbridgeAttribute.PRODUCT_PRICE]: 10,
[AirbridgeAttribute.PRODUCT_CURRENCY]: 'USD',
},
],
},
)Custom Events are events defined by Airbridge users to track user actions that are unique to their services. Refer to the example code below.
import { Airbridge, AirbridgeAttribute } from 'airbridge-react-native-sdk'
...
Airbridge.trackEvent(
'event',
{
[AirbridgeAttribute.VALUE]: 10,
},
{
'string': 'string',
'number': 1000,
'boolean': true,
'object': {'key': 'value'},
'array': ['value'],
},
)Airbridge sends user data along with events. User data allows for a more accurate ad performance measurement.
User IDs refer to the user identifier used in a service. User IDs should be unique IDs that can identify unique users across websites and apps.
Refer to the example below.
import { Airbridge } from 'airbridge-react-native-sdk'
...
// identifier
Airbridge.setUserID('string')
Airbridge.clearUserID()
// addtional identifier
Airbridge.setUserAlias('string', 'string')
Airbridge.removeUserAlias('string')
Airbridge.clearUserAlias()Attention
Sensitive user information may be included. Send after a thorough review with a legal advisor.
Refer to the functions below to send additional user information.
Refer to the example below.
import { Airbridge } from 'airbridge-react-native-sdk'
...
// email, phone
Airbridge.setUserEmail('string')
Airbridge.clearUserEmail()
Airbridge.setUserPhone('string')
Airbridge.clearUserPhone()
// addtional attribute
Airbridge.setUserAttribute('string', 'string')
Airbridge.setUserAttribute('number', 1000)
Airbridge.removeUserAttribute('string')
Airbridge.clearUserAttributes()When hashUserInformationEnabled is set to false in the SDK settings, user emails and phone numbers are passed without being hashed. The default setting is true.
You can reset user information with the Airbridge.clearUser function.
import { Airbridge } from 'airbridge-react-native-sdk'
...
Airbridge.clearUser()The SDK automatically sends install and open events immediately after the app launches. Therefore, if you call user information functions right after the app launches, the user information may not be included in the install/open events depending on the event transmission timing.
To ensure user information is included in install/open events, control the timing of event transmission through Opt-In setup.
Implement in the following order:
Set the
autoStartTrackingEnabledoption tofalsewhen Configure SDK settings.Call user information functions to set user information.
Call the
startTracking()function to start event collection.
Follow the instructions below for additional setup.
Attention
Optional settings. Configure only if necessary.
Attention
Expo SDK v.4.8.0 or later is required.
By default, the ConversionValue in SKAdNetwork is calculated using the values from the SDK. If you want to measure events collected server-side through SKAN instead of the SDK, In SDK settings, set the calculateSKAdNetworkByServerEnabled option to true.
Attention
If you are currently using conversion values calculated by the SDK via SKAdNetwork, please exercise caution when making changes. Altering the conversion value calculation method may cause inconsistencies between existing and new data.
Attention
Expo SDK v.4.7.0 or later is required.
You can restrict the SDK from tracking identifier data.
In SDK settings, set the trackingBlocklist to specify which identifiers should be blocked. Events collected after this configuration will exclude the specified identifiers.
The input values for trackingBlocklist are case-insensitive.
Attention
Expo SDK v.4.5.1 or later is required.
The Airbridge Expo SDK is initialized based on the top-level SDK settings file in the project folder. You can apply different settings files for different build settings using AIRBRIDGE_ENVIRONMENT.
If the AIRBRIDGE_ENVIRONMENT is not specified, the SDK is initialized based on the airbridge.json which is the default settings file in the root folder.
The following table shows the SDK settings file that is applied depending on the set AIRBRIDGE_ENVIRONMENT value.
Below are examples codes regarding the AIRBRIDGE_ENVIRONMENT setup.
$ AIRBRIDGE_ENVIRONMENT=development; npx expo run:android
$ AIRBRIDGE_ENVIRONMENT=development; npx expo run:iosAttention
React Native SDK v.4.4.0 or later is required.
Integrated Conversion Measurement (ICM) is Google’s privacy-driven solution for filling in conversion tracking gaps caused by stricter tracking limitations. Google provides the ICM attribution data, which is the non-deterministic attribution data provided by Google's privacy-preserving conversion modeling.
To integrate the ICM attribution data, the Google's On-Device Conversion Measurement (ODM) SDK must be installed. For detailed information, refer to this article. or contact Google.
Attention
Expo SDK v.4.3.0 or later is required.
Tracking links are links that are embedded to ads for data collection. When users click on the ad, the tracking link is used to pass the touchpoint data to Airbridge, allowing for ad attribution.
Also, users who click on the ad with a tracking link can be redirected to a specific destination.
Use the createTrackingLink function to create tracking links. Refer to the code examples and the parameter details below.
static createTrackingLink(
channel: string,
option: Record<string, any>,
onSuccess: (airbridgeTrackingLink: AirbridgeTrackingLink) => void,
onFailure?: (error: Error) => void
): voidUse the option parameter in the createTrackingLink function to configure tracking link options.
Use the onSuccess callback in the createTrackingLink function to pass the AirbridgeTrackingLink.
/**
* Holds variable types of tracking-link that move user
* to specific page of app and track click-event.
*/
export type AirbridgeTrackingLink = {
/// A tracking-link url contains short mapping-id of option
shortURL: string
/// A qrcode image-url of tracking-link
qrcodeURL: string
}Refer to the example codes below.
Airbridge.createTrackingLink(
"test_channel",
{
[AirbridgeTrackingLinkOption.CAMPAIGN]: 'test_campaign',
[AirbridgeTrackingLinkOption.DEEPLINK_URL]: 'YOUR_SCHEME://...',
[AirbridgeTrackingLinkOption.FALLBACK_IOS]: 'store',
[AirbridgeTrackingLinkOption.FALLBACK_ANDROID]: 'store',
[AirbridgeTrackingLinkOption.FALLBACK_DESKTOP]: 'https://example.com/'
},
(trackingLink) => {
// Handling created tracking-link
},
(error) => {
// Handling error
}
)Airbridge.createTrackingLink(
"test_channel",
{
[AirbridgeTrackingLinkOption.CAMPAIGN]: 'test_campaign',
[AirbridgeTrackingLinkOption.DEEPLINK_URL]: 'sample://home',
[AirbridgeTrackingLinkOption.FALLBACK_IOS]: 'https://example.com/',
[AirbridgeTrackingLinkOption.FALLBACK_ANDROID]: 'https://example.com/',
[AirbridgeTrackingLinkOption.FALLBACK_DESKTOP]: 'https://example.com/'
},
(trackingLink) => {
// Handling created tracking-link
},
(error) => {
// Handling error
}
)Airbridge.createTrackingLink(
"test_channel",
{
[AirbridgeTrackingLinkOption.CAMPAIGN]: 'test_campaign',
[AirbridgeTrackingLinkOption.FALLBACK_IOS]: 'store',
[AirbridgeTrackingLinkOption.FALLBACK_ANDROID]: 'store',
[AirbridgeTrackingLinkOption.FALLBACK_DESKTOP]: 'https://example.com/'
},
(trackingLink) => {
// Handling created tracking-link
},
(error) => {
// Handling error
}
)Airbridge.createTrackingLink(
"test_channel",
{
[AirbridgeTrackingLinkOption.CAMPAIGN]: 'test_campaign',
[AirbridgeTrackingLinkOption.FALLBACK_IOS]: 'https://example.com/',
[AirbridgeTrackingLinkOption.FALLBACK_ANDROID]: 'https://example.com/',
[AirbridgeTrackingLinkOption.FALLBACK_DESKTOP]: 'https://example.com/'
},
(trackingLink) => {
// Handling created tracking-link
},
(error) => {
// Handling error
}
)Note
The Airbridge Expo SDK must be v4.2.0 or later.
The deep links passed through the setOnDeeplinkReceived method of the Airbridge Expo SDK include not only Airbridge Deep Links but also deep links from other solutions.
import { Airbridge } from 'airbridge-react-native-sdk';
...
Airbridge.setOnDeeplinkReceived((url) => {
// show proper content using url
})By configuring isHandleAirbridgeDeeplinkOnly to true in the SDK settings, only Airbridge Deep Links will be passed to the setOnDeeplinkReceived callback. In this way, you can handle the deep links from other solutions separately from the Airbridge Deep Links.
Depending on how links are opened, it may be challenging to properly use the tracking link within the app.
By using the Airbridge.click function or the Airbridge.impression function, you can properly use the tracking link within the app without sending users to an external browser.
When a user clicks a tracking link within the app, the Airbridge.click function is triggered. Depending on the tracking link settings, the scheme deep link is passed, or the user is redirected to the app store or website.
import Airbridge
...
let isHandled = Airbridge.click(trackingLink: url) {
// when url is tracking link and succeed
} onFailure: { error in
// when url is tracking link and failed
// example: url is another app's tracking link, internet is not connected
}
if !isHandled {
// when url is not tracking link
}#import <Airbridge/Airbridge.h>
...
BOOL isHandled = [Airbridge clickWithTrackingLink:url onSuccess:^{
// when url is tracking link and succeed
} onFailure:^(NSError * _Nonnull) {
// when url is tracking link and failed
// example: url is another app's tracking link, internet is not connected
}];
if (!isHandled) {
// when url is not tracking link
}When a user engages with the tracking link, the Airbridge.impression function is called, and the impression event data is collected.
import Airbridge
...
let isHandled = Airbridge.impression(trackingLink: url) {
// when url is tracking link and succeed
} onFailure: { error in
// when url is tracking link and failed
}
if !isHandled {
// when url is not tracking link
}#import <Airbridge/Airbridge.h>
...
BOOL isHandled = [Airbridge impressionWithTrackingLink:url onSuccess:^{
// when url is tracking link and succeed
} onFailure:^(NSError * _Nonnull) {
// when url is tracking link and failed
}];
if (!isHandled) {
// when url is not tracking link
}Attention
When you set up the Airbridge SDK to use tracking links within apps, every time a tracking link is used within the app, Deeplink Pageviews are aggregated as Target Events. The deep link performance may be affected when Deeplink Pageviews occur frequently right after Deeplink Opens.
The attribution window for Deeplink Pageviews is set to 3 days by default. If you want to change the attribution window for Deeplink Pageviews, contact your Airbridge CSM. If you don't have a designated CSM, contact the Airbridge Help Center.
Attention
It takes some time for the Airbridge SDK to collect attribution results. We do not recommend using attribution results for functionalities requiring real-time processing.
Use the Airbridge.setOnAttributionReceived function to get the attribution data of install events.
import { Airbridge } from 'airbridge-react-native-sdk'
...
Airbridge.setOnAttributionReceived((attribution) => {
// when attribution is received
})Depending on whether the attribution result exists or not, data is passed as follows.
If the attribution result exists, a dictionary including the values below will be passed to the callback. All keys provide the attribution data. For example, attributedChannel contains information about the ad channel to which the ad performance is attributed.
The attribution results are passed to the callback within 1 minute after SDK initialization. If the app is closed before the attribution result is passed, the previous attribution results will be passed to the callback within 1 minute the next time the app is launched. Depending on network conditions and other factors, there may be a delay of up to 5 minutes.
If there is no attribution result, the following dictionary will be sent to the callback. For this data to be passed, the app must be launched again at least 3 hours after the SDK initialization.
{
"attributedChannel": "unattributed"
}The Airbridge SDK collects deep link events when the app is opened through a deep link, even if the deep link is not an Airbridge Deep Link. Configure trackAirbridgeDeeplinkOnlyEnabled in the SDK settings to true to collect deep link events only if the app is opened through an Airbridge Deep Link and prevent unnecessary event collection.
To comply with the Digital Markets Act (DMA), the user consent data must be sent to Airbridge. For more information about the DMA and whether it applies to your service, refer to the Airbridge user guide.
Attention
Advertisers must collect user consent data from all existing and new users in the EEA at least once starting March 6, 2024.
If you are collecting user consent data using a consent management platform that complies with the Transparency and Consent Framework v2.2 protocol, refer to the following method to pass the user consent data to the Airbridge SDK.
Note
Expo SDK v.4.4.0 or later is required.
1. In the SDK settings, set the collectTCFDataEnabled to true and the autoStartTrackingEnabled to false.
{
"autoStartTrackingEnabled": false,
"collectTCFDataEnabled": true
}2. After the user consent data is stored in the consent management platform, call the startTracking function.
// Explicitly start tracking
Airbridge.startTracking()For all other cases, refer to the following method.
Note
Airbridge cannot provide guidance on storing the user consent data and implementing the prompts. For assistance, consult legal professionals.
1. Check the location of the users who launched the app. If their location is within the EEA, check whether the user consent data has been previously collected. If not, user consent data collection is not required.
In the SDK settings, set the autoStartTrackingEnabled to false
{
"autoStartTrackingEnabled": false
}2. If no user consent data has been collected previously, you may collect the data using a prompt or other means. The user consent data fields that need to be collected are adPersonalization, adUserData.
Send the user consent data and the user location data (eea) to the Airbridge SDK using the Airbridge.setDeviceAlias function.
import { Airbridge } from 'airbridge-react-native-sdk'
...
// deliver informations to sdk using device alias
// based on actual region
Airbridge.setDeviceAlias('eea', '0' or '1')
// based on actual user consent
Airbridge.setDeviceAlias('adPersonalization', '0' or '1')
Airbridge.setDeviceAlias('adUserData', '0' or '1')Refer to the table below for the user consent data and the user location data that need to be sent to the Airbridge SDK. Note that the Airbridge field names listed in the table below must be used to successfully send data.
3. After the user consent data and the user location data are sent to the Airbridge SDK, call the startTracking function.
// Explicitly start tracking
Airbridge.startTracking()Follow the steps below to use deferred deep linking in Meta ads. The Airbridge SDK collects the Meta deferred app links before it collects the Airbridge deferred deep links. If there are no Meta deferred app links, the Airbridge deferred deep links are collected.
Note that Meta does not support Meta deferred app links for SKAdNetwork campaigns.
1. Install the Facebook SDK by referring to the Meta ads documentation for iOS and Android.
2. Configure the trackMetaDeferredAppLinkEnabled in the SDK settings to true.
Attention
If the SDK is not enabled immediately after the SDK initialization, the Install, Open, and Deeplink Openbvevents may not be collected.
Upon initialization, all functions of the SDK are enabled by default. By configuring sdkEnabled in the SDK settings to false, the SDK can be initialized with all functions disabled.
You can also check the activation status of the Airbridge SDK and enable or disable all functions, as in the following example.
import { Airbridge } from 'airbridge-react-native-sdk'
...
Airbridge.isSDKEnabled()
Airbridge.enableSDK()
Airbridge.disableSDK()To collect the Meta Install Referrer, enter the Meta App ID as the key value for metaInstallReferrerAppID in the SDK settings.
Note that the decryption key must be submitted to the Airbridge dashboard to read the decrypted Meta Install Referrer. Refer to this user guide to learn how to enter the decryption key.
Airbridge sends a silent push every day between 3:00 PM and 4:00 PM (UTC) to users who performed an app event at least once in the last 6 months to check if the app has been deleted. You can check the uninstall event in the Airbridge reports and raw data export files.
Refer to the article below for the detailed setup instructions.
An additional SDK setup is required to integrate with some third-party solutions. It is recommended that you complete this setup before collecting data with the Airbridge SDK.
Refer to the articles listed below for integrating with third-party solutions.
The logs provided by the Airbridge SDK are categorized into Debug, Info, Warning, Error, and Fault levels. The Debug level is the least critical log, while the Fault level is the most critical log.
By default, the Airbridge SDK provides logs at Warning, Error, and Fault levels. By entering a specific log level as the setLogLevel value in the SDK settings, the logs from that specified level up to the Fault level will be available.