@zaplier/sdk 1.7.6 → 1.7.8

package/dist/index.d.ts

@@ -766,6 +766,10 @@ declare class ZaplierSDK implements ZaplierSDK$1 {
      * Generate session ID using standardized format
      */
     private generateSessionId;
+    /**
+     * Update tracking engines with new session ID to maintain consistency
+     */
+    private updateTrackingEnginesSessionId;
     /**
      * Initialize Anti-Adblock Manager
      */
@@ -779,6 +783,10 @@ declare class ZaplierSDK implements ZaplierSDK$1 {
      * Check if running on localhost
      */
     private isLocalhost;
+    /**
+     * Extract UTM parameters from current URL
+     */
+    private extractUTMParameters;
     /**
      * Send event to backend
      */

package/dist/index.esm.js

@@ -21513,6 +21513,52 @@ class ZaplierSDK {
         const tempVisitorId = this.visitorId || 'temp-' + Date.now().toString(36);
         return generateCurrentSessionId(tempVisitorId);
     }
+    /**
+     * Update tracking engines with new session ID to maintain consistency
+     */
+    updateTrackingEnginesSessionId(newSessionId) {
+        try {
+            // Update replay engine session ID if it exists and is recording
+            if (this.replayEngine && this.replayEngine.isRecording()) {
+                if (this.config.debug) {
+                    console.log("[Zaplier] Updating replay engine session ID:", newSessionId);
+                }
+                // Stop current recording and restart with new session ID
+                this.replayEngine.stop();
+                this.replayEngine = new SessionReplayEngine(newSessionId, this.backendVisitorId || 'unknown', {
+                    sampleRate: 1.0, // Keep recording active
+                    inactivityTimeout: 30000,
+                    pauseOnInactive: true,
+                });
+                this.replayEngine.setSDKInstance(this);
+                this.replayEngine.start();
+            }
+            // Update heatmap engine session ID if it exists and is recording
+            if (this.heatmapEngine && this.heatmapEngine.isRecording()) {
+                if (this.config.debug) {
+                    console.log("[Zaplier] Updating heatmap engine session ID:", newSessionId);
+                }
+                // Stop current recording and restart with new session ID
+                this.heatmapEngine.stop();
+                this.heatmapEngine = new HeatmapEngine(newSessionId, {
+                    trackClicks: true,
+                    trackScrollDepth: true,
+                    trackRageClicks: true,
+                    trackMouseMoves: false,
+                });
+                if (this.antiAdblockManager) {
+                    this.heatmapEngine.setAntiAdblockManager(this.antiAdblockManager);
+                }
+                this.heatmapEngine.start();
+            }
+            if (this.config.debug) {
+                console.log("[Zaplier] Tracking engines updated with session ID:", newSessionId);
+            }
+        }
+        catch (error) {
+            console.error("[Zaplier] Failed to update tracking engines session ID:", error);
+        }
+    }
     /**
      * Initialize Anti-Adblock Manager
      */
@@ -21681,6 +21727,70 @@ class ZaplierSDK {
             window.location.hostname.startsWith("10.") ||
             window.location.hostname.includes("local"));
     }
+    /**
+     * Extract UTM parameters from current URL
+     */
+    extractUTMParameters() {
+        const utmParams = {};
+        if (typeof window === "undefined" || !window.location) {
+            return utmParams;
+        }
+        try {
+            const urlParams = new URLSearchParams(window.location.search);
+            // Extract UTM parameters (camelCase for consistency with backend)
+            const utmSource = urlParams.get('utm_source');
+            const utmMedium = urlParams.get('utm_medium');
+            const utmCampaign = urlParams.get('utm_campaign');
+            const utmContent = urlParams.get('utm_content');
+            const utmTerm = urlParams.get('utm_term');
+            // Extract click IDs
+            const fbclid = urlParams.get('fbclid');
+            const gclid = urlParams.get('gclid');
+            const ttclid = urlParams.get('ttclid');
+            // Extract ad platform parameters
+            const creativeId = urlParams.get('creative_id');
+            const adId = urlParams.get('ad_id');
+            const adsetId = urlParams.get('adset_id');
+            const campaignId = urlParams.get('campaign_id');
+            const platform = urlParams.get('platform');
+            // Add to result object (only non-null values)
+            if (utmSource)
+                utmParams.utmSource = utmSource;
+            if (utmMedium)
+                utmParams.utmMedium = utmMedium;
+            if (utmCampaign)
+                utmParams.utmCampaign = utmCampaign;
+            if (utmContent)
+                utmParams.utmContent = utmContent;
+            if (utmTerm)
+                utmParams.utmTerm = utmTerm;
+            if (fbclid)
+                utmParams.fbclid = fbclid;
+            if (gclid)
+                utmParams.gclid = gclid;
+            if (ttclid)
+                utmParams.ttclid = ttclid;
+            if (creativeId)
+                utmParams.creativeId = creativeId;
+            if (adId)
+                utmParams.adId = adId;
+            if (adsetId)
+                utmParams.adsetId = adsetId;
+            if (campaignId)
+                utmParams.campaignId = campaignId;
+            if (platform)
+                utmParams.platform = platform;
+            if (this.config.debug && Object.keys(utmParams).length > 0) {
+                console.log("[Zaplier] UTM parameters extracted from URL:", utmParams);
+            }
+        }
+        catch (error) {
+            if (this.config.debug) {
+                console.warn("[Zaplier] Failed to extract UTM parameters:", error);
+            }
+        }
+        return utmParams;
+    }
     /**
      * Send event to backend
      */
@@ -21722,7 +21832,9 @@ class ZaplierSDK {
                     }
                     : undefined,
                 fingerprintComponents: this.fingerprint?.components || {},
-                ...eventData,
+                // CRITICAL: Auto-extract UTM parameters from URL, but allow eventData to override
+                ...this.extractUTMParameters(), // Auto-extracted UTM parameters (background)
+                ...eventData, // User-provided event data (can override UTM parameters)
                 timestamp: new Date().toISOString(),
                 url: typeof window !== "undefined" && window.location
                     ? window.location.href
@@ -21767,12 +21879,25 @@ class ZaplierSDK {
                     console.log("[Zaplier] Backend visitor ID received and processed:", response.visitorId);
                 }
             }
-            if (response.sessionId) {
+            // CRITICAL: Only update session ID if we don't have one yet or if it's temporary
+            // Once a session ID is established and tracking engines are started, keep it consistent
+            // to prevent replay/event session ID mismatches
+            if (response.sessionId && (!this.sessionId || this.sessionId.includes('temp-'))) {
+                const oldSessionId = this.sessionId;
                 this.sessionId = response.sessionId;
+                // Update tracking engines with new session ID if they exist
+                if (oldSessionId !== this.sessionId && this.sessionId) {
+                    this.updateTrackingEnginesSessionId(this.sessionId);
+                }
             }
             else if (this.backendVisitorId && (!this.sessionId || this.sessionId.includes('temp-'))) {
                 // Generate new session ID now that we have the proper visitor ID
+                const oldSessionId = this.sessionId;
                 this.sessionId = generateCurrentSessionId(this.backendVisitorId);
+                // Update tracking engines with new session ID if they exist
+                if (oldSessionId !== this.sessionId && this.sessionId) {
+                    this.updateTrackingEnginesSessionId(this.sessionId);
+                }
             }
             return response;
         }