Mobile SDK Overview

The Tappd Mobile SDK is a React Native library for tracking user behavior, managing sessions, and collecting customer data in iOS and Android applications.

Features

✅ Automatic Session Management - Time-based sessions with configurable timeout
✅ Anonymous User Tracking - Track users before identification, automatically merge data
✅ Auto Screen Tracking - Automatic screen view tracking with React Navigation support
✅ Manual Event Tracking - Track custom events throughout your application
✅ In-App Messages - Display banners, popups, and modals with React Native components
✅ App Lifecycle Tracking - Automatic foreground/background event tracking
✅ Deep Link Tracking - Automatic deep link and UTM parameter tracking
✅ Comprehensive Device Info - Platform, OS version, and device information
✅ Screen Duration Tracking - Track time spent on screens
✅ Push Notification Support - Register push tokens and check subscription status

Installation

npm install @tappd/mobile-sdk @react-native-async-storage/async-storage

iOS Setup

cd ios && pod install

Android Setup

No additional setup required. The SDK uses React Native's built-in APIs.

Quick Start

1. Get Your App ID from your Tappd Dashboard
2. Initialize the SDK in your application
3. Identify users when they log in
4. Track screens and events throughout your app

import TappdSDK from '@tappd/mobile-sdk';

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

// Identify user
await tappd.identify({
  external_id: 'user_123',  // Your internal user ID
  email: 'john@example.com',
  name: 'John Doe'
});

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

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

Supported Platforms

• ✅ iOS 12+
• ✅ Android API 21+
• ✅ React Native 0.60+

What's Next?

• Getting Started Guide - Detailed setup instructions
• Banners - Display placement-based banners with targeting and A/B testing
• In-App Messages - Display personalized messages to users
• API Reference - Complete API documentation
• Push Notifications - Push notification setup
• Examples - Code examples for React Native