@datalyr/react-native 1.1.0 → 1.1.1

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)
      */

package/lib/datalyr-sdk.js

@@ -200,11 +200,77 @@ export class DatalyrSDK {
                 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)
      */

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?: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datalyr/react-native",
-  "version": "1.1.0",
+  "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

@@ -248,7 +248,7 @@ export class DatalyrSDK {
 
       // Update current user ID
       this.state.currentUserId = userId;
-      
+
       // Merge user properties
       this.state.userProperties = { ...this.state.userProperties, ...properties };
 
@@ -256,17 +256,93 @@ export class DatalyrSDK {
       await this.persistUserData();
 
       // Track $identify event for identity resolution
-      await this.track('$identify', { 
-        userId, 
+      await this.track('$identify', {
+        userId,
         anonymous_id: this.state.anonymousId,
-        ...properties 
+        ...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)
    */

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;