Skip to main content
The Tappd Mobile SDK is a React Native library that lets you track user behavior, manage sessions, and collect customer data across iOS and Android apps. Drop it into any React Native project and get full visibility into how users interact with your app — from first open to every screen view and custom event — without writing boilerplate infrastructure code.

​
Supported Platforms

The SDK supports the following environments:
  • iOS 12 and later
  • Android API level 21 and later
  • React Native 0.60 and later

​
Key Features

Automatic Session Management

Time-based sessions with a configurable inactivity timeout. New sessions start automatically when users return after a period of inactivity.

Anonymous User Tracking

Track users before they identify themselves. When they log in, the SDK automatically merges anonymous data with their profile.

Auto Screen Tracking

Record screen views automatically with React Navigation support, including time-on-screen duration.

Manual Event Tracking

Fire custom events anywhere in your app — purchases, button clicks, form submissions, or any action that matters to your business.

In-App Messages

Display banners, popups, and modals using native React Native components, triggered by user behavior or campaigns.

App Lifecycle Tracking

Automatically capture foreground, background, open, and close events without any extra code.

Deep Link & UTM Tracking

Track deep links and UTM parameters to measure the effectiveness of your marketing campaigns.

Comprehensive Device Info

Capture platform, OS version, and device details automatically. Pair with react-native-device-info for richer data.

Screen Duration Tracking

Measure exactly how long users spend on each screen to identify engagement patterns.

Push Notification Support

Register push tokens and manage notification subscriptions with built-in FCM and APNs support.

​
Installation

Install the SDK and its required peer dependency using npm or Yarn. 
npm install @tappd/mobile-sdk @react-native-async-storage/async-storage

​
iOS Setup

After installing, link the native dependencies for iOS by running CocoaPods. 
cd ios && pod install

​
Android Setup

Android requires no additional setup. The SDK uses React Native’s built-in APIs and works out of the box after the npm install.

​
Optional: Device Info Package

Install react-native-device-info to capture richer device metadata such as device model, manufacturer, and app version. 
npm install react-native-device-info
After installing react-native-device-info, run cd ios && pod install again to link the iOS native module.

​
Quick Example

Here’s what a minimal integration looks like after installation. 
import TappdSDK from '@tappd/mobile-sdk';

const tappd = new TappdSDK({
  appId: 'YOUR_APP_ID',
  apiUrl: 'https://sdk.gotappd.com/api/v1/sdk'
});

// Identify a user when they log in
await tappd.identify({
  external_id: 'user_123',
  email: 'john@example.com',
  name: 'John Doe'
});

// Track a screen view
await tappd.trackScreen('HomeScreen');

// Track a custom event
await tappd.track('button_click', { buttonId: 'signup' });

Getting Started

Follow the step-by-step quickstart to install, initialize, and verify the SDK in your React Native project.

Configuration

Explore every configuration option and learn how to set up environment-based configs.

Push Notifications

Register push tokens and manage FCM and APNs subscriptions.

In-App Messages

Set up banners, popups, and modals driven by your Tappd dashboard campaigns.