@datalyr/react-native 1.1.1 → 1.2.1

package/src/types.ts

@@ -7,6 +7,39 @@ export interface AutoEventConfig {
   sessionTimeoutMs?: number;
 }
 
+// Meta (Facebook) SDK Configuration
+export interface MetaConfig {
+  appId: string;                     // Facebook App ID
+  clientToken?: string;              // Client Token for advanced features
+  enableDeferredDeepLink?: boolean;  // Default: true
+  enableAppEvents?: boolean;         // Default: true
+  advertiserTrackingEnabled?: boolean; // iOS ATT status (auto-detected if not set)
+}
+
+// TikTok SDK Configuration
+export interface TikTokConfig {
+  appId: string;                     // Your App ID (for Datalyr)
+  tiktokAppId: string;               // TikTok App ID
+  accessToken?: string;              // Access Token for Events API
+  enableAppEvents?: boolean;         // Default: true
+}
+
+// Deferred Deep Link Result (from platform SDKs)
+export interface DeferredDeepLinkResult {
+  url?: string;
+  source?: string;
+  fbclid?: string;
+  ttclid?: string;
+  utmSource?: string;
+  utmMedium?: string;
+  utmCampaign?: string;
+  utmContent?: string;
+  utmTerm?: string;
+  campaignId?: string;
+  adsetId?: string;
+  adId?: string;
+}
+
 // Core SDK Configuration
 export interface DatalyrConfig {
   apiKey: string; // Required for server-side tracking
@@ -33,6 +66,12 @@ export interface DatalyrConfig {
     retryDelay: number;
   };
   skadTemplate?: 'ecommerce' | 'gaming' | 'subscription';
+
+  // Meta (Facebook) SDK Configuration
+  meta?: MetaConfig;
+
+  // TikTok SDK Configuration
+  tiktok?: TikTokConfig;
 }
 // Event Types
 export interface EventData {

package/src/utils-expo.ts

@@ -9,13 +9,16 @@ import { v4 as uuidv4 } from 'uuid';
 // Storage keys
 export const STORAGE_KEYS = {
   VISITOR_ID: '@datalyr/visitor_id',
+  ANONYMOUS_ID: '@datalyr/anonymous_id',  // Persistent anonymous identifier
   SESSION_ID: '@datalyr/session_id',
   SESSION_START: '@datalyr/session_start',
   USER_ID: '@datalyr/user_id',
   USER_PROPERTIES: '@datalyr/user_properties',
+  EVENT_QUEUE: '@datalyr/event_queue',
   ATTRIBUTION_DATA: '@datalyr/attribution_data',
   INSTALL_TIME: '@datalyr/install_time',
   LAST_APP_VERSION: '@datalyr/last_app_version',
+  LAST_SESSION_TIME: '@datalyr/last_session_time',
   DEVICE_ID: '@datalyr/device_id',
 } as const;
 
@@ -136,17 +139,17 @@ const getOrCreateDeviceId = async (): Promise<string> => {
   }
 };
 
-// Visitor ID management  
+// Visitor ID management
 export const getOrCreateVisitorId = async (): Promise<string> => {
   try {
     let visitorId = await Storage.getItem<string>(STORAGE_KEYS.VISITOR_ID);
-    
+
     if (!visitorId) {
       visitorId = generateUUID();
       await Storage.setItem(STORAGE_KEYS.VISITOR_ID, visitorId);
       debugLog('Created new visitor ID:', visitorId);
     }
-    
+
     return visitorId;
   } catch (error) {
     errorLog('Error managing visitor ID:', error as Error);
@@ -154,6 +157,25 @@ export const getOrCreateVisitorId = async (): Promise<string> => {
   }
 };
 
+// Anonymous ID management - persistent across app reinstalls
+export const getOrCreateAnonymousId = async (): Promise<string> => {
+  try {
+    let anonymousId = await Storage.getItem<string>(STORAGE_KEYS.ANONYMOUS_ID);
+
+    if (!anonymousId) {
+      // Generate anonymous_id with anon_ prefix to match web SDK
+      anonymousId = `anon_${generateUUID()}`;
+      await Storage.setItem(STORAGE_KEYS.ANONYMOUS_ID, anonymousId);
+      debugLog('Created new anonymous ID:', anonymousId);
+    }
+
+    return anonymousId;
+  } catch (error) {
+    errorLog('Error managing anonymous ID:', error as Error);
+    return `anon_${generateUUID()}`;
+  }
+};
+
 // Session management
 export const getOrCreateSessionId = async (): Promise<string> => {
   try {

package/src/utils-interface.ts

@@ -0,0 +1,38 @@
+/**
+ * Interface for SDK utilities
+ * Both utils.ts and utils-expo.ts implement this interface
+ */
+
+import { DeviceInfo, FingerprintData } from './types';
+
+export interface SDKUtils {
+  STORAGE_KEYS: {
+    VISITOR_ID: string;
+    ANONYMOUS_ID: string;
+    SESSION_ID: string;
+    USER_ID: string;
+    USER_PROPERTIES: string;
+    EVENT_QUEUE: string;
+    ATTRIBUTION_DATA: string;
+    LAST_SESSION_TIME: string;
+  };
+
+  generateUUID: () => string;
+  getOrCreateVisitorId: () => Promise<string>;
+  getOrCreateAnonymousId: () => Promise<string>;
+  getOrCreateSessionId: () => Promise<string>;
+  getDeviceInfo: () => Promise<DeviceInfo>;
+  createFingerprintData: () => Promise<FingerprintData>;
+  getNetworkType: () => string | Promise<string>;
+  validateEventName: (eventName: string) => boolean;
+  validateEventData: (eventData: any) => boolean;
+  debugLog: (message: string, ...args: any[]) => void;
+  errorLog: (message: string, error?: Error) => void;
+
+  Storage: {
+    setItem: (key: string, value: any) => Promise<void>;
+    getItem: <T>(key: string) => Promise<T | null>;
+    removeItem: (key: string) => Promise<void>;
+    clear?: () => Promise<void>;
+  };
+}

package/EXPO_INSTALL.md

@@ -1,297 +0,0 @@
-# Datalyr Expo SDK - Installation Guide
-
-## Expo Compatibility
-
-The Datalyr SDK works with all Expo workflows:
-
-- **Expo Bare Workflow** - Full compatibility (use regular React Native SDK)
-- **Expo Managed Workflow** - Requires Expo-specific setup (this guide)
-- **Expo Go** - Limited compatibility due to native dependencies
-
-## Quick Setup for Expo Managed Workflow
-
-### 1. Install Expo Dependencies
-
-```bash
-# Navigate to your Expo project
-cd your-expo-app
-
-# Install Expo-compatible dependencies
-npx expo install @react-native-async-storage/async-storage
-npx expo install expo-application
-npx expo install expo-constants  
-npx expo install expo-device
-npx expo install expo-network
-npx expo install expo-tracking-transparency
-npx expo install react-native-get-random-values
-
-# Install additional dependencies
-npm install uuid
-npm install --save-dev @types/uuid
-```
-
-### 2. Update app.json/app.config.js
-
-Add required permissions and configuration:
-
-```json
-{
-  "expo": {
-    "name": "Your App",
-    "version": "1.0.0",
-    "permissions": [
-      "INTERNET",
-      "ACCESS_NETWORK_STATE"
-    ],
-    "ios": {
-      "infoPlist": {
-        "NSUserTrackingUsageDescription": "This app uses tracking to provide personalized ads and analytics.",
-        "CFBundleURLTypes": [
-          {
-            "CFBundleURLName": "your.app.identifier",
-            "CFBundleURLSchemes": ["yourappscheme"]
-          }
-        ]
-      }
-    },
-    "android": {
-      "permissions": [
-        "INTERNET",
-        "ACCESS_NETWORK_STATE"
-      ],
-      "intentFilters": [
-        {
-          "action": "VIEW",
-          "autoVerify": true,
-          "data": [
-            {
-              "scheme": "yourappscheme"
-            }
-          ],
-          "category": [
-            "BROWSABLE",
-            "DEFAULT"
-          ]
-        }
-      ]
-    }
-  }
-}
-```
-
-### 3. Copy Expo-Compatible SDK Files
-
-```bash
-# Create SDK directory
-mkdir -p src/datalyr-sdk
-
-# Copy the Expo-compatible files
-# You'll need to create these based on the original SDK but using Expo APIs
-```
-
-### 4. Initialize in Your Expo App
-
-```typescript
-// App.tsx
-import React, { useEffect } from 'react';
-import 'react-native-get-random-values'; // Important: Must be imported first
-import { datalyr } from '@datalyr/react-native-sdk';
-
-const App: React.FC = () => {
-  useEffect(() => {
-    initializeDatalyr();
-  }, []);
-
-  const initializeDatalyr = async () => {
-    try {
-      await datalyr.initialize({
-        workspaceId: 'ozLZblQ8hN', // Your workspace ID
-        apiKey: 'dk_your_api_key', // Required for authentication
-        debug: true,
-        enableAttribution: true,    // ✅ Deep link attribution tracking
-        autoEvents: {
-          trackSessions: true,          // ✅ Automatic session tracking
-          trackScreenViews: true,       // ✅ Automatic screen tracking  
-          trackAppUpdates: true,        // ✅ App version changes
-          trackPerformance: true,       // ✅ App launch time, performance
-          sessionTimeoutMs: 30 * 60 * 1000, // 30 minutes
-        },
-      });
-      
-      console.log('Datalyr Expo SDK initialized with auto-events!');
-    } catch (error) {
-      console.error('SDK init failed:', error);
-    }
-  };
-
-  // ... rest of your app
-};
-
-export default App;
-```
-
-## Expo vs React Native CLI Differences
-
-| Feature | React Native CLI | Expo Managed | Expo Bare |
-|---------|------------------|--------------|-----------|
-| Device Info | `react-native-device-info` | `expo-device` + `expo-application` | `react-native-device-info` |
-| IDFA/GAID | `react-native-idfa` | `expo-tracking-transparency` + setup | `react-native-idfa` |
-| Network Detection | `@react-native-community/netinfo` | `expo-network` | `@react-native-community/netinfo` |
-| Storage | `@react-native-async-storage/async-storage` | Same ✅ | Same ✅ |
-| Attribution | Full support ✅ | Full support ✅ | Full support ✅ |
-| Auto Events | Full support ✅ | Full support ✅ | Full support ✅ |
-
-## Expo-Specific Features
-
-### 1. Device Information
-```typescript
-// Uses expo-device and expo-application instead of react-native-device-info
-import * as Device from 'expo-device';
-import * as Application from 'expo-application';
-
-const deviceInfo = {
-  model: Device.modelName,
-  manufacturer: Device.manufacturer,
-  osVersion: Device.osVersion,
-  appVersion: Application.nativeApplicationVersion,
-  buildNumber: Application.nativeBuildVersion,
-  bundleId: Application.applicationId,
-  isEmulator: !Device.isDevice,
-};
-```
-
-### 2. IDFA Permission (iOS)
-```typescript
-// Uses expo-tracking-transparency for iOS IDFA permission
-import * as TrackingTransparency from 'expo-tracking-transparency';
-
-const requestIDFAPermission = async () => {
-  if (Platform.OS === 'ios') {
-    const { status } = await TrackingTransparency.requestTrackingPermissionsAsync();
-    return status === TrackingTransparency.PermissionStatus.GRANTED;
-  }
-  return false;
-};
-```
-
-### 3. Network Detection
-```typescript
-// Uses expo-network instead of @react-native-community/netinfo
-import * as Network from 'expo-network';
-
-const getNetworkType = async () => {
-  const networkState = await Network.getNetworkStateAsync();
-  return networkState.type; // 'WIFI', 'CELLULAR', etc.
-};
-```
-
-## Attribution Setup for Expo
-
-Deep links work the same way, but configuration is in `app.json`:
-
-### Test URLs (Same as React Native)
-```typescript
-// Test with Datalyr LYR tags
-const lyrUrl = 'yourappscheme://open?lyr=expo_campaign&utm_source=facebook&fbclid=abc123';
-
-// Test Facebook attribution  
-const facebookUrl = 'yourappscheme://open?utm_source=facebook&utm_campaign=summer_sale&fbclid=IwAR123abc';
-
-// Test TikTok attribution
-const tiktokUrl = 'yourappscheme://open?utm_source=tiktok&utm_campaign=viral_video&ttclid=tiktok123xyz';
-
-// Test Google attribution
-const googleUrl = 'yourappscheme://open?utm_source=google&utm_campaign=brand_search&gclid=google456def';
-```
-
-## Testing with Expo
-
-### Development
-```bash
-# Start Expo development server
-npx expo start
-
-# Test on device/simulator
-npx expo start --ios
-npx expo start --android
-```
-
-### Production Testing
-```bash
-# Build for testing
-eas build --platform ios --profile preview
-eas build --platform android --profile preview
-
-# Submit to stores
-eas submit --platform ios
-eas submit --platform android
-```
-
-## Expo Limitations
-
-### What Works:
-- Event tracking and attribution
-- Session management  
-- Screen view tracking
-- App lifecycle events
-- Deep link attribution
-- Basic device fingerprinting
-
-### Limitations:
-- **IDFA/GAID Collection** - Requires additional setup
-- **Advanced Device Info** - Some properties not available in managed workflow
-- **Carrier Information** - Not available in managed workflow
-- **Custom Native Modules** - Not available in managed workflow
-
-## Recommended Setup
-
-### For Maximum Compatibility:
-1. **Use Expo Bare Workflow** - Get full React Native CLI features
-2. **Or use regular React Native CLI** - Best for attribution tracking
-
-### For Managed Workflow:
-1. **Accept some limitations** - IDFA/GAID might need additional setup  
-2. **Core attribution still works** - LYR tags, UTM params, click IDs
-3. **Automatic events work fully** - Sessions, screen views, app lifecycle
-
-## Expected Events in Dashboard
-
-Events will appear in your Datalyr dashboard with `source: 'mobile_app'`:
-
-**Automatic Events:**
-- `session_start` - New user session
-- `session_end` - Session ended with stats  
-- `pageviews` - Screen navigation
-- `app_install` - First app launch with attribution
-- `app_update` - App version changes
-- `app_foreground`/`app_background` - App lifecycle
-- `sdk_initialized` - SDK setup complete
-
-**Manual Events:**
-- Custom events from `datalyr.track()`
-- User identification from `datalyr.identify()`
-
-## Choosing Between Expo and React Native CLI
-
-### Choose **React Native CLI** if:
-- You need full IDFA/GAID support
-- You want maximum attribution accuracy  
-- You're comfortable with native development
-- You need custom native modules
-
-### Choose **Expo Managed** if:
-- You want easier development and deployment
-- Core attribution (LYR tags, UTM, click IDs) is sufficient
-- You're okay with some device fingerprinting limitations
-- You prioritize development speed over maximum tracking
-
-### Choose **Expo Bare** if:
-- You want the best of both worlds
-- You can use the full React Native CLI SDK
-- You like Expo's build and deployment tools
-
----
-
-**Ready to test?** Your Expo app with automatic attribution is ready!
-
-The SDK provides 90% of the attribution value even with Expo's managed workflow limitations.