@grainql/analytics-web 2.2.0 → 2.3.0

package/dist/page-tracking.js

@@ -5,12 +5,16 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PageTrackingManager = void 0;
+const attribution_1 = require("./attribution");
 class PageTrackingManager {
     constructor(tracker, config) {
         this.isDestroyed = false;
         this.currentPath = null;
         this.originalPushState = null;
         this.originalReplaceState = null;
+        this.previousPage = null;
+        this.landingPage = null;
+        this.pageViewCount = 0;
         /**
          * Handle popstate event (back/forward navigation)
          */
@@ -29,8 +33,8 @@ class PageTrackingManager {
         };
         this.tracker = tracker;
         this.config = config;
-        // Track initial page load
-        this.trackCurrentPage();
+        // Track initial page load (this is the landing page)
+        this.trackCurrentPage(true);
         // Setup listeners
         this.setupHistoryListeners();
         this.setupHashChangeListener();
@@ -67,16 +71,39 @@ class PageTrackingManager {
     /**
      * Track the current page
      */
-    trackCurrentPage() {
+    trackCurrentPage(isLanding = false) {
         if (this.isDestroyed || typeof window === 'undefined')
             return;
         const page = this.extractPath(window.location.href);
-        // Don't track if it's the same page
-        if (page === this.currentPath) {
+        // Don't track if it's the same page (unless it's the landing page)
+        if (!isLanding && page === this.currentPath) {
             return;
         }
+        // Store previous page before updating
+        if (this.currentPath) {
+            this.previousPage = this.currentPath;
+        }
         this.currentPath = page;
+        this.pageViewCount++;
+        // Set landing page on first view
+        if (isLanding) {
+            this.landingPage = page;
+        }
         const hasConsent = this.tracker.hasConsent('analytics');
+        const currentUrl = window.location.href;
+        const referrer = document.referrer || '';
+        // Parse UTM parameters from current URL
+        const utmParams = (0, attribution_1.parseUTMParameters)(currentUrl);
+        // Store session UTM if they exist (first time only or if new UTMs appear)
+        if (Object.keys(utmParams).length > 0) {
+            const existing = (0, attribution_1.getSessionUTMParameters)();
+            if (!existing || isLanding) {
+                (0, attribution_1.setSessionUTMParameters)(utmParams);
+            }
+        }
+        // Get or create first-touch attribution
+        const sessionUTMs = (0, attribution_1.getSessionUTMParameters)() || {};
+        const firstTouch = (0, attribution_1.getOrCreateFirstTouchAttribution)(this.config.tenantId, referrer, currentUrl, sessionUTMs);
         // Base properties (always included)
         const properties = {
             page,
@@ -84,9 +111,47 @@ class PageTrackingManager {
         };
         // Enhanced properties when consent is granted
         if (hasConsent) {
-            properties.referrer = document.referrer || '';
             properties.title = document.title || '';
-            properties.full_url = window.location.href;
+            properties.full_url = currentUrl;
+            properties.session_id = this.tracker.getSessionId();
+            // Add referrer info
+            if (referrer) {
+                properties.referrer = referrer;
+                properties.referrer_domain = this.extractDomain(referrer);
+                properties.referrer_category = (0, attribution_1.categorizeReferrer)(referrer, currentUrl);
+            }
+            // Add landing page if this is not the first view
+            if (this.landingPage && !isLanding) {
+                properties.landing_page = this.landingPage;
+            }
+            // Add previous page if available
+            if (this.previousPage) {
+                properties.previous_page = this.previousPage;
+            }
+            // Add UTM parameters if present (from session)
+            if (sessionUTMs.utm_source)
+                properties.utm_source = sessionUTMs.utm_source;
+            if (sessionUTMs.utm_medium)
+                properties.utm_medium = sessionUTMs.utm_medium;
+            if (sessionUTMs.utm_campaign)
+                properties.utm_campaign = sessionUTMs.utm_campaign;
+            if (sessionUTMs.utm_term)
+                properties.utm_term = sessionUTMs.utm_term;
+            if (sessionUTMs.utm_content)
+                properties.utm_content = sessionUTMs.utm_content;
+            // Add first-touch attribution
+            properties.first_touch_source = firstTouch.source;
+            properties.first_touch_medium = firstTouch.medium;
+            properties.first_touch_campaign = firstTouch.campaign;
+            properties.first_touch_referrer_category = firstTouch.referrer_category;
+            // Browser and device info
+            properties.device = this.getDeviceType();
+            properties.browser = this.getBrowser();
+            properties.os = this.getOS();
+            properties.language = navigator.language || '';
+            properties.timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
+            properties.screen_resolution = `${screen.width}x${screen.height}`;
+            properties.viewport = `${window.innerWidth}x${window.innerHeight}`;
         }
         // Track the page view event
         this.tracker.trackSystemEvent('page_view', properties);
@@ -94,6 +159,75 @@ class PageTrackingManager {
             console.log('[Page Tracking] Tracked page view:', properties);
         }
     }
+    /**
+     * Extract domain from URL
+     */
+    extractDomain(url) {
+        try {
+            const urlObj = new URL(url);
+            return urlObj.hostname;
+        }
+        catch {
+            return '';
+        }
+    }
+    /**
+     * Detect browser name
+     */
+    getBrowser() {
+        const ua = navigator.userAgent;
+        if (ua.includes('Firefox/'))
+            return 'Firefox';
+        if (ua.includes('Edg/'))
+            return 'Edge';
+        if (ua.includes('Chrome/'))
+            return 'Chrome';
+        if (ua.includes('Safari/') && !ua.includes('Chrome/'))
+            return 'Safari';
+        if (ua.includes('Opera/') || ua.includes('OPR/'))
+            return 'Opera';
+        return 'Unknown';
+    }
+    /**
+     * Detect operating system
+     */
+    getOS() {
+        const ua = navigator.userAgent;
+        if (ua.includes('Win'))
+            return 'Windows';
+        if (ua.includes('Mac'))
+            return 'macOS';
+        if (ua.includes('Linux'))
+            return 'Linux';
+        if (ua.includes('Android'))
+            return 'Android';
+        if (ua.includes('iOS') || ua.includes('iPhone') || ua.includes('iPad'))
+            return 'iOS';
+        return 'Unknown';
+    }
+    /**
+     * Detect device type (Mobile, Tablet, Desktop)
+     */
+    getDeviceType() {
+        const ua = navigator.userAgent;
+        const width = window.innerWidth;
+        // Check for tablet-specific indicators
+        if (ua.includes('iPad') || (ua.includes('Android') && !ua.includes('Mobile'))) {
+            return 'Tablet';
+        }
+        // Check for mobile indicators
+        if (ua.includes('Mobile') || ua.includes('iPhone') || ua.includes('Android')) {
+            return 'Mobile';
+        }
+        // Fallback to screen width detection
+        if (width < 768) {
+            return 'Mobile';
+        }
+        else if (width >= 768 && width < 1024) {
+            return 'Tablet';
+        }
+        return 'Desktop';
+    }
     /**
      * Extract path from URL, optionally stripping query parameters
      */
@@ -134,22 +268,37 @@ class PageTrackingManager {
             ...properties,
         };
         // Enhanced properties when consent is granted
-        if (hasConsent && typeof document !== 'undefined') {
+        if (hasConsent && typeof document !== 'undefined' && typeof window !== 'undefined') {
             if (!baseProperties.referrer) {
                 baseProperties.referrer = document.referrer || '';
             }
             if (!baseProperties.title) {
                 baseProperties.title = document.title || '';
             }
-            if (!baseProperties.full_url && typeof window !== 'undefined') {
+            if (!baseProperties.full_url) {
                 baseProperties.full_url = window.location.href;
             }
+            if (!baseProperties.session_id) {
+                baseProperties.session_id = this.tracker.getSessionId();
+            }
+            if (!baseProperties.browser) {
+                baseProperties.browser = this.getBrowser();
+            }
+            if (!baseProperties.os) {
+                baseProperties.os = this.getOS();
+            }
         }
         this.tracker.trackSystemEvent('page_view', baseProperties);
         if (this.config.debug) {
             console.log('[Page Tracking] Manually tracked page:', baseProperties);
         }
     }
+    /**
+     * Get page view count for current session
+     */
+    getPageViewCount() {
+        return this.pageViewCount;
+    }
     /**
      * Destroy the page tracker
      */