sift-react-native

Sift React Native SDK

React Native wrapper for Sift iOS and Android SDKs

Table of Contents

• Requirements
• Installation
• Usage
• API Reference
• Example App
• License
• Support

Requirements

• Node.js: 22.0.0 or higher
• React Native: 0.60.0 or higher
• React: 16.8.0 or higher

iOS

• iOS: 13.4 or higher
• CocoaPods: Latest version recommended

Android

• Android SDK: API level 24 (Android 7.0) or higher
• Kotlin: 1.6.0 or higher
• Java: 8 or higher

Installation

# Using npm
npm install sift-react-native

# OR using Yarn
yarn add sift-react-native

iOS Setup

Add the Sift pod to your ios/Podfile:

pod 'Sift'

Then install CocoaPods dependencies:

cd ios
pod install
cd ..

Android Setup

No additional setup required. The Android SDK will be automatically linked.

Usage

Basic Integration

import React, { useEffect } from 'react';
import SiftReactNative from 'sift-react-native';

const App = () => {
  useEffect(() => {
    // Initialize Sift when app starts
    SiftReactNative.setSiftConfig(
      'your-account-id',
      'your-beacon-key',
      false, // Allow location collection
      'https://api3.siftscience.com/v3/accounts/%s/mobile_events'
    );
  }, []);

  const handleUserLogin = (userId: string) => {
    SiftReactNative.setUserId(userId);
    SiftReactNative.upload();
  };

  const handleUserLogout = () => {
    SiftReactNative.unsetUserId();
  };

  return (
    // Your app components
  );
};

API Reference

setSiftConfig(accountId, beaconKey, disallowLocationCollection, serverUrlFormat)

Initializes the Sift SDK with your credentials.

Parameters:

• accountId (string): Your Sift account ID
• beaconKey (string): Your Sift beacon key
• disallowLocationCollection (boolean): Set to true to disable location collection
• serverUrlFormat (string): Server URL format (default: 'https://api3.siftscience.com/v3/accounts/%s/mobile_events')

setUserId(userId)

Sets the user ID for tracking.

Parameters:

• userId (string): The user identifier

unsetUserId()

Clears the current user ID. Call this when a user logs out.

upload()

Manually uploads collected data to Sift. The SDK automatically uploads data periodically, but you can call this method to force an immediate upload.

Example App

To see the SDK in action, check out the example app in the example/ directory. See the example/README.md for setup and running instructions.

License

MIT License - see LICENSE file for details.

Support

For technical support and questions:

• Documentation: Sift Developer Docs
• Issues: GitHub Issues
• Email: [e-mail]