@datalyr/react-native 1.2.0 → 1.3.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@datalyr/react-native",
-  "version": "1.2.0",
-  "description": "Datalyr SDK for React Native & Expo - Server-side attribution tracking with bundled Meta and TikTok SDKs",
+  "version": "1.3.0",
+  "description": "Datalyr SDK for React Native & Expo - Server-side attribution tracking with bundled Meta and TikTok SDKs for iOS and Android",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "scripts": {
@@ -15,6 +15,7 @@
     "lib/",
     "src/",
     "ios/",
+    "android/",
     "README.md",
     "CHANGELOG.md",
     "LICENSE",
@@ -38,10 +39,15 @@
     "tiktok-attribution",
     "google-attribution",
     "ios-attribution",
+    "android-attribution",
+    "apple-search-ads",
+    "play-install-referrer",
+    "gclid",
     "conversion-tracking",
     "revenue-optimization",
     "deferred-deep-linking",
-    "fbclid"
+    "fbclid",
+    "ttclid"
   ],
   "author": "Datalyr",
   "license": "MIT",

package/src/ConversionValueEncoder.ts

@@ -1,8 +1,12 @@
-// Interface definitions
+import { SKANCoarseValue, SKANConversionResult } from './native/SKAdNetworkBridge';
+
+// SKAN 4.0 compatible event mapping
 interface EventMapping {
   bits: number[];
   revenueBits?: number[];
   priority: number;
+  coarseValue?: SKANCoarseValue;  // SKAN 4.0: low, medium, high
+  lockWindow?: boolean;           // SKAN 4.0: lock the conversion window after this event
 }
 
 interface ConversionTemplate {
@@ -18,11 +22,21 @@ export class ConversionValueEncoder {
   }
 
   /**
-   * Encode an event into Apple's 0-63 conversion value format
+   * Encode an event into Apple's 0-63 conversion value format (SKAN 3.0 compatible)
+   * @deprecated Use encodeWithSKAN4 for iOS 16.1+
    */
   encode(event: string, properties?: Record<string, any>): number {
+    return this.encodeWithSKAN4(event, properties).fineValue;
+  }
+
+  /**
+   * Encode an event with full SKAN 4.0 support (fine value, coarse value, lock window)
+   */
+  encodeWithSKAN4(event: string, properties?: Record<string, any>): SKANConversionResult {
     const mapping = this.template.events[event];
-    if (!mapping) return 0;
+    if (!mapping) {
+      return { fineValue: 0, coarseValue: 'low', lockWindow: false, priority: 0 };
+    }
 
     let conversionValue = 0;
 
@@ -32,18 +46,30 @@ export class ConversionValueEncoder {
     }
 
     // Set revenue bits if revenue is provided
+    let coarseValue: SKANCoarseValue = mapping.coarseValue || 'medium';
     if (mapping.revenueBits && properties) {
       const revenue = properties.revenue || properties.value || 0;
       const revenueTier = this.getRevenueTier(revenue);
-      
+
       for (let i = 0; i < Math.min(mapping.revenueBits.length, 3); i++) {
         if ((revenueTier >> i) & 1) {
           conversionValue |= (1 << mapping.revenueBits[i]);
         }
       }
+
+      // Upgrade coarse value based on revenue
+      coarseValue = this.getCoarseValueForRevenue(revenue);
     }
 
-    return Math.min(conversionValue, 63);
+    // Ensure value is within 0-63 range
+    const fineValue = Math.min(conversionValue, 63);
+
+    return {
+      fineValue,
+      coarseValue,
+      lockWindow: mapping.lockWindow || false,
+      priority: mapping.priority
+    };
   }
 
   /**
@@ -59,43 +85,58 @@ export class ConversionValueEncoder {
     if (revenue < 250) return 6;    // $100-250
     return 7;                       // $250+
   }
+
+  /**
+   * Map revenue to SKAN 4.0 coarse value
+   */
+  private getCoarseValueForRevenue(revenue: number): SKANCoarseValue {
+    if (revenue < 10) return 'low';      // $0-10 = low value
+    if (revenue < 50) return 'medium';   // $10-50 = medium value
+    return 'high';                       // $50+ = high value
+  }
 }
 
-// Industry templates
+// Industry templates with SKAN 4.0 support
 export const ConversionTemplates = {
+  // E-commerce template - optimized for online stores
+  // SKAN 4.0: purchase locks window, high-value events get "high" coarse value
   ecommerce: {
     name: 'ecommerce',
     events: {
-      purchase: { bits: [0], revenueBits: [1, 2, 3], priority: 100 },
-      add_to_cart: { bits: [4], priority: 30 },
-      begin_checkout: { bits: [5], priority: 50 },
-      signup: { bits: [6], priority: 20 },
-      subscribe: { bits: [0, 1], revenueBits: [2, 3, 4], priority: 90 },
-      view_item: { bits: [7], priority: 10 }
+      purchase: { bits: [0], revenueBits: [1, 2, 3], priority: 100, coarseValue: 'high' as SKANCoarseValue, lockWindow: true },
+      add_to_cart: { bits: [4], priority: 30, coarseValue: 'low' as SKANCoarseValue },
+      begin_checkout: { bits: [5], priority: 50, coarseValue: 'medium' as SKANCoarseValue },
+      signup: { bits: [6], priority: 20, coarseValue: 'low' as SKANCoarseValue },
+      subscribe: { bits: [0, 1], revenueBits: [2, 3, 4], priority: 90, coarseValue: 'high' as SKANCoarseValue, lockWindow: true },
+      view_item: { bits: [7], priority: 10, coarseValue: 'low' as SKANCoarseValue }
     }
   } as ConversionTemplate,
-  
+
+  // Gaming template - optimized for mobile games
+  // SKAN 4.0: purchase locks window, tutorial completion is medium value
   gaming: {
     name: 'gaming',
     events: {
-      level_complete: { bits: [0], priority: 40 },
-      tutorial_complete: { bits: [1], priority: 60 },
-      purchase: { bits: [2], revenueBits: [3, 4, 5], priority: 100 },
-      achievement_unlocked: { bits: [6], priority: 30 },
-      session_start: { bits: [7], priority: 10 },
-      ad_watched: { bits: [0, 6], priority: 20 }
+      level_complete: { bits: [0], priority: 40, coarseValue: 'medium' as SKANCoarseValue },
+      tutorial_complete: { bits: [1], priority: 60, coarseValue: 'medium' as SKANCoarseValue },
+      purchase: { bits: [2], revenueBits: [3, 4, 5], priority: 100, coarseValue: 'high' as SKANCoarseValue, lockWindow: true },
+      achievement_unlocked: { bits: [6], priority: 30, coarseValue: 'low' as SKANCoarseValue },
+      session_start: { bits: [7], priority: 10, coarseValue: 'low' as SKANCoarseValue },
+      ad_watched: { bits: [0, 6], priority: 20, coarseValue: 'low' as SKANCoarseValue }
     }
   } as ConversionTemplate,
-  
+
+  // Subscription template - optimized for subscription apps
+  // SKAN 4.0: subscribe/upgrade lock window, trial is medium value
   subscription: {
     name: 'subscription',
     events: {
-      trial_start: { bits: [0], priority: 70 },
-      subscribe: { bits: [1], revenueBits: [2, 3, 4], priority: 100 },
-      upgrade: { bits: [1, 5], revenueBits: [2, 3, 4], priority: 90 },
-      cancel: { bits: [6], priority: 20 },
-      signup: { bits: [7], priority: 30 },
-      payment_method_added: { bits: [0, 7], priority: 50 }
+      trial_start: { bits: [0], priority: 70, coarseValue: 'medium' as SKANCoarseValue },
+      subscribe: { bits: [1], revenueBits: [2, 3, 4], priority: 100, coarseValue: 'high' as SKANCoarseValue, lockWindow: true },
+      upgrade: { bits: [1, 5], revenueBits: [2, 3, 4], priority: 90, coarseValue: 'high' as SKANCoarseValue, lockWindow: true },
+      cancel: { bits: [6], priority: 20, coarseValue: 'low' as SKANCoarseValue },
+      signup: { bits: [7], priority: 30, coarseValue: 'low' as SKANCoarseValue },
+      payment_method_added: { bits: [0, 7], priority: 50, coarseValue: 'medium' as SKANCoarseValue }
     }
   } as ConversionTemplate
 }; 

package/src/datalyr-sdk-expo.ts

@@ -30,11 +30,13 @@ import {
 import { createHttpClient, HttpClient } from './http-client';
 import { createEventQueue, EventQueue } from './event-queue';
 import { attributionManager, AttributionData } from './attribution';
+import { journeyManager } from './journey';
 import { createAutoEventsManager, AutoEventsManager } from './auto-events';
 import { ConversionValueEncoder, ConversionTemplates } from './ConversionValueEncoder';
 import { SKAdNetworkBridge } from './native/SKAdNetworkBridge';
-import { metaIntegration, tiktokIntegration } from './integrations';
+import { metaIntegration, tiktokIntegration, appleSearchAdsIntegration } from './integrations';
 import { DeferredDeepLinkResult } from './types';
+import { AppleSearchAdsAttribution } from './native/DatalyrNativeBridge';
 
 export class DatalyrSDKExpo {
   private state: SDKState;
@@ -114,6 +116,24 @@ export class DatalyrSDKExpo {
         await attributionManager.initialize();
       }
 
+      // Initialize journey tracking (for first-touch, last-touch, touchpoints)
+      await journeyManager.initialize();
+
+      // Record initial attribution to journey if this is a new session with attribution
+      const initialAttribution = attributionManager.getAttributionData();
+      if (initialAttribution.utm_source || initialAttribution.fbclid || initialAttribution.gclid || initialAttribution.lyr) {
+        await journeyManager.recordAttribution(this.state.sessionId, {
+          source: initialAttribution.utm_source || initialAttribution.campaign_source,
+          medium: initialAttribution.utm_medium || initialAttribution.campaign_medium,
+          campaign: initialAttribution.utm_campaign || initialAttribution.campaign_name,
+          fbclid: initialAttribution.fbclid,
+          gclid: initialAttribution.gclid,
+          ttclid: initialAttribution.ttclid,
+          clickIdType: initialAttribution.fbclid ? 'fbclid' : initialAttribution.gclid ? 'gclid' : initialAttribution.ttclid ? 'ttclid' : undefined,
+          lyr: initialAttribution.lyr,
+        });
+      }
+
       if (this.state.config.enableAutoEvents) {
         this.autoEventsManager = new AutoEventsManager(
           this.track.bind(this),
@@ -176,6 +196,14 @@ export class DatalyrSDKExpo {
         }
       }
 
+      // Initialize Apple Search Ads attribution (iOS only, auto-fetches on init)
+      await appleSearchAdsIntegration.initialize(config.debug);
+      debugLog('Platform integrations initialized', {
+        meta: metaIntegration.isAvailable(),
+        tiktok: tiktokIntegration.isAvailable(),
+        appleSearchAds: appleSearchAdsIntegration.isAvailable(),
+      });
+
       this.state.initialized = true;
 
       if (attributionManager.isInstall()) {
@@ -432,8 +460,32 @@ export class DatalyrSDKExpo {
     return this.state.anonymousId;
   }
 
-  getAttributionData(): AttributionData {
-    return attributionManager.getAttributionData();
+  /**
+   * Get detailed attribution data (includes journey tracking data)
+   */
+  getAttributionData(): AttributionData & Record<string, any> {
+    const attribution = attributionManager.getAttributionData();
+    const journeyData = journeyManager.getAttributionData();
+
+    // Merge attribution with journey data
+    return {
+      ...attribution,
+      ...journeyData,
+    };
+  }
+
+  /**
+   * Get journey tracking summary
+   */
+  getJourneySummary() {
+    return journeyManager.getJourneySummary();
+  }
+
+  /**
+   * Get full customer journey (all touchpoints)
+   */
+  getJourney() {
+    return journeyManager.getJourney();
   }
 
   async setAttributionData(data: Partial<AttributionData>): Promise<void> {
@@ -468,6 +520,10 @@ export class DatalyrSDKExpo {
     }
   }
 
+  /**
+   * Track event with automatic SKAdNetwork conversion value encoding
+   * Uses SKAN 4.0 on iOS 16.1+ with coarse values and lock window support
+   */
   async trackWithSKAdNetwork(event: string, properties?: EventData): Promise<void> {
     await this.track(event, properties);
 
@@ -478,13 +534,15 @@ export class DatalyrSDKExpo {
       return;
     }
 
-    const conversionValue = DatalyrSDKExpo.conversionEncoder.encode(event, properties);
+    // Use SKAN 4.0 encoding (includes coarse value and lock window)
+    const result = DatalyrSDKExpo.conversionEncoder.encodeWithSKAN4(event, properties);
 
-    if (conversionValue > 0) {
-      const success = await SKAdNetworkBridge.updateConversionValue(conversionValue);
+    if (result.fineValue > 0 || result.priority > 0) {
+      // Use SKAN 4.0 method (automatically falls back to SKAN 3.0 on older iOS)
+      const success = await SKAdNetworkBridge.updatePostbackConversionValue(result);
 
       if (DatalyrSDKExpo.debugEnabled) {
-        debugLog(`Event: ${event}, Conversion Value: ${conversionValue}, Success: ${success}`, properties);
+        debugLog(`SKAN: event=${event}, fine=${result.fineValue}, coarse=${result.coarseValue}, lock=${result.lockWindow}, success=${success}`, properties);
       }
     }
   }
@@ -636,13 +694,22 @@ export class DatalyrSDKExpo {
     return null;
   }
 
-  getPlatformIntegrationStatus(): { meta: boolean; tiktok: boolean } {
+  getPlatformIntegrationStatus(): { meta: boolean; tiktok: boolean; appleSearchAds: boolean } {
     return {
       meta: metaIntegration.isAvailable(),
       tiktok: tiktokIntegration.isAvailable(),
+      appleSearchAds: appleSearchAdsIntegration.isAvailable(),
     };
   }
 
+  /**
+   * Get Apple Search Ads attribution data
+   * Returns attribution if user installed via Apple Search Ads, null otherwise
+   */
+  getAppleSearchAdsAttribution(): AppleSearchAdsAttribution | null {
+    return appleSearchAdsIntegration.getAttributionData();
+  }
+
   async updateTrackingAuthorization(authorized: boolean): Promise<void> {
     if (metaIntegration.isAvailable()) {
       metaIntegration.updateTrackingAuthorization(authorized);
@@ -694,6 +761,22 @@ export class DatalyrSDKExpo {
     const attributionData = attributionManager.getAttributionData();
     const networkType = await getNetworkType();
 
+    // Get Apple Search Ads attribution if available
+    const asaAttribution = appleSearchAdsIntegration.getAttributionData();
+    const asaData = asaAttribution?.attribution ? {
+      asa_campaign_id: asaAttribution.campaignId,
+      asa_campaign_name: asaAttribution.campaignName,
+      asa_ad_group_id: asaAttribution.adGroupId,
+      asa_ad_group_name: asaAttribution.adGroupName,
+      asa_keyword_id: asaAttribution.keywordId,
+      asa_keyword: asaAttribution.keyword,
+      asa_org_id: asaAttribution.orgId,
+      asa_org_name: asaAttribution.orgName,
+      asa_click_date: asaAttribution.clickDate,
+      asa_conversion_type: asaAttribution.conversionType,
+      asa_country_or_region: asaAttribution.countryOrRegion,
+    } : {};
+
     const payload: EventPayload = {
       workspaceId: this.state.config.workspaceId || 'mobile_sdk',
       visitorId: this.state.visitorId,
@@ -713,6 +796,8 @@ export class DatalyrSDKExpo {
         timestamp: Date.now(),
         sdk_variant: 'expo',
         ...attributionData,
+        // Apple Search Ads attribution
+        ...asaData,
       },
       fingerprintData,
       source: 'mobile_app',
@@ -945,10 +1030,14 @@ export class DatalyrExpo {
     return datalyrExpo.getDeferredAttributionData();
   }
 
-  static getPlatformIntegrationStatus(): { meta: boolean; tiktok: boolean } {
+  static getPlatformIntegrationStatus(): { meta: boolean; tiktok: boolean; appleSearchAds: boolean } {
     return datalyrExpo.getPlatformIntegrationStatus();
   }
 
+  static getAppleSearchAdsAttribution(): AppleSearchAdsAttribution | null {
+    return datalyrExpo.getAppleSearchAdsAttribution();
+  }
+
   static async updateTrackingAuthorization(authorized: boolean): Promise<void> {
     await datalyrExpo.updateTrackingAuthorization(authorized);
   }

package/src/datalyr-sdk.ts

@@ -27,10 +27,12 @@ import {
 import { createHttpClient, HttpClient } from './http-client';
 import { createEventQueue, EventQueue } from './event-queue';
 import { attributionManager, AttributionData } from './attribution';
+import { journeyManager } from './journey';
 import { createAutoEventsManager, AutoEventsManager, SessionData } from './auto-events';
 import { ConversionValueEncoder, ConversionTemplates } from './ConversionValueEncoder';
 import { SKAdNetworkBridge } from './native/SKAdNetworkBridge';
-import { metaIntegration, tiktokIntegration } from './integrations';
+import { metaIntegration, tiktokIntegration, appleSearchAdsIntegration, playInstallReferrerIntegration } from './integrations';
+import { AppleSearchAdsAttribution } from './native/DatalyrNativeBridge';
 
 export class DatalyrSDK {
   private state: SDKState;
@@ -123,6 +125,24 @@ export class DatalyrSDK {
         await attributionManager.initialize();
       }
 
+      // Initialize journey tracking (for first-touch, last-touch, touchpoints)
+      await journeyManager.initialize();
+
+      // Record initial attribution to journey if this is a new session with attribution
+      const initialAttribution = attributionManager.getAttributionData();
+      if (initialAttribution.utm_source || initialAttribution.fbclid || initialAttribution.gclid || initialAttribution.lyr) {
+        await journeyManager.recordAttribution(this.state.sessionId, {
+          source: initialAttribution.utm_source || initialAttribution.campaign_source,
+          medium: initialAttribution.utm_medium || initialAttribution.campaign_medium,
+          campaign: initialAttribution.utm_campaign || initialAttribution.campaign_name,
+          fbclid: initialAttribution.fbclid,
+          gclid: initialAttribution.gclid,
+          ttclid: initialAttribution.ttclid,
+          clickIdType: initialAttribution.fbclid ? 'fbclid' : initialAttribution.gclid ? 'gclid' : initialAttribution.ttclid ? 'ttclid' : undefined,
+          lyr: initialAttribution.lyr,
+        });
+      }
+
       // Initialize auto-events manager (asynchronously to avoid blocking)
       if (this.state.config.enableAutoEvents) {
         this.autoEventsManager = new AutoEventsManager(
@@ -181,9 +201,17 @@ export class DatalyrSDK {
         await tiktokIntegration.initialize(config.tiktok, config.debug);
       }
 
+      // Initialize Apple Search Ads attribution (iOS only, auto-fetches on init)
+      await appleSearchAdsIntegration.initialize(config.debug);
+
+      // Initialize Google Play Install Referrer (Android only)
+      await playInstallReferrerIntegration.initialize();
+
       debugLog('Platform integrations initialized', {
         meta: metaIntegration.isAvailable(),
         tiktok: tiktokIntegration.isAvailable(),
+        appleSearchAds: appleSearchAdsIntegration.isAvailable(),
+        playInstallReferrer: playInstallReferrerIntegration.isAvailable(),
       });
 
       // SDK initialized successfully - set state before tracking install event
@@ -485,6 +513,7 @@ export class DatalyrSDK {
     currentUserId?: string;
     queueStats: any;
     attribution: any;
+    journey: any;
   } {
     return {
       initialized: this.state.initialized,
@@ -495,6 +524,7 @@ export class DatalyrSDK {
       currentUserId: this.state.currentUserId,
       queueStats: this.eventQueue.getStats(),
       attribution: attributionManager.getAttributionSummary(),
+      journey: journeyManager.getJourneySummary(),
     };
   }
 
@@ -506,10 +536,31 @@ export class DatalyrSDK {
   }
 
   /**
-   * Get detailed attribution data
+   * Get detailed attribution data (includes journey tracking data)
+   */
+  getAttributionData(): AttributionData & Record<string, any> {
+    const attribution = attributionManager.getAttributionData();
+    const journeyData = journeyManager.getAttributionData();
+
+    // Merge attribution with journey data
+    return {
+      ...attribution,
+      ...journeyData,
+    };
+  }
+
+  /**
+   * Get journey tracking summary
+   */
+  getJourneySummary() {
+    return journeyManager.getJourneySummary();
+  }
+
+  /**
+   * Get full customer journey (all touchpoints)
    */
-  getAttributionData(): AttributionData {
-    return attributionManager.getAttributionData();
+  getJourney() {
+    return journeyManager.getJourney();
   }
 
   /**
@@ -566,15 +617,16 @@ export class DatalyrSDK {
 
   /**
    * Track event with automatic SKAdNetwork conversion value encoding
+   * Uses SKAN 4.0 on iOS 16.1+ with coarse values and lock window support
    */
   async trackWithSKAdNetwork(
-    event: string, 
+    event: string,
     properties?: EventData
   ): Promise<void> {
     // Existing tracking (keep exactly as-is)
     await this.track(event, properties);
 
-    // NEW: Automatic SKAdNetwork encoding
+    // Automatic SKAdNetwork encoding with SKAN 4.0 support
     if (!DatalyrSDK.conversionEncoder) {
       if (DatalyrSDK.debugEnabled) {
         errorLog('SKAdNetwork encoder not initialized. Pass skadTemplate in initialize()');
@@ -582,13 +634,15 @@ export class DatalyrSDK {
       return;
     }
 
-    const conversionValue = DatalyrSDK.conversionEncoder.encode(event, properties);
-    
-    if (conversionValue > 0) {
-      const success = await SKAdNetworkBridge.updateConversionValue(conversionValue);
-      
+    // Use SKAN 4.0 encoding (includes coarse value and lock window)
+    const result = DatalyrSDK.conversionEncoder.encodeWithSKAN4(event, properties);
+
+    if (result.fineValue > 0 || result.priority > 0) {
+      // Use SKAN 4.0 method (automatically falls back to SKAN 3.0 on older iOS)
+      const success = await SKAdNetworkBridge.updatePostbackConversionValue(result);
+
       if (DatalyrSDK.debugEnabled) {
-        debugLog(`Event: ${event}, Conversion Value: ${conversionValue}, Success: ${success}`, properties);
+        debugLog(`SKAN: event=${event}, fine=${result.fineValue}, coarse=${result.coarseValue}, lock=${result.lockWindow}, success=${success}`, properties);
       }
     } else if (DatalyrSDK.debugEnabled) {
       debugLog(`No conversion value generated for event: ${event}`);
@@ -832,13 +886,32 @@ export class DatalyrSDK {
   /**
    * Get platform integration status
    */
-  getPlatformIntegrationStatus(): { meta: boolean; tiktok: boolean } {
+  getPlatformIntegrationStatus(): { meta: boolean; tiktok: boolean; appleSearchAds: boolean; playInstallReferrer: boolean } {
     return {
       meta: metaIntegration.isAvailable(),
       tiktok: tiktokIntegration.isAvailable(),
+      appleSearchAds: appleSearchAdsIntegration.isAvailable(),
+      playInstallReferrer: playInstallReferrerIntegration.isAvailable(),
     };
   }
 
+  /**
+   * Get Apple Search Ads attribution data
+   * Returns attribution if user installed via Apple Search Ads, null otherwise
+   */
+  getAppleSearchAdsAttribution(): AppleSearchAdsAttribution | null {
+    return appleSearchAdsIntegration.getAttributionData();
+  }
+
+  /**
+   * Get Google Play Install Referrer attribution data (Android only)
+   * Returns referrer data if available, null otherwise
+   */
+  getPlayInstallReferrer(): Record<string, any> | null {
+    const data = playInstallReferrerIntegration.getReferrerData();
+    return data ? playInstallReferrerIntegration.getAttributionData() : null;
+  }
+
   /**
    * Update tracking authorization status on all platform SDKs
    * Call this AFTER the user responds to the ATT permission dialog
@@ -919,6 +992,22 @@ export class DatalyrSDK {
     const fingerprintData = await createFingerprintData();
     const attributionData = attributionManager.getAttributionData();
 
+    // Get Apple Search Ads attribution if available
+    const asaAttribution = appleSearchAdsIntegration.getAttributionData();
+    const asaData = asaAttribution?.attribution ? {
+      asa_campaign_id: asaAttribution.campaignId,
+      asa_campaign_name: asaAttribution.campaignName,
+      asa_ad_group_id: asaAttribution.adGroupId,
+      asa_ad_group_name: asaAttribution.adGroupName,
+      asa_keyword_id: asaAttribution.keywordId,
+      asa_keyword: asaAttribution.keyword,
+      asa_org_id: asaAttribution.orgId,
+      asa_org_name: asaAttribution.orgName,
+      asa_click_date: asaAttribution.clickDate,
+      asa_conversion_type: asaAttribution.conversionType,
+      asa_country_or_region: asaAttribution.countryOrRegion,
+    } : {};
+
     const payload: EventPayload = {
       workspaceId: this.state.config.workspaceId || 'mobile_sdk',
       visitorId: this.state.visitorId,
@@ -940,6 +1029,8 @@ export class DatalyrSDK {
         timestamp: Date.now(),
         // Attribution data
         ...attributionData,
+        // Apple Search Ads attribution
+        ...asaData,
       },
       fingerprintData,
       source: 'mobile_app',
@@ -1239,10 +1330,14 @@ export class Datalyr {
     return datalyr.getDeferredAttributionData();
   }
 
-  static getPlatformIntegrationStatus(): { meta: boolean; tiktok: boolean } {
+  static getPlatformIntegrationStatus(): { meta: boolean; tiktok: boolean; appleSearchAds: boolean } {
     return datalyr.getPlatformIntegrationStatus();
   }
 
+  static getAppleSearchAdsAttribution(): AppleSearchAdsAttribution | null {
+    return datalyr.getAppleSearchAdsAttribution();
+  }
+
   static async updateTrackingAuthorization(enabled: boolean): Promise<void> {
     await datalyr.updateTrackingAuthorization(enabled);
   }

package/src/expo.ts

@@ -22,6 +22,10 @@ export * from './types';
 // Export attribution manager
 export { attributionManager } from './attribution';
 
+// Export journey tracking
+export { journeyManager } from './journey';
+export type { TouchAttribution, TouchPoint } from './journey';
+
 // Export auto-events
 export { createAutoEventsManager, AutoEventsManager } from './auto-events';
 
@@ -52,5 +56,9 @@ export * from './event-queue';
 export { ConversionValueEncoder, ConversionTemplates } from './ConversionValueEncoder';
 export { SKAdNetworkBridge } from './native/SKAdNetworkBridge';
 
+// Export platform integrations
+export { appleSearchAdsIntegration } from './integrations';
+export type { AppleSearchAdsAttribution } from './native/DatalyrNativeBridge';
+
 // Default export
 export default datalyrExpo;

package/src/index.ts

@@ -12,6 +12,8 @@ export { Datalyr };
 // Export types and utilities
 export * from './types';
 export { attributionManager } from './attribution';
+export { journeyManager } from './journey';
+export type { TouchAttribution, TouchPoint } from './journey';
 export { createAutoEventsManager, AutoEventsManager } from './auto-events';
 
 // Re-export utilities for advanced usage
@@ -27,7 +29,10 @@ export { ConversionValueEncoder, ConversionTemplates } from './ConversionValueEn
 export { SKAdNetworkBridge } from './native/SKAdNetworkBridge';
 
 // Export platform integrations
-export { metaIntegration, tiktokIntegration } from './integrations';
+export { metaIntegration, tiktokIntegration, appleSearchAdsIntegration } from './integrations';
+
+// Export native bridge types
+export type { AppleSearchAdsAttribution } from './native/DatalyrNativeBridge';
 
 // Default export for compatibility
 export default DatalyrSDK;