The React Native SDK allows you to integrate event tracking and lookup into iOS and Android mobile apps built with React Native.

INFO: To make use of this SDK, please contact your Qubit Customer Success representative.

1. $ npm install qubit-sdk-react-native --save or $ yarn add qubit-sdk-react-native

2. Navigate to your /ios directory and run pod install to ensure the QubitSDK CocoaPod is installed. Android should require no further installation.

3. If you are using React Native < 0.60, you must link the library: $ react-native link qubit-sdk-react-native

Import the whole library in your javascript files:

import QubitSDK from 'qubit-sdk-react-native';

Initialize the SDK:

QubitSDK.start("qubit");

Send the first event:

QubitSDK.sendEvent("ecView", { "type": "button", "value": "click" });

Initialization of the SDK. It should be called as early as possible after application start, only once, and before any other interaction with the API.

QubitSDK.start("qubit", "DEBUG");

• Returns void None

Sends event to the server.

QubitSDK.sendEvent("ecView", { "type": "button", "value": "click" });

• Returns void None

Enables or disables receiving events.

QubitSDK.enable(false);

• Returns void None

Returns trackingId. Use for debug purposes.

async () => {
 const trackingId = await QubitSDK.getTrackingId();
 ...
}

• Returns Promise<string>. Promise with String trackingId

Returns deviceId established by the SDK. Use for debug purposes.

async () => {
 const deviceId = await QubitSDK.getDeviceId();
 ...
}

• Returns Promise<string>. Promise with String deviceId

Returns current Lookup Data. Used for debug purposes.

async () => {
 const lookupData = await QubitSDK.getLookupData();
 ...
}

{ viewNumber: 10,
 sessionNumber: 4,
 lastViewTs: 1863218003,
 ipLocation:
  { regionCode: '36004',
    region: 'unknown',
    longitude: 19.9612,
    latitude: 50.0495,
    countryCode: 'PL',
    country: 'poland',
    cityCode: '1803',
    city: 'krakow',
    areaCode: 'unknown',
    area: 'unknown' },
 ipAddress: '93.180.179.112',
 firstViewTs: 1696635454
}

• Returns Promise[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String). Promise with object. Although it returns Promise, it returns a value only if SDK has these information at the moment of the function call.

Returns list of Experiences.

async () => {
 const experiences = await QubitSDK.getExperiences([], 0, false, false);
 experiences.forEach(e => e.shown());
 ...
}

{ variation: 852190,
   payload: {},
   isControl: false,
   id: 143640,
   callback: 'https://sse.qubit.com/v1/callback?data=igKAeyJFeHBlcmllbmNlSWQiOjE0MzY0MCwiSXRlcmF0aW9uARUsMzc2MDY3LCJWYXJpFRUUODUyNzc0HRUUTWFzdGVyATAQODUyMTkBRXBzQ29udHJvbCI6ZmFsc2UsIlRyYWZmaWNBbGxvYwVKTCI6MC40NzUsIlByb2JhYmlsaXR5ARRQODI1NjI2MTk0NTgyNDQ5MSwiUGlkVhkAGFRlbXBsYXQFvwxudWxsBWZMY2tpbmdJZCI6Im1pcXVpZG8iLCIBjQhleHQFFkQ4MmFjYzNiY2FiYmNhYzM2In0='
 },
{ variation: 855620,
   payload: { show_share: false,
     show_sale_banner: false,
     sale_banner: 'https://dd6zx4ibq538k.cloudfront.net/static/images/5010/626263d0b3d3230f4062da1e0d1395ad_1300_554.jpeg',
    free_shipping: 'Shipping is free for you!' },
   isControl: false,
   id: 144119,
   callback: 'https://sse.qubit.com/v1/callback?data=jAKAeyJFeHBlcmllbmNlSWQiOjE0NDExOSwiSXRlcmF0aW9uARUsNDUyOTEwLCJWYXJpFRUYMTAxMDcyMh0WFE1hc3RlcgExmDg1NTYyMCwiSXNDb250cm9sIjpmYWxzZSwiVHJhZmZpY0FsbG9jYQFgSCI6MC4yNSwiUHJvYmFiaWxpdHkBE2A0ODAwMTM4OTg0MjEwNjM3MywiUGlkIjowThoAGFRlbXBsYXQFwQxudWxsBWdMY2tpbmdJZCI6Im1pcXVpZG8iLCIBjghleHQFFkQ4MmFjYzNiY2FiYmNhYzM2In0='
 },
{ variation: 972984,
   payload: {},
   isControl: true,
   id: 160862,
   callback: 'https://sse.qubit.com/v1/callback?data=iQKAeyJFeHBlcmllbmNlSWQiOjE2MDg2MiwiSXRlcmF0aW9uARUsNDM0NjIzLCJWYXJpFRUUOTcyOTg0HRUUTWFzdGVyATARG3BJc0NvbnRyb2wiOnRydWUsIlRyYWZmaWNBbGxvYwVJRCI6MC41LCJQcm9iYWJpbGl0eQESVDAzNjQzMTAyMTQ3MTU5ODkyLCJQaWRaGgAYVGVtcGxhdAW-DG51bGwFZhBja2luZwGLKCJtaXF1aWRvIiwiAYwIZXh0BRZEODJhY2MzYmNhYmJjYWMzNiJ9'
 }
]

• Returns Promise<array<Experience>>. Promise with an array of Experience objects.

Qubit SDK React Native is compatible with React Native 0.58 and higher.

Qubit website
Qubit Android SDK on Github
Qubit iOS SDK on Github