@formo/analytics 1.28.6 → 1.29.0

package/dist/cjs/src/FormoAnalytics.d.ts

@@ -52,6 +52,8 @@ export declare class FormoAnalytics implements IFormoAnalytics {
     private isEvmDisabled;
     /** Instance-level flag so multiple SDK instances don't interfere. */
     private crossSubdomainCookies;
+    /** In-memory URL used to deduplicate SPA pageview events. */
+    private _currentUrl;
     config: Config;
     currentChainId?: ChainID;
     currentAddress?: Address;

package/dist/cjs/src/FormoAnalytics.js

@@ -122,6 +122,8 @@ var FormoAnalytics = /** @class */ (function () {
          * When true, all EIP-1193/EIP-6963 detection and wrapping is skipped.
          */
         this.isEvmDisabled = false;
+        /** In-memory URL used to deduplicate SPA pageview events. */
+        this._currentUrl = "";
         this.currentUserId = "";
         this.config = {
             writeKey: writeKey,
@@ -188,6 +190,7 @@ var FormoAnalytics = /** @class */ (function () {
         if (options.solana) {
             this.solanaManager = new SolanaManager_1.SolanaManager(this, options.solana);
         }
+        this._currentUrl = window.location.href;
         this.trackPageHit();
         this.trackPageHits();
     }
@@ -1440,11 +1443,9 @@ var FormoAnalytics = /** @class */ (function () {
     };
     FormoAnalytics.prototype.onLocationChange = function () {
         return __awaiter(this, void 0, void 0, function () {
-            var currentUrl;
             return __generator(this, function (_a) {
-                currentUrl = (0, storage_1.cookie)().get(constants_1.SESSION_CURRENT_URL_KEY);
-                if (currentUrl !== window.location.href) {
-                    (0, storage_1.cookie)().set(constants_1.SESSION_CURRENT_URL_KEY, window.location.href);
+                if (this._currentUrl !== window.location.href) {
+                    this._currentUrl = window.location.href;
                     this.trackPageHit();
                 }
                 return [2 /*return*/];

package/dist/cjs/src/constants/base.d.ts

@@ -1,5 +1,4 @@
 export declare const SESSION_TRAFFIC_SOURCE_KEY = "traffic-source";
-export declare const SESSION_CURRENT_URL_KEY = "analytics-current-url";
 export declare const SESSION_USER_ID_KEY = "user-id";
 export declare const LOCAL_ANONYMOUS_ID_KEY = "anonymous-id";
 export declare const CONSENT_OPT_OUT_KEY = "opt-out-tracking";

package/dist/cjs/src/constants/base.js

@@ -1,10 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BLOCKED_ADDRESSES = exports.DEAD_ADDRESS = exports.ZERO_ADDRESS = exports.DEFAULT_PROVIDER_ICON = exports.CONSENT_OPT_OUT_KEY = exports.LOCAL_ANONYMOUS_ID_KEY = exports.SESSION_USER_ID_KEY = exports.SESSION_CURRENT_URL_KEY = exports.SESSION_TRAFFIC_SOURCE_KEY = void 0;
+exports.BLOCKED_ADDRESSES = exports.DEAD_ADDRESS = exports.ZERO_ADDRESS = exports.DEFAULT_PROVIDER_ICON = exports.CONSENT_OPT_OUT_KEY = exports.LOCAL_ANONYMOUS_ID_KEY = exports.SESSION_USER_ID_KEY = exports.SESSION_TRAFFIC_SOURCE_KEY = void 0;
 exports.SESSION_TRAFFIC_SOURCE_KEY = "traffic-source";
 // SESSION_WALLET_DETECTED_KEY and SESSION_WALLET_IDENTIFIED_KEY
 // are now defined in src/session/index.ts
-exports.SESSION_CURRENT_URL_KEY = "analytics-current-url";
 exports.SESSION_USER_ID_KEY = "user-id";
 exports.LOCAL_ANONYMOUS_ID_KEY = "anonymous-id";
 // Consent management keys

package/dist/cjs/src/event/EventFactory.d.ts

@@ -17,6 +17,7 @@ declare class EventFactory implements IEventFactory {
     private getLanguage;
     private getLibraryVersion;
     private extractUTMParameters;
+    private extractClickIdParameters;
     private extractReferralParameter;
     private getTrafficSources;
     private getScreen;

package/dist/cjs/src/event/EventFactory.js

@@ -87,6 +87,15 @@ var EventFactory = /** @class */ (function () {
             catch (_a) { }
             return result;
         };
+        this.extractClickIdParameters = function (urlObj) {
+            var result = {};
+            for (var _i = 0, CLICK_ID_PARAMS_1 = constants_2.CLICK_ID_PARAMS; _i < CLICK_ID_PARAMS_1.length; _i++) {
+                var param = CLICK_ID_PARAMS_1[_i];
+                var value = urlObj.searchParams.get(param);
+                result[param] = value ? value.trim() : "";
+            }
+            return result;
+        };
         this.extractReferralParameter = function (urlObj) {
             var _a, _b, _c;
             // Strategy: Check query params first, then check path pattern if configured
@@ -119,25 +128,23 @@ var EventFactory = /** @class */ (function () {
         };
         this.getTrafficSources = function (url) {
             var urlObj = new URL(url);
-            var contextTrafficSources = __assign(__assign({}, _this.extractUTMParameters(url)), { ref: _this.extractReferralParameter(urlObj), referrer: document.referrer });
+            var contextTrafficSources = __assign(__assign(__assign({}, _this.extractUTMParameters(url)), _this.extractClickIdParameters(urlObj)), { ref: _this.extractReferralParameter(urlObj), referrer: document.referrer });
             var storedTrafficSources = (0, storage_1.session)().get(constants_1.SESSION_TRAFFIC_SOURCE_KEY) || {};
-            var finalTrafficSources = {
-                ref: contextTrafficSources.ref || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.ref) || "",
-                referrer: contextTrafficSources.referrer || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.referrer) || "",
-                utm_campaign: contextTrafficSources.utm_campaign ||
+            var mergedClickIds = {};
+            for (var _i = 0, CLICK_ID_PARAMS_2 = constants_2.CLICK_ID_PARAMS; _i < CLICK_ID_PARAMS_2.length; _i++) {
+                var p = CLICK_ID_PARAMS_2[_i];
+                mergedClickIds[p] =
+                    contextTrafficSources[p] || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources[p]) || "";
+            }
+            var finalTrafficSources = __assign({ ref: contextTrafficSources.ref || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.ref) || "", referrer: contextTrafficSources.referrer || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.referrer) || "", utm_campaign: contextTrafficSources.utm_campaign ||
                     (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.utm_campaign) ||
-                    "",
-                utm_content: contextTrafficSources.utm_content ||
+                    "", utm_content: contextTrafficSources.utm_content ||
                     (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.utm_content) ||
-                    "",
-                utm_medium: contextTrafficSources.utm_medium ||
+                    "", utm_medium: contextTrafficSources.utm_medium ||
                     (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.utm_medium) ||
-                    "",
-                utm_source: contextTrafficSources.utm_source ||
+                    "", utm_source: contextTrafficSources.utm_source ||
                     (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.utm_source) ||
-                    "",
-                utm_term: contextTrafficSources.utm_term || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.utm_term) || "",
-            };
+                    "", utm_term: contextTrafficSources.utm_term || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.utm_term) || "" }, mergedClickIds);
             // Store to session
             var sessionStoredTrafficSources = Object.keys(finalTrafficSources).reduce(function (res, key) {
                 var value = finalTrafficSources[key];

package/dist/cjs/src/event/constants.d.ts

@@ -1,11 +1,17 @@
 declare const CHANNEL = "web";
 declare const VERSION = "0";
+/**
+ * Paid-attribution click IDs captured from the landing-page URL and persisted
+ * across the session alongside UTM parameters. Keep the ClickIdParameters type
+ * in src/types/events.ts derived from this array.
+ */
+declare const CLICK_ID_PARAMS: readonly ["gclid", "gad_source", "fbclid", "msclkid", "twclid", "li_fat_id", "rdt_cid", "ttclid"];
 /**
  * Fields that should be excluded from page event properties parsing
  * These are either:
- * - Already captured in event context (UTM params, referral params)
+ * - Already captured in event context (UTM params, referral params, click IDs)
  * - Semantic event properties that should not be overridden by URL params
  */
 declare const PAGE_PROPERTIES_EXCLUDED_FIELDS: Set<string>;
-export { CHANNEL, VERSION, PAGE_PROPERTIES_EXCLUDED_FIELDS };
+export { CHANNEL, VERSION, CLICK_ID_PARAMS, PAGE_PROPERTIES_EXCLUDED_FIELDS };
 //# sourceMappingURL=constants.d.ts.map

package/dist/cjs/src/event/constants.js

@@ -1,17 +1,42 @@
 "use strict";
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PAGE_PROPERTIES_EXCLUDED_FIELDS = exports.VERSION = exports.CHANNEL = void 0;
+exports.PAGE_PROPERTIES_EXCLUDED_FIELDS = exports.CLICK_ID_PARAMS = exports.VERSION = exports.CHANNEL = void 0;
 var CHANNEL = "web";
 exports.CHANNEL = CHANNEL;
 var VERSION = "0";
 exports.VERSION = VERSION;
+/**
+ * Paid-attribution click IDs captured from the landing-page URL and persisted
+ * across the session alongside UTM parameters. Keep the ClickIdParameters type
+ * in src/types/events.ts derived from this array.
+ */
+var CLICK_ID_PARAMS = [
+    "gclid", // Google Ads
+    "gad_source", // Google Ads (newer)
+    "fbclid", // Meta (Facebook/Instagram)
+    "msclkid", // Microsoft Ads (Bing)
+    "twclid", // Twitter/X Ads
+    "li_fat_id", // LinkedIn Ads
+    "rdt_cid", // Reddit Ads
+    "ttclid", // TikTok Ads
+];
+exports.CLICK_ID_PARAMS = CLICK_ID_PARAMS;
 /**
  * Fields that should be excluded from page event properties parsing
  * These are either:
- * - Already captured in event context (UTM params, referral params)
+ * - Already captured in event context (UTM params, referral params, click IDs)
  * - Semantic event properties that should not be overridden by URL params
  */
-var PAGE_PROPERTIES_EXCLUDED_FIELDS = new Set([
+var PAGE_PROPERTIES_EXCLUDED_FIELDS = new Set(__spreadArray(__spreadArray([
     // Context fields (already captured in event context)
     'utm_source',
     'utm_medium',
@@ -21,7 +46,8 @@ var PAGE_PROPERTIES_EXCLUDED_FIELDS = new Set([
     'ref',
     'referral',
     'refcode',
-    'referrer',
+    'referrer'
+], CLICK_ID_PARAMS, true), [
     // Semantic event properties (should not be overridden by URL params)
     'category',
     'name',
@@ -29,6 +55,6 @@ var PAGE_PROPERTIES_EXCLUDED_FIELDS = new Set([
     'path',
     'hash',
     'query',
-]);
+], false));
 exports.PAGE_PROPERTIES_EXCLUDED_FIELDS = PAGE_PROPERTIES_EXCLUDED_FIELDS;
 //# sourceMappingURL=constants.js.map

package/dist/cjs/src/types/events.d.ts

@@ -1,6 +1,7 @@
 import { UUID } from "crypto";
 import { Address, ChainID, Nullable } from "./base";
 import { TEventChannel, TEventType } from "../constants";
+import { CLICK_ID_PARAMS } from "../event/constants";
 export type AnonymousID = UUID;
 export interface ICommonProperties {
     anonymous_id: AnonymousID;
@@ -21,7 +22,10 @@ export type UTMParameters = {
     utm_term: string;
     utm_content: string;
 };
-export type ITrafficSource = UTMParameters & {
+export type ClickIdParameters = {
+    [K in (typeof CLICK_ID_PARAMS)[number]]: string;
+};
+export type ITrafficSource = UTMParameters & ClickIdParameters & {
     ref: string;
     referrer: string;
 };

package/dist/cjs/src/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "1.28.6";
+export declare const version = "1.29.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/cjs/src/version.js

@@ -3,5 +3,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.version = void 0;
 // This file is auto-generated by scripts/update-version.js during npm version
 // Do not edit manually - it will be overwritten
-exports.version = '1.28.6';
+exports.version = '1.29.0';
 //# sourceMappingURL=version.js.map

package/dist/esm/src/FormoAnalytics.d.ts

@@ -52,6 +52,8 @@ export declare class FormoAnalytics implements IFormoAnalytics {
     private isEvmDisabled;
     /** Instance-level flag so multiple SDK instances don't interfere. */
     private crossSubdomainCookies;
+    /** In-memory URL used to deduplicate SPA pageview events. */
+    private _currentUrl;
     config: Config;
     currentChainId?: ChainID;
     currentAddress?: Address;

package/dist/esm/src/FormoAnalytics.js

@@ -55,7 +55,7 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
     return to.concat(ar || Array.prototype.slice.call(from));
 };
 import { createStore } from "mipd";
-import { EVENTS_API_HOST, EventType, LOCAL_ANONYMOUS_ID_KEY, SESSION_CURRENT_URL_KEY, SESSION_USER_ID_KEY, CONSENT_OPT_OUT_KEY, } from "./constants";
+import { EVENTS_API_HOST, EventType, LOCAL_ANONYMOUS_ID_KEY, SESSION_USER_ID_KEY, CONSENT_OPT_OUT_KEY, } from "./constants";
 import { cookie, initStorageManager } from "./storage";
 import { getIdentityCookieDomain } from "./storage/cookiePolicy";
 import { EventManager } from "./event";
@@ -119,6 +119,8 @@ var FormoAnalytics = /** @class */ (function () {
          * When true, all EIP-1193/EIP-6963 detection and wrapping is skipped.
          */
         this.isEvmDisabled = false;
+        /** In-memory URL used to deduplicate SPA pageview events. */
+        this._currentUrl = "";
         this.currentUserId = "";
         this.config = {
             writeKey: writeKey,
@@ -185,6 +187,7 @@ var FormoAnalytics = /** @class */ (function () {
         if (options.solana) {
             this.solanaManager = new SolanaManager(this, options.solana);
         }
+        this._currentUrl = window.location.href;
         this.trackPageHit();
         this.trackPageHits();
     }
@@ -1437,11 +1440,9 @@ var FormoAnalytics = /** @class */ (function () {
     };
     FormoAnalytics.prototype.onLocationChange = function () {
         return __awaiter(this, void 0, void 0, function () {
-            var currentUrl;
             return __generator(this, function (_a) {
-                currentUrl = cookie().get(SESSION_CURRENT_URL_KEY);
-                if (currentUrl !== window.location.href) {
-                    cookie().set(SESSION_CURRENT_URL_KEY, window.location.href);
+                if (this._currentUrl !== window.location.href) {
+                    this._currentUrl = window.location.href;
                     this.trackPageHit();
                 }
                 return [2 /*return*/];

package/dist/esm/src/constants/base.d.ts

@@ -1,5 +1,4 @@
 export declare const SESSION_TRAFFIC_SOURCE_KEY = "traffic-source";
-export declare const SESSION_CURRENT_URL_KEY = "analytics-current-url";
 export declare const SESSION_USER_ID_KEY = "user-id";
 export declare const LOCAL_ANONYMOUS_ID_KEY = "anonymous-id";
 export declare const CONSENT_OPT_OUT_KEY = "opt-out-tracking";

package/dist/esm/src/constants/base.js

@@ -1,7 +1,6 @@
 export var SESSION_TRAFFIC_SOURCE_KEY = "traffic-source";
 // SESSION_WALLET_DETECTED_KEY and SESSION_WALLET_IDENTIFIED_KEY
 // are now defined in src/session/index.ts
-export var SESSION_CURRENT_URL_KEY = "analytics-current-url";
 export var SESSION_USER_ID_KEY = "user-id";
 export var LOCAL_ANONYMOUS_ID_KEY = "anonymous-id";
 // Consent management keys

package/dist/esm/src/event/EventFactory.d.ts

@@ -17,6 +17,7 @@ declare class EventFactory implements IEventFactory {
     private getLanguage;
     private getLibraryVersion;
     private extractUTMParameters;
+    private extractClickIdParameters;
     private extractReferralParameter;
     private getTrafficSources;
     private getScreen;

package/dist/esm/src/event/EventFactory.js

@@ -54,7 +54,7 @@ import { logger } from "../logger";
 import mergeDeepRight from "../ramda/mergeDeepRight";
 import { session } from "../storage";
 import { version } from "../version";
-import { CHANNEL, VERSION, PAGE_PROPERTIES_EXCLUDED_FIELDS } from "./constants";
+import { CHANNEL, CLICK_ID_PARAMS, PAGE_PROPERTIES_EXCLUDED_FIELDS, VERSION, } from "./constants";
 import { generateAnonymousId } from "./utils";
 import { detectBrowser } from "../browser/browsers";
 var EventFactory = /** @class */ (function () {
@@ -81,6 +81,15 @@ var EventFactory = /** @class */ (function () {
             catch (_a) { }
             return result;
         };
+        this.extractClickIdParameters = function (urlObj) {
+            var result = {};
+            for (var _i = 0, CLICK_ID_PARAMS_1 = CLICK_ID_PARAMS; _i < CLICK_ID_PARAMS_1.length; _i++) {
+                var param = CLICK_ID_PARAMS_1[_i];
+                var value = urlObj.searchParams.get(param);
+                result[param] = value ? value.trim() : "";
+            }
+            return result;
+        };
         this.extractReferralParameter = function (urlObj) {
             var _a, _b, _c;
             // Strategy: Check query params first, then check path pattern if configured
@@ -113,25 +122,23 @@ var EventFactory = /** @class */ (function () {
         };
         this.getTrafficSources = function (url) {
             var urlObj = new URL(url);
-            var contextTrafficSources = __assign(__assign({}, _this.extractUTMParameters(url)), { ref: _this.extractReferralParameter(urlObj), referrer: document.referrer });
+            var contextTrafficSources = __assign(__assign(__assign({}, _this.extractUTMParameters(url)), _this.extractClickIdParameters(urlObj)), { ref: _this.extractReferralParameter(urlObj), referrer: document.referrer });
             var storedTrafficSources = session().get(SESSION_TRAFFIC_SOURCE_KEY) || {};
-            var finalTrafficSources = {
-                ref: contextTrafficSources.ref || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.ref) || "",
-                referrer: contextTrafficSources.referrer || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.referrer) || "",
-                utm_campaign: contextTrafficSources.utm_campaign ||
+            var mergedClickIds = {};
+            for (var _i = 0, CLICK_ID_PARAMS_2 = CLICK_ID_PARAMS; _i < CLICK_ID_PARAMS_2.length; _i++) {
+                var p = CLICK_ID_PARAMS_2[_i];
+                mergedClickIds[p] =
+                    contextTrafficSources[p] || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources[p]) || "";
+            }
+            var finalTrafficSources = __assign({ ref: contextTrafficSources.ref || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.ref) || "", referrer: contextTrafficSources.referrer || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.referrer) || "", utm_campaign: contextTrafficSources.utm_campaign ||
                     (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.utm_campaign) ||
-                    "",
-                utm_content: contextTrafficSources.utm_content ||
+                    "", utm_content: contextTrafficSources.utm_content ||
                     (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.utm_content) ||
-                    "",
-                utm_medium: contextTrafficSources.utm_medium ||
+                    "", utm_medium: contextTrafficSources.utm_medium ||
                     (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.utm_medium) ||
-                    "",
-                utm_source: contextTrafficSources.utm_source ||
+                    "", utm_source: contextTrafficSources.utm_source ||
                     (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.utm_source) ||
-                    "",
-                utm_term: contextTrafficSources.utm_term || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.utm_term) || "",
-            };
+                    "", utm_term: contextTrafficSources.utm_term || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.utm_term) || "" }, mergedClickIds);
             // Store to session
             var sessionStoredTrafficSources = Object.keys(finalTrafficSources).reduce(function (res, key) {
                 var value = finalTrafficSources[key];

package/dist/esm/src/event/constants.d.ts

@@ -1,11 +1,17 @@
 declare const CHANNEL = "web";
 declare const VERSION = "0";
+/**
+ * Paid-attribution click IDs captured from the landing-page URL and persisted
+ * across the session alongside UTM parameters. Keep the ClickIdParameters type
+ * in src/types/events.ts derived from this array.
+ */
+declare const CLICK_ID_PARAMS: readonly ["gclid", "gad_source", "fbclid", "msclkid", "twclid", "li_fat_id", "rdt_cid", "ttclid"];
 /**
  * Fields that should be excluded from page event properties parsing
  * These are either:
- * - Already captured in event context (UTM params, referral params)
+ * - Already captured in event context (UTM params, referral params, click IDs)
  * - Semantic event properties that should not be overridden by URL params
  */
 declare const PAGE_PROPERTIES_EXCLUDED_FIELDS: Set<string>;
-export { CHANNEL, VERSION, PAGE_PROPERTIES_EXCLUDED_FIELDS };
+export { CHANNEL, VERSION, CLICK_ID_PARAMS, PAGE_PROPERTIES_EXCLUDED_FIELDS };
 //# sourceMappingURL=constants.d.ts.map

package/dist/esm/src/event/constants.js

@@ -1,12 +1,36 @@
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
 var CHANNEL = "web";
 var VERSION = "0";
+/**
+ * Paid-attribution click IDs captured from the landing-page URL and persisted
+ * across the session alongside UTM parameters. Keep the ClickIdParameters type
+ * in src/types/events.ts derived from this array.
+ */
+var CLICK_ID_PARAMS = [
+    "gclid", // Google Ads
+    "gad_source", // Google Ads (newer)
+    "fbclid", // Meta (Facebook/Instagram)
+    "msclkid", // Microsoft Ads (Bing)
+    "twclid", // Twitter/X Ads
+    "li_fat_id", // LinkedIn Ads
+    "rdt_cid", // Reddit Ads
+    "ttclid", // TikTok Ads
+];
 /**
  * Fields that should be excluded from page event properties parsing
  * These are either:
- * - Already captured in event context (UTM params, referral params)
+ * - Already captured in event context (UTM params, referral params, click IDs)
  * - Semantic event properties that should not be overridden by URL params
  */
-var PAGE_PROPERTIES_EXCLUDED_FIELDS = new Set([
+var PAGE_PROPERTIES_EXCLUDED_FIELDS = new Set(__spreadArray(__spreadArray([
     // Context fields (already captured in event context)
     'utm_source',
     'utm_medium',
@@ -16,7 +40,8 @@ var PAGE_PROPERTIES_EXCLUDED_FIELDS = new Set([
     'ref',
     'referral',
     'refcode',
-    'referrer',
+    'referrer'
+], CLICK_ID_PARAMS, true), [
     // Semantic event properties (should not be overridden by URL params)
     'category',
     'name',
@@ -24,6 +49,6 @@ var PAGE_PROPERTIES_EXCLUDED_FIELDS = new Set([
     'path',
     'hash',
     'query',
-]);
-export { CHANNEL, VERSION, PAGE_PROPERTIES_EXCLUDED_FIELDS };
+], false));
+export { CHANNEL, VERSION, CLICK_ID_PARAMS, PAGE_PROPERTIES_EXCLUDED_FIELDS };
 //# sourceMappingURL=constants.js.map

package/dist/esm/src/types/events.d.ts

@@ -1,6 +1,7 @@
 import { UUID } from "crypto";
 import { Address, ChainID, Nullable } from "./base";
 import { TEventChannel, TEventType } from "../constants";
+import { CLICK_ID_PARAMS } from "../event/constants";
 export type AnonymousID = UUID;
 export interface ICommonProperties {
     anonymous_id: AnonymousID;
@@ -21,7 +22,10 @@ export type UTMParameters = {
     utm_term: string;
     utm_content: string;
 };
-export type ITrafficSource = UTMParameters & {
+export type ClickIdParameters = {
+    [K in (typeof CLICK_ID_PARAMS)[number]]: string;
+};
+export type ITrafficSource = UTMParameters & ClickIdParameters & {
     ref: string;
     referrer: string;
 };

package/dist/esm/src/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "1.28.6";
+export declare const version = "1.29.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/esm/src/version.js

@@ -1,4 +1,4 @@
 // This file is auto-generated by scripts/update-version.js during npm version
 // Do not edit manually - it will be overwritten
-export var version = '1.28.6';
+export var version = '1.29.0';
 //# sourceMappingURL=version.js.map