@datalyr/react-native 1.7.4 → 1.7.6

package/lib/datalyr-sdk.js

@@ -1,5 +1,5 @@
 import { Platform, AppState } from 'react-native';
-import { getOrCreateVisitorId, getOrCreateAnonymousId, getOrCreateSessionId, createFingerprintData, generateUUID, getDeviceInfo, getNetworkType, validateEventName, validateEventData, debugLog, errorLog, Storage, STORAGE_KEYS, } from './utils';
+import { getOrCreateVisitorId, getOrCreateAnonymousId, getOrCreateSessionId, createDeviceContext, 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';
@@ -188,7 +188,7 @@ export class DatalyrSDK {
                 const installData = await attributionManager.trackInstall();
                 await this.track('app_install', {
                     platform: Platform.OS === 'ios' || Platform.OS === 'android' ? Platform.OS : 'android',
-                    sdk_version: '1.7.2',
+                    sdk_version: '1.7.5',
                     ...installData,
                 });
             }
@@ -874,7 +874,7 @@ export class DatalyrSDK {
      */
     async createEventPayload(eventName, eventData) {
         const deviceInfo = await getDeviceInfo();
-        const fingerprintData = await createFingerprintData();
+        const deviceContext = await createDeviceContext();
         const attributionData = attributionManager.getAttributionData();
         // Get Apple Search Ads attribution if available
         const asaAttribution = appleSearchAdsIntegration.getAttributionData();
@@ -919,7 +919,7 @@ export class DatalyrSDK {
                 carrier: deviceInfo.carrier,
                 network_type: getNetworkType(),
                 timestamp: Date.now(),
-                sdk_version: '1.7.2',
+                sdk_version: '1.7.5',
                 // Advertiser data (IDFA/GAID, ATT status) for server-side postback
                 ...(advertiserInfo ? {
                     idfa: advertiserInfo.idfa,
@@ -933,7 +933,7 @@ export class DatalyrSDK {
                 // Apple Search Ads attribution
                 ...asaData,
             },
-            fingerprintData,
+            deviceContext,
             source: 'mobile_app',
             timestamp: new Date().toISOString(),
         };

package/lib/http-client.js

@@ -149,11 +149,11 @@ export class HttpClient {
                 ...payload.eventData,
                 sessionId: payload.sessionId,
                 source: payload.source || 'mobile_app',
-                fingerprint: payload.fingerprintData,
+                fingerprint: payload.deviceContext,
             },
             context: {
                 library: '@datalyr/react-native',
-                version: '1.6.2',
+                version: '1.7.5',
                 source: 'mobile_app',
                 userProperties: payload.userProperties,
             },

package/lib/types.d.ts

@@ -106,7 +106,7 @@ export interface EventData {
     app_build?: string;
     network_type?: string;
 }
-export interface FingerprintData {
+export interface DeviceContext {
     deviceId?: string;
     deviceInfo?: {
         model: string;
@@ -127,7 +127,7 @@ export interface EventPayload {
     eventId: string;
     eventName: string;
     eventData?: EventData;
-    fingerprintData?: FingerprintData;
+    deviceContext?: DeviceContext;
     source: 'mobile_app';
     timestamp: string;
     userId?: string;

package/lib/utils.d.ts

@@ -1,5 +1,5 @@
 import 'react-native-get-random-values';
-import { DeviceInfo as DeviceInfoType, FingerprintData } from './types';
+import { DeviceInfo as DeviceInfoType, DeviceContext } from './types';
 export declare const STORAGE_KEYS: {
     VISITOR_ID: string;
     ANONYMOUS_ID: string;
@@ -45,9 +45,9 @@ export declare const getDeviceInfo: () => Promise<DeviceInfoType>;
  */
 export declare const clearDeviceInfoCache: () => void;
 /**
- * Create fingerprint data for attribution
+ * Create device context for attribution
  */
-export declare const createFingerprintData: () => Promise<FingerprintData>;
+export declare const createDeviceContext: () => Promise<DeviceContext>;
 /**
  * Get network connection type
  */

package/lib/utils.js

@@ -219,9 +219,9 @@ const fetchDeviceInfoInternal = async () => {
     }
 };
 /**
- * Create fingerprint data for attribution
+ * Create device context for attribution
  */
-export const createFingerprintData = async () => {
+export const createDeviceContext = async () => {
     const deviceInfo = await getDeviceInfo();
     return {
         deviceId: deviceInfo.deviceId,

package/package.json

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

@@ -16,7 +16,7 @@ import {
   getOrCreateVisitorId,
   getOrCreateAnonymousId,
   getOrCreateSessionId,
-  createFingerprintData,
+  createDeviceContext,
   generateUUID,
   getDeviceInfo,
   getNetworkType,
@@ -206,10 +206,15 @@ 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,
-          sdk_version: '1.7.2',
+          sdk_version: '1.7.5',
           sdk_variant: 'expo',
           ...installData,
         });
@@ -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') {
@@ -758,7 +844,7 @@ export class DatalyrSDKExpo {
 
   private async createEventPayload(eventName: string, eventData?: EventData): Promise<EventPayload> {
     const deviceInfo = await getDeviceInfo();
-    const fingerprintData = await createFingerprintData();
+    const deviceContext = await createDeviceContext();
     const attributionData = attributionManager.getAttributionData();
     const networkType = getNetworkType();
 
@@ -805,7 +891,7 @@ export class DatalyrSDKExpo {
         carrier: deviceInfo.carrier,
         network_type: networkType,
         timestamp: Date.now(),
-        sdk_version: '1.7.2',
+        sdk_version: '1.7.5',
         sdk_variant: 'expo',
         // Advertiser data (IDFA/GAID, ATT status) for server-side postback
         ...(advertiserInfo ? {
@@ -819,7 +905,7 @@ export class DatalyrSDKExpo {
         // Apple Search Ads attribution
         ...asaData,
       },
-      fingerprintData,
+      deviceContext,
       source: 'mobile_app',
       timestamp: new Date().toISOString(),
     };

package/src/datalyr-sdk.ts

@@ -13,7 +13,7 @@ import {
   getOrCreateVisitorId,
   getOrCreateAnonymousId,
   getOrCreateSessionId,
-  createFingerprintData,
+  createDeviceContext,
   generateUUID,
   getDeviceInfo,
   getNetworkType,
@@ -241,7 +241,7 @@ export class DatalyrSDK {
         const installData = await attributionManager.trackInstall();
         await this.track('app_install', {
           platform: Platform.OS === 'ios' || Platform.OS === 'android' ? Platform.OS : 'android',
-          sdk_version: '1.7.2',
+          sdk_version: '1.7.5',
           ...installData,
         });
       }
@@ -1049,7 +1049,7 @@ export class DatalyrSDK {
    */
   private async createEventPayload(eventName: string, eventData?: EventData): Promise<EventPayload> {
     const deviceInfo = await getDeviceInfo();
-    const fingerprintData = await createFingerprintData();
+    const deviceContext = await createDeviceContext();
     const attributionData = attributionManager.getAttributionData();
 
     // Get Apple Search Ads attribution if available
@@ -1097,7 +1097,7 @@ export class DatalyrSDK {
         carrier: deviceInfo.carrier,
         network_type: getNetworkType(),
         timestamp: Date.now(),
-        sdk_version: '1.7.2',
+        sdk_version: '1.7.5',
         // Advertiser data (IDFA/GAID, ATT status) for server-side postback
         ...(advertiserInfo ? {
           idfa: advertiserInfo.idfa,
@@ -1111,7 +1111,7 @@ export class DatalyrSDK {
         // Apple Search Ads attribution
         ...asaData,
       },
-      fingerprintData,
+      deviceContext,
       source: 'mobile_app',
       timestamp: new Date().toISOString(),
     };

package/src/expo.ts

@@ -38,7 +38,7 @@ export {
   getOrCreateVisitorId,
   getOrCreateAnonymousId,
   getOrCreateSessionId,
-  createFingerprintData,
+  createDeviceContext,
   getNetworkType,
   validateEventName,
   validateEventData,

package/src/http-client.ts

@@ -194,11 +194,11 @@ export class HttpClient {
         ...payload.eventData,
         sessionId: payload.sessionId,
         source: payload.source || 'mobile_app',
-        fingerprint: payload.fingerprintData,
+        fingerprint: payload.deviceContext,
       },
       context: {
         library: '@datalyr/react-native',
-        version: '1.6.2',
+        version: '1.7.5',
         source: 'mobile_app',
         userProperties: payload.userProperties,
       },

package/src/types.ts

@@ -133,7 +133,7 @@ export interface EventData {
   network_type?: string;
 }
 
-export interface FingerprintData {
+export interface DeviceContext {
   deviceId?: string;
   deviceInfo?: {
     model: string;
@@ -155,7 +155,7 @@ export interface EventPayload {
   eventId: string;
   eventName: string;
   eventData?: EventData;
-  fingerprintData?: FingerprintData;
+  deviceContext?: DeviceContext;
   source: 'mobile_app';
   timestamp: string;
   userId?: string;

package/src/utils-expo.ts

@@ -224,8 +224,8 @@ export const getOrCreateSessionId = async (): Promise<string> => {
   }
 };
 
-// Fingerprint data creation using Expo APIs
-export const createFingerprintData = async () => {
+// Device context creation using Expo APIs
+export const createDeviceContext = async () => {
   try {
     const deviceInfo = await getDeviceInfo();
     
@@ -243,7 +243,7 @@ export const createFingerprintData = async () => {
       },
     };
   } catch (error) {
-    errorLog('Error creating fingerprint data:', error as Error);
+    errorLog('Error creating device context:', error as Error);
     const deviceInfo = await getDeviceInfo();
     return {
       deviceId: deviceInfo.deviceId,

package/src/utils-interface.ts

@@ -3,7 +3,7 @@
  * Both utils.ts and utils-expo.ts implement this interface
  */
 
-import { DeviceInfo, FingerprintData } from './types';
+import { DeviceInfo, DeviceContext } from './types';
 
 export interface SDKUtils {
   STORAGE_KEYS: {
@@ -22,7 +22,7 @@ export interface SDKUtils {
   getOrCreateAnonymousId: () => Promise<string>;
   getOrCreateSessionId: () => Promise<string>;
   getDeviceInfo: () => Promise<DeviceInfo>;
-  createFingerprintData: () => Promise<FingerprintData>;
+  createDeviceContext: () => Promise<DeviceContext>;
   getNetworkType: () => string | Promise<string>;
   validateEventName: (eventName: string) => boolean;
   validateEventData: (eventData: any) => boolean;

package/src/utils.ts

@@ -11,7 +11,7 @@ try {
 import { v4 as uuidv4 } from 'uuid';
 import 'react-native-get-random-values'; // Required for uuid
 
-import { DeviceInfo as DeviceInfoType, FingerprintData } from './types';
+import { DeviceInfo as DeviceInfoType, DeviceContext } from './types';
 
 // Storage Keys
 export const STORAGE_KEYS = {
@@ -250,9 +250,9 @@ const fetchDeviceInfoInternal = async (): Promise<DeviceInfoType> => {
 };
 
 /**
- * Create fingerprint data for attribution
+ * Create device context for attribution
  */
-export const createFingerprintData = async (): Promise<FingerprintData> => {
+export const createDeviceContext = async (): Promise<DeviceContext> => {
   const deviceInfo = await getDeviceInfo();
   
   return {