@adobe/spacecat-shared-athena-client 1.7.6 → 1.8.1

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [@adobe/spacecat-shared-athena-client-v1.8.1](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-athena-client-v1.8.0...@adobe/spacecat-shared-athena-client-v1.8.1) (2025-12-03)
+
+
+### Bug Fixes
+
+* expose traffic_loss in result mapper for consent-banner ([#1208](https://github.com/adobe/spacecat-shared/issues/1208)) ([2b89f67](https://github.com/adobe/spacecat-shared/commit/2b89f6754ebc9766b8853ece11fa99dbb2c6a1c5))
+
+# [@adobe/spacecat-shared-athena-client-v1.8.0](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-athena-client-v1.7.6...@adobe/spacecat-shared-athena-client-v1.8.0) (2025-12-02)
+
+
+### Features
+
+* added query for PTRv2 ([#1205](https://github.com/adobe/spacecat-shared/issues/1205)) ([e291c2d](https://github.com/adobe/spacecat-shared/commit/e291c2d028bf20cc5851116d201a2d6c7c925d65))
+
 # [@adobe/spacecat-shared-athena-client-v1.7.6](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-athena-client-v1.7.5...@adobe/spacecat-shared-athena-client-v1.7.6) (2025-11-28)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/spacecat-shared-athena-client",
-  "version": "1.7.6",
+  "version": "1.8.1",
   "description": "Shared modules of the Spacecat Services - AWS Athena Client",
   "type": "module",
   "engines": {

package/src/index.js

@@ -261,6 +261,7 @@ export {
   getTrafficAnalysisQueryPlaceholders,
   buildPageTypeCase,
   getTrafficAnalysisQueryPlaceholdersFilled,
+  getTop3PagesWithTrafficLostTemplate,
 } from './traffic-analysis/queries.js';
 export { TrafficDataResponseDto } from './traffic-analysis/traffic-data-base-response.js';
 export { TrafficDataWithCWVDto } from './traffic-analysis/traffic-data-with-cwv.js';

package/src/traffic-analysis/queries.js

@@ -142,3 +142,103 @@ export function getTrafficAnalysisQueryPlaceholdersFilled({
     pageViewThreshold,
   };
 }
+
+/**
+ * Generates the top 3 pages with traffic lost SQL query with consent and referrer parameters.
+ * @param {Object} params - Template parameters
+ * @param {string} params.siteId - Site ID
+ * @param {string} params.tableName - Table name
+ * @param {string} params.temporalCondition - Temporal condition
+ * @param {string} params.dimensionColumns - Dimension columns
+ * @param {string} params.groupBy - Group by clause
+ * @param {string} params.dimensionColumnsPrefixed - Prefixed dimension columns
+ * @param {number} params.pageViewThreshold - Minimum total pageviews for path to include
+ * @param {number} params.limit - Limit the number of results
+ * @returns {string} The SQL query string
+ */
+export function getTop3PagesWithTrafficLostTemplate({
+  siteId,
+  tableName,
+  temporalCondition,
+  dimensionColumns,
+  groupBy,
+  dimensionColumnsPrefixed,
+  pageViewThreshold,
+  limit,
+}) {
+  return `
+WITH min_totals AS (
+    SELECT
+        path AS min_key,
+        CAST(SUM(pageviews) AS BIGINT) AS total_pageviews
+    FROM ${tableName}
+    WHERE siteid = '${siteId}' AND consent='show'
+    AND (${temporalCondition})
+    GROUP BY path
+    HAVING SUM(pageviews) >= ${pageViewThreshold}
+),
+raw AS (
+    SELECT
+        week,
+        month,
+        path,
+        trf_type,
+        trf_channel,
+        trf_platform,
+        device,
+        utm_source,
+        utm_medium,
+        utm_campaign,
+        referrer,
+        consent,
+        notfound,
+        pageviews,
+        clicked,
+        engaged,
+        latest_scroll,
+        CASE WHEN latest_scroll >= 10000 THEN 1 ELSE 0 END AS engaged_scroll,
+        lcp,
+        cls,
+        inp
+    FROM ${tableName} m
+    JOIN min_totals t ON m.path = t.min_key
+    WHERE m.siteid = '${siteId}' AND consent='show'
+    AND (${temporalCondition})
+),
+agg AS (
+    SELECT
+        ${dimensionColumns},
+        COUNT(*)                          AS row_count,
+        CAST(SUM(pageviews) AS BIGINT)   AS pageviews,
+        CAST(SUM(clicked) AS BIGINT)     AS clicks,
+        CAST(SUM(engaged) AS BIGINT)     AS engagements,
+        CAST(SUM(engaged_scroll) AS BIGINT) AS engaged_scroll,
+        approx_percentile(latest_scroll, 0.70) AS p70_scroll,
+        approx_percentile(lcp, 0.70)     AS p70_lcp,
+        approx_percentile(cls, 0.70)     AS p70_cls,
+        approx_percentile(inp, 0.70)     AS p70_inp
+    FROM raw
+    GROUP BY ${groupBy}
+),
+grand_total AS (
+    SELECT CAST(SUM(pageviews) AS BIGINT) AS total_pv FROM agg
+)
+SELECT
+    ${dimensionColumnsPrefixed},
+    CAST(a.pageviews AS DOUBLE) * (1 - CAST(a.engagements AS DOUBLE) / NULLIF(a.row_count, 0)) AS traffic_loss,
+    1 - CAST(a.engagements AS DOUBLE) / NULLIF(a.row_count, 0)  AS bounce_rate,
+    a.pageviews,
+    CAST(a.pageviews AS DOUBLE) / NULLIF(t.total_pv, 0)         AS pct_pageviews,
+    CAST(a.clicks AS DOUBLE)      / NULLIF(a.row_count, 0)      AS click_rate,
+    CAST(a.engagements AS DOUBLE) / NULLIF(a.row_count, 0)      AS engagement_rate,
+    CAST(a.engaged_scroll AS DOUBLE) / NULLIF(a.row_count, 0) AS engaged_scroll_rate,
+    a.p70_scroll,
+    a.p70_lcp,
+    a.p70_cls,
+    a.p70_inp
+FROM agg a
+CROSS JOIN grand_total t
+ORDER BY traffic_loss DESC
+${limit ? `LIMIT ${limit}` : ''}
+`.trim();
+}

package/src/traffic-analysis/traffic-data-with-cwv.js

@@ -58,6 +58,11 @@ export const TrafficDataWithCWVDto = {
    *   inp_score: string,
    *   cls_score: string,
    *   overall_cwv_score: string,
+   *   traffic_loss: number,
+   *   url: string,
+   *   path: string,
+   *   page_type: string,
+   *   device: string,
    * }} JSON object.
      */
   toJSON: (data, thresholdConfig, baseUrl) => {
@@ -85,6 +90,7 @@ export const TrafficDataWithCWVDto = {
       path: data.path,
       page_type: data.page_type,
       device: data.device,
+      traffic_loss: data.traffic_loss,
       p70_lcp: lcp,
       p70_cls: cls,
       p70_inp: inp,