@datalyr/react-native 1.0.5 → 1.1.0

package/README.md

@@ -14,6 +14,7 @@ Official Datalyr SDK for React Native & Expo - Mobile attribution tracking and a
 - 💾 **Offline Support** - Events saved and retried when reconnected
 - 🔒 **Privacy First** - GDPR/CCPA compliant
 - ⚡ **Lightweight** - < 100KB, minimal battery impact
+- 🆔 **Identity Resolution** - Persistent anonymous ID links web → mobile → server events
 
 ## Installation
 
@@ -164,6 +165,35 @@ await Datalyr.setAttributionData({
 });
 ```
 
+## Identity Resolution (New in v1.1.0)
+
+The SDK now includes persistent anonymous IDs for complete user journey tracking:
+
+```typescript
+// Get anonymous ID (persists across app sessions)
+const anonymousId = Datalyr.getAnonymousId();
+
+// Pass to your backend for attribution preservation
+await fetch('/api/purchase', {
+  method: 'POST',
+  body: JSON.stringify({
+    items: cart,
+    anonymous_id: anonymousId  // Links server events to mobile events
+  })
+});
+
+// Identity is automatically linked when you identify a user
+await Datalyr.identify('user_123', {
+  email: 'user@example.com'
+});
+// This creates a $identify event that links anonymous_id to user_id
+```
+
+### Key Benefits:
+- **Attribution Preservation**: Never lose fbclid, gclid, ttclid, or lyr tracking
+- **Complete Journey**: Track users from web → app → server
+- **Automatic Linking**: Identity resolution happens automatically
+
 ## Session Management
 
 Sessions are tracked automatically with a 30-minute timeout.

package/lib/datalyr-sdk.d.ts

@@ -45,11 +45,16 @@ export declare class DatalyrSDK {
         initialized: boolean;
         workspaceId: string;
         visitorId: string;
+        anonymousId: string;
         sessionId: string;
         currentUserId?: string;
         queueStats: any;
         attribution: any;
     };
+    /**
+     * Get the persistent anonymous ID
+     */
+    getAnonymousId(): string;
     /**
      * Get detailed attribution data
      */
@@ -151,11 +156,13 @@ export declare class Datalyr {
         initialized: boolean;
         workspaceId: string;
         visitorId: string;
+        anonymousId: string;
         sessionId: string;
         currentUserId?: string;
         queueStats: any;
         attribution: any;
     };
+    static getAnonymousId(): string;
     static getAttributionData(): AttributionData;
     static setAttributionData(data: Partial<AttributionData>): Promise<void>;
     static getCurrentSession(): SessionData | null;

package/lib/datalyr-sdk.js

@@ -1,5 +1,5 @@
 import { Platform, AppState } from 'react-native';
-import { getOrCreateVisitorId, getOrCreateSessionId, createFingerprintData, generateUUID, getDeviceInfo, getNetworkType, validateEventName, validateEventData, debugLog, errorLog, Storage, STORAGE_KEYS, } from './utils';
+import { getOrCreateVisitorId, getOrCreateAnonymousId, getOrCreateSessionId, createFingerprintData, generateUUID, getDeviceInfo, getNetworkType, validateEventName, validateEventData, debugLog, errorLog, Storage, STORAGE_KEYS, } from './utils';
 import { createHttpClient, HttpClient } from './http-client';
 import { createEventQueue, EventQueue } from './event-queue';
 import { attributionManager } from './attribution';
@@ -27,6 +27,7 @@ export class DatalyrSDK {
                 respectDoNotTrack: true,
             },
             visitorId: '',
+            anonymousId: '', // Persistent anonymous identifier
             sessionId: '',
             userProperties: {},
             eventQueue: [],
@@ -70,8 +71,9 @@ export class DatalyrSDK {
                 flushInterval: this.state.config.flushInterval || 30000,
                 maxRetryCount: this.state.config.maxRetries || 3,
             });
-            // Initialize visitor ID and session
+            // Initialize visitor ID, anonymous ID and session
             this.state.visitorId = await getOrCreateVisitorId();
+            this.state.anonymousId = await getOrCreateAnonymousId();
             this.state.sessionId = await getOrCreateSessionId();
             // Load persisted user data
             await this.loadPersistedUserData();
@@ -128,6 +130,7 @@ export class DatalyrSDK {
             debugLog('Datalyr SDK initialized successfully', {
                 workspaceId: this.state.config.workspaceId,
                 visitorId: this.state.visitorId,
+                anonymousId: this.state.anonymousId,
                 sessionId: this.state.sessionId,
             });
         }
@@ -191,9 +194,10 @@ export class DatalyrSDK {
             this.state.userProperties = { ...this.state.userProperties, ...properties };
             // Persist user data
             await this.persistUserData();
-            // Track identify event
-            await this.track('identify', {
+            // Track $identify event for identity resolution
+            await this.track('$identify', {
                 userId,
+                anonymous_id: this.state.anonymousId,
                 ...properties
             });
         }
@@ -214,6 +218,7 @@ export class DatalyrSDK {
                 newUserId,
                 previousId: previousId || this.state.visitorId,
                 visitorId: this.state.visitorId,
+                anonymousId: this.state.anonymousId, // Include for identity resolution
             };
             debugLog('Aliasing user:', aliasData);
             // Track alias event
@@ -265,12 +270,19 @@ export class DatalyrSDK {
             initialized: this.state.initialized,
             workspaceId: this.state.config.workspaceId || '',
             visitorId: this.state.visitorId,
+            anonymousId: this.state.anonymousId,
             sessionId: this.state.sessionId,
             currentUserId: this.state.currentUserId,
             queueStats: this.eventQueue.getStats(),
             attribution: attributionManager.getAttributionSummary(),
         };
     }
+    /**
+     * Get the persistent anonymous ID
+     */
+    getAnonymousId() {
+        return this.state.anonymousId;
+    }
     /**
      * Get detailed attribution data
      */
@@ -383,11 +395,14 @@ export class DatalyrSDK {
         const payload = {
             workspaceId: this.state.config.workspaceId || 'mobile_sdk',
             visitorId: this.state.visitorId,
+            anonymousId: this.state.anonymousId, // Include persistent anonymous ID
             sessionId: this.state.sessionId,
             eventId: generateUUID(),
             eventName,
             eventData: {
                 ...eventData,
+                // Include anonymous_id in event data for attribution
+                anonymous_id: this.state.anonymousId,
                 // Auto-captured mobile data
                 platform: Platform.OS === 'ios' || Platform.OS === 'android' ? Platform.OS : 'android',
                 os_version: deviceInfo.osVersion,
@@ -578,6 +593,9 @@ export class Datalyr {
     static getStatus() {
         return datalyr.getStatus();
     }
+    static getAnonymousId() {
+        return datalyr.getAnonymousId();
+    }
     static getAttributionData() {
         return datalyr.getAttributionData();
     }

package/lib/http-client.js

@@ -167,6 +167,7 @@ export class HttpClient {
             const testPayload = {
                 workspaceId: 'test',
                 visitorId: 'test',
+                anonymousId: 'test',
                 sessionId: 'test',
                 eventId: 'test',
                 eventName: 'connection_test',

package/lib/types.d.ts

@@ -59,6 +59,7 @@ export interface FingerprintData {
 export interface EventPayload {
     workspaceId: string;
     visitorId: string;
+    anonymousId: string;
     sessionId: string;
     eventId: string;
     eventName: string;
@@ -81,6 +82,7 @@ export interface SDKState {
     initialized: boolean;
     config: DatalyrConfig;
     visitorId: string;
+    anonymousId: string;
     sessionId: string;
     currentUserId?: string;
     userProperties: UserProperties;

package/lib/utils.d.ts

@@ -2,6 +2,7 @@ import 'react-native-get-random-values';
 import { DeviceInfo as DeviceInfoType, FingerprintData } from './types';
 export declare const STORAGE_KEYS: {
     VISITOR_ID: string;
+    ANONYMOUS_ID: string;
     SESSION_ID: string;
     USER_ID: string;
     USER_PROPERTIES: string;
@@ -25,6 +26,11 @@ export declare const hashString: (str: string) => string;
  * Get or create a persistent visitor ID
  */
 export declare const getOrCreateVisitorId: () => Promise<string>;
+/**
+ * Get or create a persistent anonymous ID
+ * This ID persists across app reinstalls and never changes
+ */
+export declare const getOrCreateAnonymousId: () => Promise<string>;
 /**
  * Get or create a session ID (with session timeout logic)
  */

package/lib/utils.js

@@ -13,6 +13,7 @@ import 'react-native-get-random-values'; // Required for 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',
     USER_ID: '@datalyr/user_id',
     USER_PROPERTIES: '@datalyr/user_properties',
@@ -63,6 +64,25 @@ export const getOrCreateVisitorId = async () => {
         return generateUUID(); // Fallback to memory-only ID
     }
 };
+/**
+ * Get or create a persistent anonymous ID
+ * This ID persists across app reinstalls and never changes
+ */
+export const getOrCreateAnonymousId = async () => {
+    try {
+        let anonymousId = await AsyncStorage.getItem(STORAGE_KEYS.ANONYMOUS_ID);
+        if (!anonymousId) {
+            // Generate anonymous_id with anon_ prefix to match web SDK
+            anonymousId = `anon_${generateUUID()}`;
+            await AsyncStorage.setItem(STORAGE_KEYS.ANONYMOUS_ID, anonymousId);
+        }
+        return anonymousId;
+    }
+    catch (error) {
+        console.warn('Failed to get/create anonymous ID:', error);
+        return `anon_${generateUUID()}`; // Fallback to memory-only ID
+    }
+};
 /**
  * Get or create a session ID (with session timeout logic)
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datalyr/react-native",
-  "version": "1.0.5",
+  "version": "1.1.0",
   "description": "Datalyr SDK for React Native & Expo - Server-side attribution tracking",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

package/src/datalyr-sdk.ts

@@ -10,6 +10,7 @@ import {
 } from './types';
 import { 
   getOrCreateVisitorId, 
+  getOrCreateAnonymousId,
   getOrCreateSessionId, 
   createFingerprintData, 
   generateUUID, 
@@ -56,6 +57,7 @@ export class DatalyrSDK {
         respectDoNotTrack: true,
       },
       visitorId: '',
+      anonymousId: '',  // Persistent anonymous identifier
       sessionId: '',
       userProperties: {},
       eventQueue: [],
@@ -106,8 +108,9 @@ export class DatalyrSDK {
         maxRetryCount: this.state.config.maxRetries || 3,
       });
 
-      // Initialize visitor ID and session
+      // Initialize visitor ID, anonymous ID and session
       this.state.visitorId = await getOrCreateVisitorId();
+      this.state.anonymousId = await getOrCreateAnonymousId();
       this.state.sessionId = await getOrCreateSessionId();
 
       // Load persisted user data
@@ -174,6 +177,7 @@ export class DatalyrSDK {
       debugLog('Datalyr SDK initialized successfully', {
         workspaceId: this.state.config.workspaceId,
         visitorId: this.state.visitorId,
+        anonymousId: this.state.anonymousId,
         sessionId: this.state.sessionId,
       });
 
@@ -251,9 +255,10 @@ export class DatalyrSDK {
       // Persist user data
       await this.persistUserData();
 
-      // Track identify event
-      await this.track('identify', { 
+      // Track $identify event for identity resolution
+      await this.track('$identify', { 
         userId, 
+        anonymous_id: this.state.anonymousId,
         ...properties 
       });
 
@@ -276,6 +281,7 @@ export class DatalyrSDK {
         newUserId,
         previousId: previousId || this.state.visitorId,
         visitorId: this.state.visitorId,
+        anonymousId: this.state.anonymousId,  // Include for identity resolution
       };
 
       debugLog('Aliasing user:', aliasData);
@@ -335,6 +341,7 @@ export class DatalyrSDK {
     initialized: boolean;
     workspaceId: string;
     visitorId: string;
+    anonymousId: string;
     sessionId: string;
     currentUserId?: string;
     queueStats: any;
@@ -344,6 +351,7 @@ export class DatalyrSDK {
       initialized: this.state.initialized,
       workspaceId: this.state.config.workspaceId || '',
       visitorId: this.state.visitorId,
+      anonymousId: this.state.anonymousId,
       sessionId: this.state.sessionId,
       currentUserId: this.state.currentUserId,
       queueStats: this.eventQueue.getStats(),
@@ -351,6 +359,13 @@ export class DatalyrSDK {
     };
   }
 
+  /**
+   * Get the persistent anonymous ID
+   */
+  getAnonymousId(): string {
+    return this.state.anonymousId;
+  }
+
   /**
    * Get detailed attribution data
    */
@@ -489,11 +504,14 @@ export class DatalyrSDK {
     const payload: EventPayload = {
       workspaceId: this.state.config.workspaceId || 'mobile_sdk',
       visitorId: this.state.visitorId,
+      anonymousId: this.state.anonymousId,  // Include persistent anonymous ID
       sessionId: this.state.sessionId,
       eventId: generateUUID(),
       eventName,
       eventData: {
         ...eventData,
+        // Include anonymous_id in event data for attribution
+        anonymous_id: this.state.anonymousId,
         // Auto-captured mobile data
         platform: Platform.OS === 'ios' || Platform.OS === 'android' ? Platform.OS : 'android',
         os_version: deviceInfo.osVersion,
@@ -721,6 +739,10 @@ export class Datalyr {
     return datalyr.getStatus();
   }
 
+  static getAnonymousId(): string {
+    return datalyr.getAnonymousId();
+  }
+
   static getAttributionData(): AttributionData {
     return datalyr.getAttributionData();
   }

package/src/http-client.ts

@@ -213,6 +213,7 @@ export class HttpClient {
       const testPayload: EventPayload = {
         workspaceId: 'test', 
         visitorId: 'test',
+        anonymousId: 'test',
         sessionId: 'test',
         eventId: 'test',
         eventName: 'connection_test',

package/src/types.ts

@@ -66,6 +66,7 @@ export interface FingerprintData {
 export interface EventPayload {
   workspaceId: string;
   visitorId: string;
+  anonymousId: string;  // Persistent anonymous identifier
   sessionId: string;
   eventId: string;
   eventName: string;
@@ -92,6 +93,7 @@ export interface SDKState {
   initialized: boolean;
   config: DatalyrConfig;
   visitorId: string;
+  anonymousId: string;  // Persistent anonymous identifier
   sessionId: string;
   currentUserId?: string;
   userProperties: UserProperties;

package/src/utils.ts

@@ -16,6 +16,7 @@ import { DeviceInfo as DeviceInfoType, FingerprintData } from './types';
 // Storage Keys
 export const STORAGE_KEYS = {
   VISITOR_ID: '@datalyr/visitor_id',
+  ANONYMOUS_ID: '@datalyr/anonymous_id',  // Persistent anonymous identifier
   SESSION_ID: '@datalyr/session_id',
   USER_ID: '@datalyr/user_id',
   USER_PROPERTIES: '@datalyr/user_properties',
@@ -71,6 +72,25 @@ export const getOrCreateVisitorId = async (): Promise<string> => {
   }
 };
 
+/**
+ * Get or create a persistent anonymous ID
+ * This ID persists across app reinstalls and never changes
+ */
+export const getOrCreateAnonymousId = async (): Promise<string> => {
+  try {
+    let anonymousId = await AsyncStorage.getItem(STORAGE_KEYS.ANONYMOUS_ID);
+    if (!anonymousId) {
+      // Generate anonymous_id with anon_ prefix to match web SDK
+      anonymousId = `anon_${generateUUID()}`;
+      await AsyncStorage.setItem(STORAGE_KEYS.ANONYMOUS_ID, anonymousId);
+    }
+    return anonymousId;
+  } catch (error) {
+    console.warn('Failed to get/create anonymous ID:', error);
+    return `anon_${generateUUID()}`; // Fallback to memory-only ID
+  }
+};
+
 /**
  * Get or create a session ID (with session timeout logic)
  */