@datalyr/react-native 1.0.5 → 1.1.1

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/attribution.d.ts

@@ -95,6 +95,11 @@ export declare class AttributionManager {
      * Track install event with attribution data
      */
     trackInstall(): Promise<AttributionData>;
+    /**
+     * Merge web attribution data into mobile session
+     * Called when web-to-app attribution is resolved via email
+     */
+    mergeWebAttribution(webAttribution: any): void;
     /**
      * Set custom attribution data
      */

package/lib/attribution.js

@@ -335,6 +335,45 @@ export class AttributionManager {
         }
         return this.attributionData;
     }
+    /**
+     * Merge web attribution data into mobile session
+     * Called when web-to-app attribution is resolved via email
+     */
+    mergeWebAttribution(webAttribution) {
+        debugLog('Merging web attribution data:', webAttribution);
+        // Only merge if we don't already have attribution data
+        // Web attribution takes precedence for first-touch
+        if (!this.attributionData.fbclid && webAttribution.fbclid) {
+            this.attributionData.fbclid = webAttribution.fbclid;
+        }
+        if (!this.attributionData.gclid && webAttribution.gclid) {
+            this.attributionData.gclid = webAttribution.gclid;
+        }
+        if (!this.attributionData.ttclid && webAttribution.ttclid) {
+            this.attributionData.ttclid = webAttribution.ttclid;
+        }
+        // Merge UTM parameters
+        if (!this.attributionData.utm_source && webAttribution.utm_source) {
+            this.attributionData.utm_source = webAttribution.utm_source;
+        }
+        if (!this.attributionData.utm_medium && webAttribution.utm_medium) {
+            this.attributionData.utm_medium = webAttribution.utm_medium;
+        }
+        if (!this.attributionData.utm_campaign && webAttribution.utm_campaign) {
+            this.attributionData.utm_campaign = webAttribution.utm_campaign;
+        }
+        if (!this.attributionData.utm_content && webAttribution.utm_content) {
+            this.attributionData.utm_content = webAttribution.utm_content;
+        }
+        if (!this.attributionData.utm_term && webAttribution.utm_term) {
+            this.attributionData.utm_term = webAttribution.utm_term;
+        }
+        // Store web visitor ID for cross-device tracking
+        this.attributionData.web_visitor_id = webAttribution.visitor_id;
+        // Save merged attribution data
+        this.saveAttributionData();
+        debugLog('Web attribution merged successfully');
+    }
     /**
      * Set custom attribution data
      */

package/lib/datalyr-sdk.d.ts

@@ -26,6 +26,11 @@ export declare class DatalyrSDK {
      * Identify a user
      */
     identify(userId: string, properties?: UserProperties): Promise<void>;
+    /**
+     * Fetch web attribution data for user and merge into mobile session
+     * Called automatically during identify() if email is provided
+     */
+    private fetchAndMergeWebAttribution;
     /**
      * Alias a user (connect anonymous user to known user)
      */
@@ -45,11 +50,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 +161,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,16 +194,83 @@ 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
             });
+            // Fetch and merge web attribution if email is provided
+            if (this.state.config.enableWebToAppAttribution !== false) {
+                const email = (properties === null || properties === void 0 ? void 0 : properties.email) || (typeof userId === 'string' && userId.includes('@') ? userId : null);
+                if (email) {
+                    await this.fetchAndMergeWebAttribution(email);
+                }
+            }
         }
         catch (error) {
             errorLog('Error identifying user:', error);
         }
     }
+    /**
+     * Fetch web attribution data for user and merge into mobile session
+     * Called automatically during identify() if email is provided
+     */
+    async fetchAndMergeWebAttribution(email) {
+        try {
+            debugLog('Fetching web attribution for email:', email);
+            // Call API endpoint to get web attribution
+            const response = await fetch('https://api.datalyr.com/attribution/lookup', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-Datalyr-API-Key': this.state.config.apiKey,
+                },
+                body: JSON.stringify({ email }),
+            });
+            if (!response.ok) {
+                debugLog('Failed to fetch web attribution:', response.status);
+                return;
+            }
+            const result = await response.json();
+            if (!result.found || !result.attribution) {
+                debugLog('No web attribution found for user');
+                return;
+            }
+            const webAttribution = result.attribution;
+            debugLog('Web attribution found:', {
+                visitor_id: webAttribution.visitor_id,
+                has_fbclid: !!webAttribution.fbclid,
+                has_gclid: !!webAttribution.gclid,
+                utm_source: webAttribution.utm_source,
+            });
+            // Merge web attribution into current session
+            await this.track('$web_attribution_merged', {
+                web_visitor_id: webAttribution.visitor_id,
+                web_user_id: webAttribution.user_id,
+                fbclid: webAttribution.fbclid,
+                gclid: webAttribution.gclid,
+                ttclid: webAttribution.ttclid,
+                gbraid: webAttribution.gbraid,
+                wbraid: webAttribution.wbraid,
+                fbp: webAttribution.fbp,
+                fbc: webAttribution.fbc,
+                utm_source: webAttribution.utm_source,
+                utm_medium: webAttribution.utm_medium,
+                utm_campaign: webAttribution.utm_campaign,
+                utm_content: webAttribution.utm_content,
+                utm_term: webAttribution.utm_term,
+                web_timestamp: webAttribution.timestamp,
+            });
+            // Update attribution manager with web data
+            attributionManager.mergeWebAttribution(webAttribution);
+            debugLog('Successfully merged web attribution into mobile session');
+        }
+        catch (error) {
+            errorLog('Error fetching web attribution:', error);
+            // Non-blocking - continue even if attribution fetch fails
+        }
+    }
     /**
      * Alias a user (connect anonymous user to known user)
      */
@@ -214,6 +284,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 +336,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 +461,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 +659,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

@@ -22,6 +22,7 @@ export interface DatalyrConfig {
     respectDoNotTrack?: boolean;
     enableAutoEvents?: boolean;
     enableAttribution?: boolean;
+    enableWebToAppAttribution?: boolean;
     autoEvents?: AutoEventConfig;
     autoEventConfig?: AutoEventConfig;
     retryConfig?: {
@@ -59,6 +60,7 @@ export interface FingerprintData {
 export interface EventPayload {
     workspaceId: string;
     visitorId: string;
+    anonymousId: string;
     sessionId: string;
     eventId: string;
     eventName: string;
@@ -81,6 +83,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.1",
   "description": "Datalyr SDK for React Native & Expo - Server-side attribution tracking",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -58,6 +58,7 @@
   "devDependencies": {
     "@types/jest": "^30.0.0",
     "@types/react": "^18.2.0",
+    "@types/react-native": "^0.72.8",
     "@types/uuid": "^10.0.0",
     "@typescript-eslint/eslint-plugin": "^8.0.0",
     "@typescript-eslint/parser": "^8.0.0",

package/src/attribution.ts

@@ -441,6 +441,51 @@ export class AttributionManager {
     return this.attributionData;
   }
 
+  /**
+   * Merge web attribution data into mobile session
+   * Called when web-to-app attribution is resolved via email
+   */
+  mergeWebAttribution(webAttribution: any): void {
+    debugLog('Merging web attribution data:', webAttribution);
+
+    // Only merge if we don't already have attribution data
+    // Web attribution takes precedence for first-touch
+    if (!this.attributionData.fbclid && webAttribution.fbclid) {
+      this.attributionData.fbclid = webAttribution.fbclid;
+    }
+    if (!this.attributionData.gclid && webAttribution.gclid) {
+      this.attributionData.gclid = webAttribution.gclid;
+    }
+    if (!this.attributionData.ttclid && webAttribution.ttclid) {
+      this.attributionData.ttclid = webAttribution.ttclid;
+    }
+
+    // Merge UTM parameters
+    if (!this.attributionData.utm_source && webAttribution.utm_source) {
+      this.attributionData.utm_source = webAttribution.utm_source;
+    }
+    if (!this.attributionData.utm_medium && webAttribution.utm_medium) {
+      this.attributionData.utm_medium = webAttribution.utm_medium;
+    }
+    if (!this.attributionData.utm_campaign && webAttribution.utm_campaign) {
+      this.attributionData.utm_campaign = webAttribution.utm_campaign;
+    }
+    if (!this.attributionData.utm_content && webAttribution.utm_content) {
+      this.attributionData.utm_content = webAttribution.utm_content;
+    }
+    if (!this.attributionData.utm_term && webAttribution.utm_term) {
+      this.attributionData.utm_term = webAttribution.utm_term;
+    }
+
+    // Store web visitor ID for cross-device tracking
+    this.attributionData.web_visitor_id = webAttribution.visitor_id;
+
+    // Save merged attribution data
+    this.saveAttributionData();
+
+    debugLog('Web attribution merged successfully');
+  }
+
   /**
    * Set custom attribution data
    */

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,
       });
 
@@ -244,24 +248,101 @@ export class DatalyrSDK {
 
       // Update current user ID
       this.state.currentUserId = userId;
-      
+
       // Merge user properties
       this.state.userProperties = { ...this.state.userProperties, ...properties };
 
       // Persist user data
       await this.persistUserData();
 
-      // Track identify event
-      await this.track('identify', { 
-        userId, 
-        ...properties 
+      // Track $identify event for identity resolution
+      await this.track('$identify', {
+        userId,
+        anonymous_id: this.state.anonymousId,
+        ...properties
       });
 
+      // Fetch and merge web attribution if email is provided
+      if (this.state.config.enableWebToAppAttribution !== false) {
+        const email = properties?.email || (typeof userId === 'string' && userId.includes('@') ? userId : null);
+        if (email) {
+          await this.fetchAndMergeWebAttribution(email);
+        }
+      }
+
     } catch (error) {
       errorLog('Error identifying user:', error as Error);
     }
   }
 
+  /**
+   * Fetch web attribution data for user and merge into mobile session
+   * Called automatically during identify() if email is provided
+   */
+  private async fetchAndMergeWebAttribution(email: string): Promise<void> {
+    try {
+      debugLog('Fetching web attribution for email:', email);
+
+      // Call API endpoint to get web attribution
+      const response = await fetch('https://api.datalyr.com/attribution/lookup', {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'X-Datalyr-API-Key': this.state.config.apiKey!,
+        },
+        body: JSON.stringify({ email }),
+      });
+
+      if (!response.ok) {
+        debugLog('Failed to fetch web attribution:', response.status);
+        return;
+      }
+
+      const result = await response.json() as { found: boolean; attribution?: any };
+
+      if (!result.found || !result.attribution) {
+        debugLog('No web attribution found for user');
+        return;
+      }
+
+      const webAttribution = result.attribution;
+      debugLog('Web attribution found:', {
+        visitor_id: webAttribution.visitor_id,
+        has_fbclid: !!webAttribution.fbclid,
+        has_gclid: !!webAttribution.gclid,
+        utm_source: webAttribution.utm_source,
+      });
+
+      // Merge web attribution into current session
+      await this.track('$web_attribution_merged', {
+        web_visitor_id: webAttribution.visitor_id,
+        web_user_id: webAttribution.user_id,
+        fbclid: webAttribution.fbclid,
+        gclid: webAttribution.gclid,
+        ttclid: webAttribution.ttclid,
+        gbraid: webAttribution.gbraid,
+        wbraid: webAttribution.wbraid,
+        fbp: webAttribution.fbp,
+        fbc: webAttribution.fbc,
+        utm_source: webAttribution.utm_source,
+        utm_medium: webAttribution.utm_medium,
+        utm_campaign: webAttribution.utm_campaign,
+        utm_content: webAttribution.utm_content,
+        utm_term: webAttribution.utm_term,
+        web_timestamp: webAttribution.timestamp,
+      });
+
+      // Update attribution manager with web data
+      attributionManager.mergeWebAttribution(webAttribution);
+
+      debugLog('Successfully merged web attribution into mobile session');
+
+    } catch (error) {
+      errorLog('Error fetching web attribution:', error as Error);
+      // Non-blocking - continue even if attribution fetch fails
+    }
+  }
+
   /**
    * Alias a user (connect anonymous user to known user)
    */
@@ -276,6 +357,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 +417,7 @@ export class DatalyrSDK {
     initialized: boolean;
     workspaceId: string;
     visitorId: string;
+    anonymousId: string;
     sessionId: string;
     currentUserId?: string;
     queueStats: any;
@@ -344,6 +427,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 +435,13 @@ export class DatalyrSDK {
     };
   }
 
+  /**
+   * Get the persistent anonymous ID
+   */
+  getAnonymousId(): string {
+    return this.state.anonymousId;
+  }
+
   /**
    * Get detailed attribution data
    */
@@ -489,11 +580,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 +815,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

@@ -25,6 +25,7 @@ export interface DatalyrConfig {
   respectDoNotTrack?: boolean;
   enableAutoEvents?: boolean;
   enableAttribution?: boolean;
+  enableWebToAppAttribution?: boolean;
   autoEvents?: AutoEventConfig;
   autoEventConfig?: AutoEventConfig;
   retryConfig?: {
@@ -33,7 +34,6 @@ export interface DatalyrConfig {
   };
   skadTemplate?: 'ecommerce' | 'gaming' | 'subscription';
 }
-
 // Event Types
 export interface EventData {
   [key: string]: any;
@@ -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)
  */