@datalyr/react-native 1.7.3 → 1.7.5

package/README.md

@@ -12,7 +12,6 @@ Mobile analytics and attribution SDK for React Native and Expo. Track events, id
   - [Custom Events](#custom-events)
   - [Screen Views](#screen-views)
   - [E-Commerce Events](#e-commerce-events)
-  - [Revenue Events](#revenue-events)
 - [User Identity](#user-identity)
   - [Anonymous ID](#anonymous-id)
   - [Identifying Users](#identifying-users)
@@ -181,8 +180,7 @@ await Datalyr.initialize({
 interface AutoEventConfig {
   trackSessions?: boolean;       // Track session_start / session_end (default: true)
   trackScreenViews?: boolean;    // Enable screen view events via screen() (default: true)
-  trackAppUpdates?: boolean;     // Track app_update events (default: true)
-  trackPerformance?: boolean;    // Track performance metrics (default: false)
+  trackAppInstall?: boolean;     // Track app_install on first open (default: true)
   sessionTimeoutMs?: number;     // Session timeout in ms
 }
 ```
@@ -271,25 +269,7 @@ await Datalyr.trackAddPaymentInfo(true);
 
 ### Revenue Events
 
-> **Important:** If you use **Superwall** or **RevenueCat**, do not use `trackPurchase()`, `trackSubscription()`, or `trackRevenue()` for revenue attribution. These fire client-side before payment is confirmed, so trials and failed payments get counted as revenue. Use the [Superwall](https://docs.datalyr.com/integrations/superwall) or [RevenueCat](https://docs.datalyr.com/integrations/revenuecat) webhook integration for revenue events instead — they only fire when real money changes hands. Use the SDK for behavioral events only (`track('paywall_view')`, `track('trial_start')`, `screen()`, `identify()`, etc.).
-
-Track revenue with automatic SKAdNetwork encoding:
-
-```typescript
-await Datalyr.trackRevenue('in_app_purchase', {
-  value: 4.99,
-  currency: 'USD',
-  product_id: 'gems_500',
-});
-```
-
-### App Update Tracking
-
-Manually track version changes:
-
-```typescript
-await Datalyr.trackAppUpdate('1.0.0', '1.1.0');
-```
+> **Important:** If you use **Superwall** or **RevenueCat**, do not track revenue client-side. Use the [Superwall](https://docs.datalyr.com/integrations/superwall) or [RevenueCat](https://docs.datalyr.com/integrations/revenuecat) webhook integration instead — they only fire when real money changes hands. Use the SDK for behavioral events only (`track('paywall_view')`, `track('trial_start')`, `screen()`, `identify()`, etc.).
 
 ---
 
@@ -636,10 +616,6 @@ await Datalyr.initialize({
 | Event | Trigger |
 |-------|---------|
 | `app_install` | First app open |
-| `app_open` | App launch |
-| `app_background` | App enters background |
-| `app_foreground` | App returns to foreground |
-| `app_update` | App version changes |
 | `session_start` | New session begins |
 | `session_end` | Session expires (30 min inactivity) |
 
@@ -1120,7 +1096,6 @@ All methods are static on the `Datalyr` class unless noted otherwise.
 | `trackWithSKAdNetwork(event, properties?)` | Track event with SKAN conversion value encoding |
 | `trackPurchase(value, currency?, productId?)` | Track a purchase |
 | `trackSubscription(value, currency?, plan?)` | Track a subscription |
-| `trackRevenue(eventName, properties?)` | Track a revenue event |
 | `trackAddToCart(value, currency?, productId?, productName?)` | Track add-to-cart |
 | `trackViewContent(contentId?, contentName?, contentType?, value?, currency?)` | Track content view |
 | `trackInitiateCheckout(value, currency?, numItems?, productIds?)` | Track checkout start |
@@ -1128,7 +1103,6 @@ All methods are static on the `Datalyr` class unless noted otherwise.
 | `trackSearch(query, resultIds?)` | Track a search |
 | `trackLead(value?, currency?)` | Track a lead |
 | `trackAddPaymentInfo(success?)` | Track payment info added |
-| `trackAppUpdate(previousVersion, currentVersion)` | Track an app version update |
 
 ### User Identity
 

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.3",
+  "version": "1.7.5",
   "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,
@@ -209,7 +209,7 @@ export class DatalyrSDKExpo {
         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,
         });
@@ -758,7 +758,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 +805,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 +819,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 {