@adobe/spacecat-shared-rum-api-client 2.36.3 → 2.36.5

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [@adobe/spacecat-shared-rum-api-client-v2.36.5](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-rum-api-client-v2.36.4...@adobe/spacecat-shared-rum-api-client-v2.36.5) (2025-08-25)
+
+
+### Bug Fixes
+
+* make max opportunities configurable ([#930](https://github.com/adobe/spacecat-shared/issues/930)) ([2b18c25](https://github.com/adobe/spacecat-shared/commit/2b18c25e8dc3303af0e1a09ebcbe830672368d13))
+
+# [@adobe/spacecat-shared-rum-api-client-v2.36.4](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-rum-api-client-v2.36.3...@adobe/spacecat-shared-rum-api-client-v2.36.4) (2025-08-15)
+
+
+### Bug Fixes
+
+* **rum-api-client:** harden LLM-related classifications ([#916](https://github.com/adobe/spacecat-shared/issues/916)) ([63573d7](https://github.com/adobe/spacecat-shared/commit/63573d71af9e2452f3cf4377efcddd6e7e4267c0))
+
 # [@adobe/spacecat-shared-rum-api-client-v2.36.3](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-rum-api-client-v2.36.2...@adobe/spacecat-shared-rum-api-client-v2.36.3) (2025-08-09)
 
 

package/README.md

@@ -335,7 +335,13 @@ Calculates the amount of inorganic traffic and the bounce rate for each page. Id
 
 ### high-organic-low-ctr (Experimentation Opportunity)
 
-Calculates the amount of non-inorganic (earned and owned) traffic and the click-through rate for each page and vendor. Identifies pages with high non-inorganic traffic and low click-through rates, which can be targeted for future experimentation opportunities. An example payload is provided below:
+Calculates the amount of non-inorganic (earned and owned) traffic and the click-through rate for each page and vendor. Identifies pages with high non-inorganic traffic and low click-through rates, which can be targeted for future experimentation opportunities. 
+
+#### options supported
+- **maxOpportunities** - No. of maximum opportunities to return, defaults to 10
+
+
+An example payload is provided below:
 
 ```json
 [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/spacecat-shared-rum-api-client",
-  "version": "2.36.3",
+  "version": "2.36.5",
   "description": "Shared modules of the Spacecat Services - Rum API client",
   "type": "module",
   "engines": {

package/src/common/traffic.js

@@ -41,7 +41,7 @@ const referrers = {
   social: /^\b((www\.)?x)\b|(.*(facebook|tiktok|snapchat|twitter|pinterest|reddit|linkedin|threads|quora|discord|tumblr|mastodon|bluesky|instagram).*)$/,
   ad: /googlesyndication|2mdn|doubleclick|syndicatedsearch/,
   video: /youtube|vimeo|twitch|dailymotion|wistia/,
-  llm: /chatgpt|openai|perplexity|claude|gemini\.google|copilot\.microsoft/,
+  llm: /\b(chatgpt|openai)\b|perplexity|claude|gemini\.google|copilot\.microsoft/,
 };
 
 const mediums = {
@@ -103,7 +103,7 @@ const vendorClassifications = [
   { regex: /amazon|ctv/i, result: 'amazon' },
   { regex: /dailymotion/i, result: 'dailymotion' },
   { regex: /twitch/i, result: 'twitch' },
-  { regex: /chatgpt|openai/i, result: 'openai' },
+  { regex: /\b(chatgpt|openai)\b/i, result: 'openai' },
   { regex: /perplexity/i, result: 'perplexity' },
   { regex: /claude/i, result: 'claude' },
   { regex: /direct/i, result: 'direct' },

package/src/functions/opportunities/high-organic-low-ctr.js

@@ -14,7 +14,7 @@ import trafficAcquisition from '../traffic-acquisition.js';
 import { getCTRByUrlAndVendor, getSiteAvgCTR } from '../../common/aggregateFns.js';
 
 const VENDORS_TO_CONSIDER = 5;
-const MAX_OPPORTUNITIES = 10;
+const DEFAULT_MAX_OPPORTUNITIES = 10;
 
 const MAIN_TYPES = ['paid', 'earned', 'owned'];
 
@@ -133,13 +133,13 @@ function sortPagesByEarnedAndOverallTraffic(pages) {
   return percentiles.sort((a, b) => b.percentileScore - a.percentileScore);
 }
 
-function handler(bundles) {
+function handler(bundles, opts) {
   const trafficByUrl = trafficAcquisition.handler(bundles);
   const ctrByUrlAndVendor = getCTRByUrlAndVendor(bundles);
   const siteAvgCTR = getSiteAvgCTR(bundles);
   const pagesSortedByEarnedAndOverallTraffic = sortPagesByEarnedAndOverallTraffic(
     trafficByUrl,
-  ).slice(0, MAX_OPPORTUNITIES);
+  ).slice(0, opts?.maxOpportunities || DEFAULT_MAX_OPPORTUNITIES);
 
   return pagesSortedByEarnedAndOverallTraffic.map((traffic) => ({
     ...traffic,