@datalyr/react-native 1.7.5 → 1.7.6

package/package.json

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

package/src/datalyr-sdk-expo.ts

@@ -206,6 +206,11 @@ export class DatalyrSDKExpo {
       }
 
       if (attributionManager.isInstall()) {
+        // iOS: Attempt deferred web-to-app attribution via IP matching before tracking install
+        if (Platform.OS === 'ios') {
+          await this.fetchDeferredWebAttribution();
+        }
+
         const installData = await attributionManager.trackInstall();
         await this.track('app_install', {
           platform: Platform.OS,
@@ -376,6 +381,87 @@ export class DatalyrSDKExpo {
     }
   }
 
+  /**
+   * Fetch deferred web attribution on first app install.
+   * Uses IP-based matching to recover attribution data (fbclid, utm_*, etc.)
+   * from a prelander web visit. Called automatically during initialize()
+   * when a fresh install is detected on iOS.
+   */
+  private async fetchDeferredWebAttribution(): Promise<void> {
+    if (!this.state.config?.apiKey) {
+      debugLog('API key not available for deferred attribution fetch');
+      return;
+    }
+
+    try {
+      debugLog('Fetching deferred web attribution via IP matching...');
+
+      const controller = new AbortController();
+      const timeout = setTimeout(() => controller.abort(), 10000);
+
+      const response = await fetch('https://api.datalyr.com/attribution/deferred-lookup', {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'X-Datalyr-API-Key': this.state.config.apiKey!,
+        },
+        body: JSON.stringify({ platform: Platform.OS }),
+        signal: controller.signal,
+      });
+
+      clearTimeout(timeout);
+
+      if (!response.ok) {
+        debugLog('Deferred attribution lookup failed:', response.status);
+        return;
+      }
+
+      const result = await response.json() as { found: boolean; attribution?: any };
+
+      if (!result.found || !result.attribution) {
+        debugLog('No deferred web attribution found for this IP');
+        return;
+      }
+
+      const webAttribution = result.attribution;
+      debugLog('Deferred 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
+      attributionManager.mergeWebAttribution(webAttribution);
+
+      // Track match event for analytics
+      await this.track('$web_attribution_matched', {
+        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,
+        match_method: 'ip',
+      });
+
+      debugLog('Successfully merged deferred web attribution');
+
+    } catch (error) {
+      errorLog('Error fetching deferred web attribution:', error as Error);
+      // Non-blocking - email-based fallback will catch this on identify()
+    }
+  }
+
   async alias(newUserId: string, previousId?: string): Promise<void> {
     try {
       if (!newUserId || typeof newUserId !== 'string') {