Treasure Data React Native SDK

td-react-native-sdk is React Native module that uses native iOS and Android SDK underneath to provide Treasure Data Mobile SDK features for React Native apps. You can see more detailed documentation in repositories for Treasure Data iOS SDK and Treasure Data Android SDK.

Getting started

$ npm install td-react-native-sdk --save

Mostly automatic installation

If you use react-native less than 0.60.0, you will have to link the module yourself: $ react-native link td-react-native-sdk

Usage

Configuration

import TreasureData from 'td-react-native-sdk';

TreasureData.setup({
  apiEndpoint: 'https://in.treasure-data.com', // Or other supported endpoints
  encryptionKey: 'xxxxx',
  apiKey: 'xxxxx', /// You should use write only api key
  defaultDatabase: 'default_database',
  defaultTable: 'default_table_name',
  cdpEndpoint: 'https://cdp.in.treasuredata.com' // Or other cdp endpoints
})

Add an event to local buffer

You can add custom events to a specific database and table. If database param is not specified, defaultDatabase configuration in TreasureData.setup({...}) will be used instead. Specify the database and table to which you want to import the events. The total length of database and table must be shorter than 129 characters.

const customEvent = {event: 'Custom event', data: new Date().getSeconds()};
TreasureData.addEvent(customEvent, 'table', 'database');
// or
TreasureData.addEvent(customEvent, 'table');

Or if you need to know when addEvent is successful or has failed, use addEventWithCallback instead. You can pass null or undefined as database param and defaultDatabase configuration in TreasureData.setup({...}) will be used instead.

const customEvent = {event: 'Custom event', data: new Date().getSeconds()};
TreasureData.addEventWithCallback(customEvent, 'table', 'database', () => {
  console.log('Add Event Successfully');
}, (errorCode, errorMessage) => {
  console.log('Add Event Failed', errorCode, errorMessage);
});

Upload buffered events to TreasureData

You can upload all buffered events to Treasure Data at anytime with uploadEvent function

TreasureData.uploadEvents();

Or if you need to know when uploadEvents is successful or has failed, use uploadEventsWithCallback instead.

TreasureData.uploadEventsWithCallback(() => {
  console.log('Upload events successfully')
}, (errorCode, errorMessage) => {
  console.log('Failed to upload events', errorCode, errorMessage);
});

Custom Events

Add and upload custom events are enabled by default. However you can disable and enable this feature at any time using:

TreasureData.enableCustomEvent();

To disable custom events

TreasureData.disableCustomEvent();

(Android only) Track app lifecycle events automatically

This feature is only available in Android. App lifecycle event tracking is optional and not enable by default. You can track app lifecycle events automatically using:

TreasureData.enableAppLifecycleEvent();

To disable tracking app lifecycle events:

TreasureData.disableAppLifecycleEvent();

To check if tracking app lifecycle events is enabled:

TreasureData.isAppLifecycleEventEnabled((enabled) => {
  console.log('Tracking app lifecycle event is enabled?', enabled);
})

Track in app purchase events automatically

You don’t need to check for platform when calling this feature’s APIs, they will simply be no-op. In app purchase event tracking is optional and not enable by default. To track in app purchase events automatically, you only need to add a line of code:

TreasureData.enableInAppPurchaseEvent();

To disable tracking in app purchase events:

TreasureData.disableInAppPurchaseEvent();

To check if tracking in app purchase events is enabled:

TreasureData.isInAppPurchaseEventEnabled((enabled) => {
  console.log('Tracking in app purchase event is enabled?', enabled);
})

Adding UUID of the device to each event automatically

UUID of the device will be added to each event automatically if you call TreasureData.enableAutoAppendUniqId(). This value won’t change until the application is uninstalled.

TreasureData.enableAutoAppendUniqId();

To disable adding UUID of device to each event automatically:

TreasureData.disableAutoAppendUniqId();

To reset UUID of device

TreasureData.resetUniqId();

Adding an UUID to each event record automatically

UUID will be added to each event record automatically if you call enableAutoAppendRecordUUID. Each event has different UUID.

TreasureData.enableAutoAppendRecordUUID();

To disable adding record UUID to each event automatically:

TreasureData.disableAutoAppendRecordUUID();

Adding Advertising Id to each event record automatically

Advertising Id will be added to each event record automatically if you call enableAutoAppendAdvertisingIdentifier.

In Android, you must install Google Play Service Ads (Gradle com.google.android.gms:play-services-ads) as a dependency for this feature to work.

In iOS, you must link Ad Support framework in Link Binary With Libraries build phase for this feature to work.

User must also not turn on Limit Ad Tracking feature in their device, otherwise, Treasure Data will not attach Advertising Id to the record. Due to asynchronous nature of getting Advertising Id, after enableAutoAppendAdvertisingIdentifier method called, it may take some time for Advertising Id to be available to be added to the record. However, Treasure Data does cache the Advertising Id in order to add to the next event without having to wait for the fetch Advertising Id task to complete.

TreasureData.enableAutoAppendAdvertisingIdentifier();
// Or specify custom column
TreasureData.enableAutoAppendAdvertisingIdentifier('custom_aaid_column');

To disable adding Advertising Id:

TreasureData.disableAutoAppendAdvertisingIdentifier();

Adding device model information to each event automatically

To add device model information to each event automatically

TreasureData.enableAutoAppendModelInformation();

To disable:

TreasureData.disableAutoAppendModelInformation();

Adding application package version information to each event automatically

To add application version information to each event automatically

TreasureData.enableAutoAppendAppInformation();

To disable:

TreasureData.disableAutoAppendAppInformation();

Adding locale configuration information to each event automatically

To add locale configuration information to each event automatically

TreasureData.enableAutoAppendLocaleInformation();

To disable:

TreasureData.disableAutoAppendLocaleInformation();

Use server side upload timestamp

To use server side upload timestamp not only client device time that is recorded when your application calls addEvent

TreasureData.enableServerSideUploadTimestamp();
// Or specify custom column
TreasureData.enableServerSideUploadTimestamp('custom_servier_side_upload_timestamp_column');

To disable:

TreasureData.disableServerSideUploadTimestamp();

Start/End session

Call startSession to start tracking a session

TreasureData.startSession(sessionTable, sessionDatabase);

Call endSession to end tracking current session

TreasureData.endSession(sessionTable, sessionDatabase);

Profile API

This feature is not enabled on accounts by default, please contact support for more information. Important! You must set cdpEndpoint property of TreasureData’s sharedInstance. Usage example:

TreasureData.fetchUserSegments(audienceTokens, keys, (jsonResponse) => {
  console.log('Fetch User Segments', JSON.stringify(jsonResponse));
}, (errorCode, errorMessage) => {
  console.log('Failed to upload events', 'Error: ' + errorCode + ' ' + errorMessage);
});

Enable/Disable debug log

To enable debug log

TreasureData.enableLogging();

To disable:

TreasureData.disableLogging();

Enable/Disable retry uploading

To enable retry uploading

TreasureData.enableRetryUploading();

To disable:

TreasureData.disableRetryUploading();

Device and OS support

See native SDKs repository for more information about supported devices and OS

Download Details:

Author: treasure-data

Source Code: https://github.com/treasure-data/td-react-native-sdk

#react-native #react #mobile-apps