@mparticle/web-sdk 2.32.5 → 2.33.1

package/dist/mparticle.js

@@ -203,7 +203,7 @@ var mParticle = (function () {
       Base64: Base64$1
     };
 
-    var version = "2.32.5";
+    var version = "2.33.1";
 
     var Constants = {
       sdkVersion: version,
@@ -713,9 +713,14 @@ var mParticle = (function () {
       pairs.forEach(function (pair) {
         var _a = pair.split('='),
           key = _a[0],
-          value = _a[1];
-        if (key && value) {
-          params[key] = decodeURIComponent(value || '');
+          valueParts = _a.slice(1);
+        var value = valueParts.join('=');
+        if (key && value !== undefined) {
+          try {
+            params[key] = decodeURIComponent(value || '');
+          } catch (e) {
+            console.error("Failed to decode value for key ".concat(key, ": ").concat(e));
+          }
         }
       });
       return {
@@ -1923,7 +1928,8 @@ var mParticle = (function () {
         session_start_unixtime_ms: sdkEvent.SessionStartDate,
         custom_attributes: sdkEvent.EventAttributes,
         location: convertSDKLocation(sdkEvent.Location),
-        source_message_id: sdkEvent.SourceMessageId
+        source_message_id: sdkEvent.SourceMessageId,
+        active_time_on_site_ms: sdkEvent.ActiveTimeOnSite
       };
       return commonEventData;
     }
@@ -3380,21 +3386,23 @@ var mParticle = (function () {
         }
       };
       this.endSession = function (override) {
-        var _a;
+        var _a, _b, _c, _d, _e;
         mpInstance.Logger.verbose(Messages$6.InformationMessages.StartingEndSession);
         if (override) {
           mpInstance._Events.logEvent({
             messageType: Types.MessageType.SessionEnd
           });
           mpInstance._Store.nullifySession();
+          (_a = mpInstance._timeOnSiteTimer) === null || _a === void 0 ? void 0 : _a.resetTimer();
           return;
         }
         if (!mpInstance._Helpers.canLog()) {
-          // At this moment, an AbandonedEndSession is defined when on of three things occurs:
+          // At this moment, an AbandonedEndSession is defined when one of three things occurs:
           // - the SDK's store is not enabled because mParticle.setOptOut was called
           // - the devToken is undefined
           // - webviewBridgeEnabled is set to false
           mpInstance.Logger.verbose(Messages$6.InformationMessages.AbandonEndSession);
+          (_b = mpInstance._timeOnSiteTimer) === null || _b === void 0 ? void 0 : _b.resetTimer();
           return;
         }
         var sessionTimeoutInMilliseconds;
@@ -3402,13 +3410,14 @@ var mParticle = (function () {
         var cookies = mpInstance._Persistence.getPersistence();
         if (!cookies || cookies.gs && !cookies.gs.sid) {
           mpInstance.Logger.verbose(Messages$6.InformationMessages.NoSessionToEnd);
+          (_c = mpInstance._timeOnSiteTimer) === null || _c === void 0 ? void 0 : _c.resetTimer();
           return;
         }
         // sessionId is not equal to cookies.sid if cookies.sid is changed in another tab
         if (cookies.gs.sid && mpInstance._Store.sessionId !== cookies.gs.sid) {
           mpInstance._Store.sessionId = cookies.gs.sid;
         }
-        if ((_a = cookies === null || cookies === void 0 ? void 0 : cookies.gs) === null || _a === void 0 ? void 0 : _a.les) {
+        if ((_d = cookies === null || cookies === void 0 ? void 0 : cookies.gs) === null || _d === void 0 ? void 0 : _d.les) {
           sessionTimeoutInMilliseconds = mpInstance._Store.SDKConfig.sessionTimeout * 60000;
           var newDate = new Date().getTime();
           timeSinceLastEventSent = newDate - cookies.gs.les;
@@ -3422,6 +3431,7 @@ var mParticle = (function () {
             mpInstance._Store.nullifySession();
           }
         }
+        (_e = mpInstance._timeOnSiteTimer) === null || _e === void 0 ? void 0 : _e.resetTimer();
       };
       this.setSessionTimer = function () {
         var sessionTimeoutInMilliseconds = mpInstance._Store.SDKConfig.sessionTimeout * 60000;
@@ -3872,6 +3882,109 @@ var mParticle = (function () {
       };
     }
 
+    var ForegroundTimeTracker = /** @class */function () {
+      function ForegroundTimeTracker(timerKey) {
+        this.isTrackerActive = false;
+        this.localStorageName = '';
+        this.startTime = 0;
+        this.totalTime = 0;
+        this.localStorageName = "mprtcl-tos-".concat(timerKey);
+        this.timerVault = new LocalStorageVault(this.localStorageName);
+        this.loadTimeFromStorage();
+        this.addHandlers();
+        if (document.hidden === false) {
+          this.startTracking();
+        }
+      }
+      ForegroundTimeTracker.prototype.addHandlers = function () {
+        var _this = this;
+        // when user switches tabs or minimizes the window
+        document.addEventListener('visibilitychange', function () {
+          return _this.handleVisibilityChange();
+        });
+        // when user switches to another application
+        window.addEventListener('blur', function () {
+          return _this.handleWindowBlur();
+        });
+        // when window gains focus
+        window.addEventListener('focus', function () {
+          return _this.handleWindowFocus();
+        });
+        // this ensures that timers between tabs are in sync
+        window.addEventListener('storage', function (event) {
+          return _this.syncAcrossTabs(event);
+        });
+        // when user closes tab, refreshes, or navigates to another page via link
+        window.addEventListener('beforeunload', function () {
+          return _this.updateTimeInPersistence();
+        });
+      };
+      ForegroundTimeTracker.prototype.handleVisibilityChange = function () {
+        if (document.hidden) {
+          this.stopTracking();
+        } else {
+          this.startTracking();
+        }
+      };
+      ForegroundTimeTracker.prototype.handleWindowBlur = function () {
+        if (this.isTrackerActive) {
+          this.stopTracking();
+        }
+      };
+      ForegroundTimeTracker.prototype.handleWindowFocus = function () {
+        if (!this.isTrackerActive) {
+          this.startTracking();
+        }
+      };
+      ForegroundTimeTracker.prototype.syncAcrossTabs = function (event) {
+        if (event.key === this.localStorageName && event.newValue !== null) {
+          var newTime = parseFloat(event.newValue) || 0;
+          this.totalTime = newTime;
+        }
+      };
+      ForegroundTimeTracker.prototype.updateTimeInPersistence = function () {
+        if (this.isTrackerActive) {
+          this.timerVault.store(Math.round(this.totalTime));
+        }
+      };
+      ForegroundTimeTracker.prototype.loadTimeFromStorage = function () {
+        var storedTime = this.timerVault.retrieve();
+        if (isNumber(storedTime) && storedTime !== null) {
+          this.totalTime = storedTime;
+        }
+      };
+      ForegroundTimeTracker.prototype.startTracking = function () {
+        if (!document.hidden) {
+          this.startTime = Math.floor(performance.now());
+          this.isTrackerActive = true;
+        }
+      };
+      ForegroundTimeTracker.prototype.stopTracking = function () {
+        if (this.isTrackerActive) {
+          this.setTotalTime();
+          this.updateTimeInPersistence();
+          this.isTrackerActive = false;
+        }
+      };
+      ForegroundTimeTracker.prototype.setTotalTime = function () {
+        if (this.isTrackerActive) {
+          var now = Math.floor(performance.now());
+          this.totalTime += now - this.startTime;
+          this.startTime = now;
+        }
+      };
+      ForegroundTimeTracker.prototype.getTimeInForeground = function () {
+        this.setTotalTime();
+        this.updateTimeInPersistence();
+        return this.totalTime;
+      };
+      ForegroundTimeTracker.prototype.resetTimer = function () {
+        this.totalTime = 0;
+        this.updateTimeInPersistence();
+      };
+      return ForegroundTimeTracker;
+    }();
+
     function createSDKConfig(config) {
       // TODO: Refactor to create a default config object
       var sdkConfig = {};
@@ -4220,6 +4333,7 @@ var mParticle = (function () {
         }
         if (workspaceToken) {
           _this.SDKConfig.workspaceToken = workspaceToken;
+          mpInstance._timeOnSiteTimer = new ForegroundTimeTracker(workspaceToken);
         } else {
           mpInstance.Logger.warning('You should have a workspaceToken on your config object for security purposes.');
         }
@@ -6529,6 +6643,7 @@ var mParticle = (function () {
         return jsonObject;
       };
       this.createEventObject = function (event, user) {
+        var _a;
         var uploadObject = {};
         var eventObject = {};
         //  The `optOut` variable is passed later in this method to the `uploadObject`
@@ -6539,6 +6654,7 @@ var mParticle = (function () {
         // TODO: Why is Webview Bridge Enabled or Opt Out necessary here?
         if (mpInstance._Store.sessionId || event.messageType === Types.MessageType.OptOut || mpInstance._Store.webviewBridgeEnabled) {
           var customFlags = __assign({}, event.customFlags);
+          var integrationAttributes = mpInstance._Store.integrationAttributes;
           // https://go.mparticle.com/work/SQDSDKS-5053
           if (mpInstance._Helpers.getFeatureFlag && mpInstance._Helpers.getFeatureFlag(Constants.FeatureFlags.CaptureIntegrationSpecificIds)) {
             // Attempt to recapture click IDs in case a third party integration
@@ -6546,6 +6662,8 @@ var mParticle = (function () {
             mpInstance._IntegrationCapture.capture();
             var transformedClickIDs = mpInstance._IntegrationCapture.getClickIdsAsCustomFlags();
             customFlags = __assign(__assign({}, transformedClickIDs), customFlags);
+            var transformedIntegrationAttributes = mpInstance._IntegrationCapture.getClickIdsAsIntegrationAttributes();
+            integrationAttributes = __assign(__assign({}, transformedIntegrationAttributes), integrationAttributes);
           }
           if (event.hasOwnProperty('toEventAPIObject')) {
             eventObject = event.toEventAPIObject();
@@ -6557,6 +6675,7 @@ var mParticle = (function () {
               EventName: event.name || event.messageType,
               EventCategory: event.eventType,
               EventAttributes: mpInstance._Helpers.sanitizeAttributes(event.data, event.name),
+              ActiveTimeOnSite: (_a = mpInstance._timeOnSiteTimer) === null || _a === void 0 ? void 0 : _a.getTimeInForeground(),
               SourceMessageId: event.sourceMessageId || mpInstance._Helpers.generateUniqueId(),
               EventDataType: event.messageType,
               CustomFlags: customFlags,
@@ -6583,7 +6702,7 @@ var mParticle = (function () {
             Package: mpInstance._Store.SDKConfig["package"],
             ClientGeneratedId: mpInstance._Store.clientId,
             DeviceId: mpInstance._Store.deviceId,
-            IntegrationAttributes: mpInstance._Store.integrationAttributes,
+            IntegrationAttributes: integrationAttributes,
             CurrencyCode: mpInstance._Store.currencyCode,
             DataPlan: mpInstance._Store.SDKConfig.dataPlan ? mpInstance._Store.SDKConfig.dataPlan : {}
           };
@@ -9201,9 +9320,11 @@ var mParticle = (function () {
     // Integration outputs are used to determine how click ids are used within the SDK
     // CUSTOM_FLAGS are sent out when an Event is created via ServerModel.createEventObject
     // PARTNER_IDENTITIES are sent out in a Batch when a group of events are converted to a Batch
+    // INTEGRATION_ATTRIBUTES are stored initially on the SDKEvent level but then is added to the Batch when the batch is created
     var IntegrationOutputs = {
       CUSTOM_FLAGS: 'custom_flags',
-      PARTNER_IDENTITIES: 'partner_identities'
+      PARTNER_IDENTITIES: 'partner_identities',
+      INTEGRATION_ATTRIBUTES: 'integration_attributes'
     };
     var integrationMapping = {
       // Facebook / Meta
@@ -9233,6 +9354,18 @@ var mParticle = (function () {
         mappedKey: 'GoogleEnhancedConversions.Wbraid',
         output: IntegrationOutputs.CUSTOM_FLAGS
       },
+      // Rokt
+      // https://docs.rokt.com/developers/integration-guides/web/advanced/rokt-id-tag/
+      rtid: {
+        mappedKey: 'passbackconversiontrackingid',
+        output: IntegrationOutputs.INTEGRATION_ATTRIBUTES,
+        moduleId: 1277
+      },
+      RoktTransactionId: {
+        mappedKey: 'passbackconversiontrackingid',
+        output: IntegrationOutputs.INTEGRATION_ATTRIBUTES,
+        moduleId: 1277
+      },
       // TIKTOK
       ttclid: {
         mappedKey: 'TikTok.Callback',
@@ -9249,6 +9382,7 @@ var mParticle = (function () {
         // Cache filtered mappings for faster access
         this.filteredPartnerIdentityMappings = this.filterMappings(IntegrationOutputs.PARTNER_IDENTITIES);
         this.filteredCustomFlagMappings = this.filterMappings(IntegrationOutputs.CUSTOM_FLAGS);
+        this.filteredIntegrationAttributeMappings = this.filterMappings(IntegrationOutputs.INTEGRATION_ATTRIBUTES);
       }
       /**
        * Captures Integration Ids from cookies and query params and stores them in clickIds object
@@ -9256,19 +9390,33 @@ var mParticle = (function () {
       IntegrationCapture.prototype.capture = function () {
         var queryParams = this.captureQueryParams() || {};
         var cookies = this.captureCookies() || {};
+        var localStorage = this.captureLocalStorage() || {};
         // Exclude _fbc if fbclid is present
         // https://developers.facebook.com/docs/marketing-api/conversions-api/parameters/fbp-and-fbc#retrieve-from-fbclid-url-query-parameter
         if (queryParams['fbclid'] && cookies['_fbc']) {
           delete cookies['_fbc'];
         }
-        this.clickIds = __assign(__assign(__assign({}, this.clickIds), queryParams), cookies);
+        // If both rtid and RoktTransactionId are present, prioritize rtid
+        // If RoktTransactionId is present in both cookies and localStorage,
+        // prioritize localStorage
+        if (queryParams['rtid'] && localStorage['RoktTransactionId'] && cookies['RoktTransactionId']) {
+          delete localStorage['RoktTransactionId'];
+          delete cookies['RoktTransactionId'];
+        } else if (queryParams['rtid'] && localStorage['RoktTransactionId']) {
+          delete localStorage['RoktTransactionId'];
+        } else if (queryParams['rtid'] && cookies['RoktTransactionId']) {
+          delete cookies['RoktTransactionId'];
+        } else if (localStorage['RoktTransactionId'] && cookies['RoktTransactionId']) {
+          delete cookies['RoktTransactionId'];
+        }
+        this.clickIds = __assign(__assign(__assign(__assign({}, this.clickIds), queryParams), localStorage), cookies);
       };
       /**
        * Captures cookies based on the integration ID mapping.
        */
       IntegrationCapture.prototype.captureCookies = function () {
         var cookies = getCookies(Object.keys(integrationMapping));
-        return this.applyProcessors(cookies);
+        return this.applyProcessors(cookies, getHref(), this.initialTimestamp);
       };
       /**
        * Captures query parameters based on the integration ID mapping.
@@ -9277,6 +9425,19 @@ var mParticle = (function () {
         var queryParams = this.getQueryParams();
         return this.applyProcessors(queryParams, getHref(), this.initialTimestamp);
       };
+      /**
+       * Captures local storage based on the integration ID mapping.
+       */
+      IntegrationCapture.prototype.captureLocalStorage = function () {
+        var localStorageItems = {};
+        for (var key in integrationMapping) {
+          var localStorageItem = localStorage.getItem(key);
+          if (localStorageItem) {
+            localStorageItems[key] = localStorageItem;
+          }
+        }
+        return this.applyProcessors(localStorageItems, getHref(), this.initialTimestamp);
+      };
       /**
        * Gets the query parameters based on the integration ID mapping.
        * @returns {Dictionary<string>} The query parameters.
@@ -9298,6 +9459,36 @@ var mParticle = (function () {
       IntegrationCapture.prototype.getClickIdsAsPartnerIdentities = function () {
         return this.getClickIds(this.clickIds, this.filteredPartnerIdentityMappings);
       };
+      /**
+       * Returns only the `integration_attributes` mapped integration output.
+       * @returns {IntegrationAttributes} The integration attributes.
+       */
+      IntegrationCapture.prototype.getClickIdsAsIntegrationAttributes = function () {
+        var _a;
+        var _b, _c;
+        // Integration IDs are stored in the following format:
+        // {
+        //     "integration_attributes": {
+        //         "<moduleId>": {
+        //           "mappedKey": "clickIdValue"
+        //         }
+        //     }
+        // }
+        var mappedClickIds = {};
+        for (var key in this.clickIds) {
+          if (this.clickIds.hasOwnProperty(key)) {
+            var value = this.clickIds[key];
+            var mappingKey = (_b = this.filteredIntegrationAttributeMappings[key]) === null || _b === void 0 ? void 0 : _b.mappedKey;
+            if (!isEmpty(mappingKey)) {
+              var moduleId = (_c = this.filteredIntegrationAttributeMappings[key]) === null || _c === void 0 ? void 0 : _c.moduleId;
+              if (moduleId && !mappedClickIds[moduleId]) {
+                mappedClickIds[moduleId] = (_a = {}, _a[mappingKey] = value, _a);
+              }
+            }
+          }
+        }
+        return mappedClickIds;
+      };
       IntegrationCapture.prototype.getClickIds = function (clickIds, mappingList) {
         var _a;
         var mappedClickIds = {};
@@ -10472,6 +10663,9 @@ var mParticle = (function () {
           },
           _resetForTests: mockFunction,
           _APIClient: null,
+          _timeOnSiteTimer: {
+            getTimeInForeground: mockFunction
+          },
           MPSideloadedKit: null,
           _Consent: null,
           _Events: null,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@mparticle/web-sdk",
-    "version": "2.32.5",
+    "version": "2.33.1",
     "description": "mParticle core SDK for web applications",
     "license": "Apache-2.0",
     "keywords": [
@@ -87,7 +87,7 @@
         "@babel/preset-env": "^7.6.0",
         "@babel/preset-typescript": "^7.6.0",
         "@mparticle/data-planning-models": "^0.1.0",
-        "@mparticle/event-models": "^1.1.8",
+        "@mparticle/event-models": "^1.1.9",
         "@rollup/plugin-babel": "6.0.3",
         "@rollup/plugin-commonjs": "25.0.4",
         "@rollup/plugin-json": "^5.0.2",

package/src/foregroundTimeTracker.ts

@@ -0,0 +1,113 @@
+import { isNumber } from './utils';
+import { LocalStorageVault } from './vault';
+
+export default class ForegroundTimeTracker {
+    private isTrackerActive: boolean = false;
+    private localStorageName: string = '';
+    private timerVault: LocalStorageVault<number>;
+    public startTime: number = 0;
+    public totalTime: number = 0;
+
+    constructor(timerKey: string) {
+        this.localStorageName = `mprtcl-tos-${timerKey}`;
+        this.timerVault = new LocalStorageVault<number>(this.localStorageName);
+        this.loadTimeFromStorage();
+        this.addHandlers();
+        if (document.hidden === false) {
+            this.startTracking();
+        }
+    }
+
+    private addHandlers(): void {
+        // when user switches tabs or minimizes the window
+        document.addEventListener('visibilitychange', () =>
+            this.handleVisibilityChange()
+        );
+        // when user switches to another application
+        window.addEventListener('blur', () => this.handleWindowBlur());
+        // when window gains focus
+        window.addEventListener('focus', () => this.handleWindowFocus());
+        // this ensures that timers between tabs are in sync
+        window.addEventListener('storage', event => this.syncAcrossTabs(event));
+        // when user closes tab, refreshes, or navigates to another page via link
+        window.addEventListener('beforeunload', () =>
+            this.updateTimeInPersistence()
+        );
+    }
+
+    private handleVisibilityChange(): void {
+        if (document.hidden) {
+            this.stopTracking();
+        } else {
+            this.startTracking();
+        }
+    }
+
+    private handleWindowBlur(): void {
+        if (this.isTrackerActive) {
+            this.stopTracking();
+        }
+    }
+
+    private handleWindowFocus(): void {
+        if (!this.isTrackerActive) {
+            this.startTracking();
+        }
+    }
+
+    private syncAcrossTabs(event: StorageEvent): void {
+        if (event.key === this.localStorageName && event.newValue !== null) {
+            const newTime = parseFloat(event.newValue) || 0;
+            this.totalTime = newTime;
+        }
+    }
+
+    public updateTimeInPersistence(): void {
+        if (this.isTrackerActive) {
+            this.timerVault.store(Math.round(this.totalTime));
+        }
+    }
+
+    private loadTimeFromStorage(): void {
+        const storedTime = this.timerVault.retrieve();
+        if (isNumber(storedTime) && storedTime !== null) {
+            this.totalTime = storedTime;
+        }
+    }
+
+
+    private startTracking(): void {
+        if (!document.hidden) {
+            this.startTime = Math.floor(performance.now());
+            this.isTrackerActive = true;
+        }
+    }
+
+    private stopTracking(): void {
+        if (this.isTrackerActive) {
+            this.setTotalTime();
+            this.updateTimeInPersistence();
+            this.isTrackerActive = false;
+        }
+    }
+
+    private setTotalTime(): void {
+        if (this.isTrackerActive) {
+            const now = Math.floor(performance.now());
+            this.totalTime += now - this.startTime;
+            this.startTime = now;
+
+        }
+    }
+
+    public getTimeInForeground(): number {
+        this.setTotalTime();
+        this.updateTimeInPersistence();
+        return this.totalTime;
+    }
+
+    public resetTimer(): void {
+        this.totalTime = 0;
+        this.updateTimeInPersistence();
+    }
+}

package/src/integrationCapture.ts

@@ -1,4 +1,5 @@
 import { SDKEventCustomFlags } from './sdkRuntimeModels';
+import { IntegrationAttributes } from './store';
 import {
     Dictionary,
     queryStringParser,
@@ -53,16 +54,19 @@ export const facebookClickIdProcessor: IntegrationCaptureProcessorFunction = (
 // Integration outputs are used to determine how click ids are used within the SDK
 // CUSTOM_FLAGS are sent out when an Event is created via ServerModel.createEventObject
 // PARTNER_IDENTITIES are sent out in a Batch when a group of events are converted to a Batch
+// INTEGRATION_ATTRIBUTES are stored initially on the SDKEvent level but then is added to the Batch when the batch is created
 
 const IntegrationOutputs = {
     CUSTOM_FLAGS: 'custom_flags',
     PARTNER_IDENTITIES: 'partner_identities',
+    INTEGRATION_ATTRIBUTES: 'integration_attributes',
 } as const;
 
 interface IntegrationMappingItem {
     mappedKey: string;
     output: valueof<typeof IntegrationOutputs>;
     processor?: IntegrationCaptureProcessorFunction;
+    moduleId?: number;
 }
 
 interface IntegrationIdMapping {
@@ -99,6 +103,19 @@ const integrationMapping: IntegrationIdMapping = {
         output: IntegrationOutputs.CUSTOM_FLAGS,
     },
 
+    // Rokt
+    // https://docs.rokt.com/developers/integration-guides/web/advanced/rokt-id-tag/
+    rtid: {
+        mappedKey: 'passbackconversiontrackingid',
+        output: IntegrationOutputs.INTEGRATION_ATTRIBUTES,
+        moduleId: 1277,
+    },
+    RoktTransactionId: {
+        mappedKey: 'passbackconversiontrackingid',
+        output: IntegrationOutputs.INTEGRATION_ATTRIBUTES,
+        moduleId: 1277,
+    },
+
     // TIKTOK
     ttclid: {
         mappedKey: 'TikTok.Callback',
@@ -115,6 +132,7 @@ export default class IntegrationCapture {
     public readonly initialTimestamp: number;
     public readonly filteredPartnerIdentityMappings: IntegrationIdMapping;
     public readonly filteredCustomFlagMappings: IntegrationIdMapping;
+    public readonly filteredIntegrationAttributeMappings: IntegrationIdMapping;
 
     constructor() {
         this.initialTimestamp = Date.now();
@@ -122,6 +140,7 @@ export default class IntegrationCapture {
         // Cache filtered mappings for faster access
         this.filteredPartnerIdentityMappings = this.filterMappings(IntegrationOutputs.PARTNER_IDENTITIES);
         this.filteredCustomFlagMappings = this.filterMappings(IntegrationOutputs.CUSTOM_FLAGS);
+        this.filteredIntegrationAttributeMappings = this.filterMappings(IntegrationOutputs.INTEGRATION_ATTRIBUTES);
     }
 
     /**
@@ -130,6 +149,7 @@ export default class IntegrationCapture {
     public capture(): void {
         const queryParams = this.captureQueryParams() || {};
         const cookies = this.captureCookies() || {};
+        const localStorage = this.captureLocalStorage() || {};
 
         // Exclude _fbc if fbclid is present
         // https://developers.facebook.com/docs/marketing-api/conversions-api/parameters/fbp-and-fbc#retrieve-from-fbclid-url-query-parameter
@@ -137,7 +157,21 @@ export default class IntegrationCapture {
             delete cookies['_fbc'];
         }
 
-        this.clickIds = { ...this.clickIds, ...queryParams, ...cookies };
+        // If both rtid and RoktTransactionId are present, prioritize rtid
+        // If RoktTransactionId is present in both cookies and localStorage,
+        // prioritize localStorage
+        if (queryParams['rtid'] && localStorage['RoktTransactionId'] && cookies['RoktTransactionId']) {
+            delete localStorage['RoktTransactionId'];
+            delete cookies['RoktTransactionId'];
+        } else if (queryParams['rtid'] && localStorage['RoktTransactionId']) {
+            delete localStorage['RoktTransactionId'];
+        } else if (queryParams['rtid'] && cookies['RoktTransactionId']) {
+            delete cookies['RoktTransactionId'];
+        } else if (localStorage['RoktTransactionId'] && cookies['RoktTransactionId']) {
+            delete cookies['RoktTransactionId'];
+        }
+
+        this.clickIds = { ...this.clickIds, ...queryParams, ...localStorage, ...cookies };
     }
 
     /**
@@ -145,7 +179,7 @@ export default class IntegrationCapture {
      */
     public captureCookies(): Dictionary<string> {
         const cookies = getCookies(Object.keys(integrationMapping));
-        return this.applyProcessors(cookies);
+        return this.applyProcessors(cookies, getHref(), this.initialTimestamp);
     }
 
     /**
@@ -156,6 +190,21 @@ export default class IntegrationCapture {
         return this.applyProcessors(queryParams, getHref(), this.initialTimestamp);
     }
 
+    /**
+     * Captures local storage based on the integration ID mapping.
+     */
+    public captureLocalStorage(): Dictionary<string> {
+        let localStorageItems: Dictionary<string> = {};
+        for (const key in integrationMapping) {
+            const localStorageItem = localStorage.getItem(key);
+            if (localStorageItem) {
+                localStorageItems[key] = localStorageItem;
+            }
+        }
+
+        return this.applyProcessors(localStorageItems, getHref(), this.initialTimestamp);
+    }
+
     /**
      * Gets the query parameters based on the integration ID mapping.
      * @returns {Dictionary<string>} The query parameters.
@@ -180,6 +229,37 @@ export default class IntegrationCapture {
         return this.getClickIds(this.clickIds, this.filteredPartnerIdentityMappings);
     }
 
+    /**
+     * Returns only the `integration_attributes` mapped integration output.
+     * @returns {IntegrationAttributes} The integration attributes.
+     */
+    public getClickIdsAsIntegrationAttributes(): IntegrationAttributes {
+        // Integration IDs are stored in the following format:
+        // {
+        //     "integration_attributes": {
+        //         "<moduleId>": {
+        //           "mappedKey": "clickIdValue"
+        //         }
+        //     }
+        // }
+        const mappedClickIds: IntegrationAttributes = {};
+
+        for (const key in this.clickIds) {
+            if (this.clickIds.hasOwnProperty(key)) {
+                const value = this.clickIds[key];
+                const mappingKey = this.filteredIntegrationAttributeMappings[key]?.mappedKey;
+                if (!isEmpty(mappingKey)) {
+                    const moduleId = this.filteredIntegrationAttributeMappings[key]?.moduleId;
+                    if (moduleId && !mappedClickIds[moduleId]) {
+                        mappedClickIds[moduleId] = { [mappingKey]: value };
+                    }
+                }
+            }
+        }
+        return mappedClickIds;
+    }
+    
+
     private getClickIds(
         clickIds: Dictionary<string>,
         mappingList: IntegrationIdMapping

package/src/mockBatchCreator.ts

@@ -30,6 +30,9 @@ export default class _BatchValidator {
             },
             _resetForTests: mockFunction,
             _APIClient: null,
+            _timeOnSiteTimer: {
+                getTimeInForeground: mockFunction
+            },
             MPSideloadedKit: null,
             _Consent: null,
             _Events: null,