@adobe/spacecat-shared-rum-api-client 2.38.10 → 2.39.1

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [@adobe/spacecat-shared-rum-api-client-v2.39.1](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-rum-api-client-v2.39.0...@adobe/spacecat-shared-rum-api-client-v2.39.1) (2025-11-28)
+
+
+### Bug Fixes
+
+* update to node 24 ([#1179](https://github.com/adobe/spacecat-shared/issues/1179)) ([0e60c0a](https://github.com/adobe/spacecat-shared/commit/0e60c0ab791b47662d07822f7c93009a8f7048fd))
+
+# [@adobe/spacecat-shared-rum-api-client-v2.39.0](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-rum-api-client-v2.38.10...@adobe/spacecat-shared-rum-api-client-v2.39.0) (2025-11-24)
+
+
+### Features
+
+* use paid event tracking source to classify ([#1166](https://github.com/adobe/spacecat-shared/issues/1166)) ([c477a04](https://github.com/adobe/spacecat-shared/commit/c477a048d3f74fdc315c5c4a6b2e2725cc0e5283))
+
 # [@adobe/spacecat-shared-rum-api-client-v2.38.10](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-rum-api-client-v2.38.9...@adobe/spacecat-shared-rum-api-client-v2.38.10) (2025-11-15)
 
 

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@adobe/spacecat-shared-rum-api-client",
-  "version": "2.38.10",
+  "version": "2.39.1",
   "description": "Shared modules of the Spacecat Services - Rum API client",
   "type": "module",
   "engines": {
-    "node": ">=22.0.0 <23.0.0",
+    "node": ">=22.0.0 <25.0.0",
     "npm": ">=10.9.0 <12.0.0"
   },
   "main": "src/index.js",
@@ -39,7 +39,7 @@
     "@adobe/helix-shared-wrap": "2.0.2",
     "@adobe/helix-universal": "5.3.0",
     "@adobe/rum-distiller": "1.20.8",
-    "@adobe/spacecat-shared-utils": "1.66.0",
+    "@adobe/spacecat-shared-utils": "1.81.0",
     "aws4": "1.13.2",
     "urijs": "1.19.11"
   },

package/src/common/traffic.js

@@ -68,7 +68,7 @@ const mediums = {
 };
 
 const sources = {
-  social: /^\b(ig|fb|x|soc)\b|(.*(meta|tiktok|facebook|snapchat|twitter|igshopping|instagram|linkedin|reddit).*)$/,
+  social: /^\b(ig|fb|x|soc|ln)\b|(.*(meta|tiktok|facebook|snapchat|twitter|igshopping|instagram|linkedin|reddit).*)$/,
   search: /^\b(goo)\b|(.*(sea|google|yahoo|bing|yandex|baidu|duckduckgo|brave|ecosia|aol|startpage|ask).*)$/,
   video: /youtube|vimeo|twitch|dailymotion|wistia/,
   display: /optumib2b|jun|googleads|dv360|dv36|microsoft|flipboard|programmatic|yext|gdn|banner|newsshowcase/,
@@ -84,12 +84,12 @@ const sources = {
  */
 const vendorClassifications = [
   { regex: /google|googleads|google-ads|google_search|google_deman|adwords|dv360|gdn|doubleclick|dbm|gmb|gemini/i, result: 'google' },
-  { regex: /instagram|\b(ig)\b/i, result: 'instagram' },
+  { regex: /instagram|\b(ig)\b|\b(Insta)\b/i, result: 'instagram' },
   { regex: /facebook|\b(fb)\b|meta/i, result: 'facebook' },
   { regex: /bing/i, result: 'bing' },
   { regex: /tiktok/i, result: 'tiktok' },
   { regex: /youtube|yt/i, result: 'youtube' },
-  { regex: /linkedin/i, result: 'linkedin' },
+  { regex: /linkedin|\b(ln)\b/i, result: 'linkedin' },
   { regex: /twitter|^\b(x)\b/i, result: 'x' },
   { regex: /snapchat/i, result: 'snapchat' },
   { regex: /microsoft|copilot/i, result: 'microsoft' },
@@ -214,6 +214,7 @@ const RULES = (domain) => ([
   { type: 'paid', category: 'search', referrer: anyOf(referrers.search), utmSource: any, utmMedium: any, tracking: anyOf(paidTrackingParams) },
   { type: 'paid', category: 'search', referrer: anyOf(referrers.ad), utmSource: any, utmMedium: anyOf(mediums.paidsearch), tracking: any },
   { type: 'paid', category: 'search', referrer: none, utmSource: anyOf(sources.search), utmMedium: anyOf(mediums.paidsearch), tracking: any },
+  { type: 'paid', category: 'search', referrer: none, utmSource: anyOf(sources.search), utmMedium: none, tracking: anyOf(paidTrackingParams) },
 
   { type: 'paid', category: 'social', referrer: anyOf(referrers.social), utmSource: any, utmMedium: anyOf(mediums.paidsocial), tracking: none },
   { type: 'paid', category: 'social', referrer: anyOf(referrers.social), utmSource: any, utmMedium: any, tracking: anyOf(paidTrackingParams) },
@@ -222,6 +223,7 @@ const RULES = (domain) => ([
   { type: 'paid', category: 'social', referrer: none, utmSource: anyOf(sources.social), utmMedium: anyOf(mediums.paidall), tracking: any },
   { type: 'paid', category: 'social', referrer: anyOf(referrers.social), utmSource: notEmpty, utmMedium: notEmpty, tracking: any },
   { type: 'paid', category: 'social', referrer: none, utmSource: anyOf(sources.social), utmMedium: anyOf(mediums.socialall), tracking: any },
+  { type: 'paid', category: 'social', referrer: none, utmSource: anyOf(sources.social), utmMedium: any, tracking: anyOf(paidTrackingParams) },
 
   { type: 'paid', category: 'video', referrer: anyOf(referrers.video), utmSource: any, utmMedium: anyOf(mediums.paidall), tracking: any },
   { type: 'paid', category: 'video', referrer: anyOf(referrers.video), utmSource: any, utmMedium: any, tracking: anyOf(paidTrackingParams) },
@@ -277,6 +279,8 @@ export function extractTrafficHints(bundle) {
   const utmSource = findEvent('utm', 'utm_source').target || '';
   const utmMedium = findEvent('utm', 'utm_medium').target || '';
   const tracking = findEvent('paid').checkpoint || findEvent('email').checkpoint || '';
+  const trackingSource = findEvent('paid').source || findEvent('email').source || '';
+  const trackingTarget = findEvent('paid').target || findEvent('email').target || '';
 
   return {
     url: bundle.url,
@@ -285,6 +289,8 @@ export function extractTrafficHints(bundle) {
     utmSource,
     utmMedium,
     tracking,
+    trackingSource,
+    trackingTarget,
   };
 }
 
@@ -303,7 +309,7 @@ export function classifyVendor(referrer, utmSource, utmMedium) {
   return result ? result.result : '';
 }
 
-export function classifyTrafficSource(url, referrer, utmSource, utmMedium, trackingParams) {
+export function classifyTrafficSource(url, referrer, utmSource, utmMedium, trackingEvent) {
   const secondLevelDomain = getSecondLevelDomain(url);
   const rules = RULES(secondLevelDomain);
 
@@ -315,7 +321,7 @@ export function classifyTrafficSource(url, referrer, utmSource, utmMedium, track
     rule.referrer(referrerDomain)
     && rule.utmSource(sanitize(utmSource))
     && rule.utmMedium(sanitize(utmMedium))
-    && rule.tracking(trackingParams)
+    && rule.tracking(trackingEvent)
   ));
   let { type, category } = match;
   let vendor = classifyVendor(referrerDomain, utmSource, utmMedium);
@@ -347,11 +353,24 @@ export function classifyTraffic(bundle) {
     utmSource,
     utmMedium,
     tracking,
+    trackingSource,
+    trackingTarget,
   } = extractTrafficHints(bundle);
 
+  let source = utmSource;
+
+  // When there are no explicit UTM parameters, fall back to tracking source
+  // as the classification source. This lets "paid + google (tracking_source)"
+  // behave like "paid + google (utm_source)" without mutating actual UTMs.
+  if (!source && !utmMedium && trackingSource) {
+    source = trackingSource;
+  }
+
   return {
     url,
     weight,
-    ...classifyTrafficSource(url, referrer, utmSource, utmMedium, tracking),
+    trackingSource,
+    trackingTarget,
+    ...classifyTrafficSource(url, referrer, source, utmMedium, tracking),
   };
 }

package/src/functions/traffic-analysis.js

@@ -106,6 +106,8 @@ async function handler(bundles) {
       trf_type: trafficData.type,
       trf_channel: trafficData.category,
       trf_platform: trafficData.vendor || null,
+      tracking_source: trafficData.trackingSource || null,
+      tracking_target: trafficData.trackingTarget || null,
       device: bundle.userAgent.split(':')[0],
       utm_source: getUTM(bundle, 'source'),
       utm_medium: getUTM(bundle, 'medium'),