@adtrackify/at-tracking-event-types 4.41.0 → 4.41.1

package/dist/esm/types/api/measures/definitions/tracked-measure-definitions.js

@@ -1,18 +1,21 @@
 import { MEASURE } from '../measures.js';
-import { MEASURE_CATEGORY } from './measure-categories.js';
+import { MEASURE_CATEGORY, MEASURE_SUBCATEGORY } from './measure-categories.js';
 import { MeasureValueType } from './measure-value-type.js';
 import { CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS } from './measure-applicable-contexts.js';
 export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_PAGE_VIEWS]: {
         title: 'Page Views',
         description: 'The total number of times a page was viewed.',
+        tooltip: 'Total number of page load events tracked by the Upstack pixel across your site in the selected period.',
+        relatedMeasures: [MEASURE.TRACKED_UNIQUE_SESSIONS, MEASURE.TRACKED_AVG_PAGE_VIEWS_PER_SESSION],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
         icon: 'upstack',
         measure: MEASURE.TRACKED_PAGE_VIEWS,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_AWARENESS,
         valueType: MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -21,13 +24,16 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_VIEW_CONTENTS]: {
         title: 'View Contents',
         description: 'The total number of times a product page was viewed.',
+        tooltip: 'Total product detail page views tracked by the Upstack pixel. Each visit to a product page fires one View Content event.',
+        relatedMeasures: [MEASURE.TRACKED_ADD_TO_CARTS, MEASURE.TRACKED_VIEW_CONTENT_RATE, MEASURE.TRACKED_VC_TO_ATC_RATE],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
         icon: 'upstack',
         measure: MEASURE.TRACKED_VIEW_CONTENTS,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -36,13 +42,16 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_ADD_TO_CARTS]: {
         title: 'Add to Carts',
         description: 'The total number of times a product was added to the cart.',
+        tooltip: 'Total add-to-cart events tracked by the Upstack pixel, indicating shopping intent from visitors.',
+        relatedMeasures: [MEASURE.TRACKED_VIEW_CONTENTS, MEASURE.TRACKED_INITIATE_CHECKOUTS, MEASURE.TRACKED_ADD_TO_CART_RATE],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
         icon: 'upstack',
         measure: MEASURE.TRACKED_ADD_TO_CARTS,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -51,13 +60,17 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_INITIATE_CHECKOUTS]: {
         title: 'Initiate Checkouts',
         description: 'The number of times a checkout was initiated.',
+        shortTitle: 'Checkouts',
+        tooltip: 'Total checkout initiation events tracked by the Upstack pixel, representing visitors who reached the checkout step.',
+        relatedMeasures: [MEASURE.TRACKED_ADD_TO_CARTS, MEASURE.TRACKED_PURCHASES, MEASURE.TRACKED_ATC_TO_IC_RATE],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
         icon: 'upstack',
         measure: MEASURE.TRACKED_INITIATE_CHECKOUTS,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -66,13 +79,16 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_PURCHASES]: {
         title: 'Purchases',
         description: 'The total number of tracked purchases.',
+        tooltip: 'Total purchase events tracked by the Upstack pixel. This is your actual Shopify order count as seen by the tracking pixel.',
+        relatedMeasures: [MEASURE.TRACKED_REVENUE, MEASURE.TRACKED_INITIATE_CHECKOUTS, MEASURE.TRACKED_IC_TO_PURCHASE_RATE],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
         icon: 'upstack',
         measure: MEASURE.TRACKED_PURCHASES,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_CONVERSIONS,
         valueType: MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -81,13 +97,16 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_REVENUE]: {
         title: 'Revenue',
         description: 'The total tracked revenue.',
+        tooltip: 'Total purchase value tracked by the Upstack pixel from completed orders on your Shopify store.',
+        relatedMeasures: [MEASURE.TRACKED_PURCHASES, MEASURE.TRACKED_REVENUE_PER_VISITOR, MEASURE.TRACKED_REVENUE_PER_SESSION],
         sumPrefix: '$',
         sumSuffix: '',
         avgPrefix: '$',
         avgSuffix: '',
         icon: 'upstack',
         measure: MEASURE.TRACKED_REVENUE,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_CONVERSIONS,
         valueType: MeasureValueType.CURRENCY,
         decimalPlaces: 2,
         useCompactNotation: true,
@@ -96,13 +115,19 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_SESSION_CONVERSION_RATE]: {
         title: 'Session Conversion Rate',
         description: 'The percentage of sessions that resulted in a conversion.',
+        shortTitle: 'Conv. Rate',
+        tooltip: 'Percentage of tracked sessions that resulted in a purchase. This is your overall store conversion rate.',
+        formulaDisplay: 'Purchases ÷ Sessions × 100',
+        formula: 'purchases / sessions * 100',
+        relatedMeasures: [MEASURE.TRACKED_PURCHASES, MEASURE.TRACKED_UNIQUE_SESSIONS, MEASURE.TRACKED_REVENUE],
         sumPrefix: '',
         sumSuffix: '%',
         avgPrefix: '',
         avgSuffix: '%',
         icon: 'upstack',
         measure: MEASURE.TRACKED_SESSION_CONVERSION_RATE,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_CONVERSIONS,
         valueType: MeasureValueType.PERCENTAGE,
         decimalPlaces: 2,
         useCompactNotation: false,
@@ -111,13 +136,19 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_REVENUE_PER_VISITOR]: {
         title: 'Revenue per Visitor',
         description: 'The average revenue generated per visitor.',
+        shortTitle: 'Rev/Visitor',
+        tooltip: 'Average revenue generated for every unique visitor to your site. Useful for comparing traffic quality across channels.',
+        formulaDisplay: 'Revenue ÷ Unique Visitors',
+        formula: 'revenue / unique_visitors',
+        relatedMeasures: [MEASURE.TRACKED_REVENUE, MEASURE.TRACKED_UNIQUE_VISITORS, MEASURE.TRACKED_REVENUE_PER_SESSION],
         sumPrefix: '$',
         sumSuffix: '',
         avgPrefix: '$',
         avgSuffix: '',
         icon: 'upstack',
         measure: MEASURE.TRACKED_REVENUE_PER_VISITOR,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_CONVERSIONS,
         valueType: MeasureValueType.CURRENCY,
         decimalPlaces: 2,
         useCompactNotation: true,
@@ -126,13 +157,19 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_REVENUE_PER_SESSION]: {
         title: 'Revenue per Session',
         description: 'The average revenue generated per session.',
+        shortTitle: 'Rev/Session',
+        tooltip: 'Average revenue generated per session. A higher value indicates sessions are more efficiently converting into revenue.',
+        formulaDisplay: 'Revenue ÷ Sessions',
+        formula: 'revenue / sessions',
+        relatedMeasures: [MEASURE.TRACKED_REVENUE, MEASURE.TRACKED_UNIQUE_SESSIONS, MEASURE.TRACKED_REVENUE_PER_VISITOR],
         sumPrefix: '$',
         sumSuffix: '',
         avgPrefix: '$',
         avgSuffix: '',
         icon: 'upstack',
         measure: MEASURE.TRACKED_REVENUE_PER_SESSION,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_CONVERSIONS,
         valueType: MeasureValueType.CURRENCY,
         decimalPlaces: 2,
         useCompactNotation: true,
@@ -141,13 +178,16 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_UNIQUE_SESSIONS]: {
         title: 'Unique Sessions',
         description: 'The number of unique sessions.',
+        tooltip: 'Count of distinct sessions tracked by the Upstack pixel. Each continuous visit from a user counts as one session.',
+        relatedMeasures: [MEASURE.TRACKED_UNIQUE_VISITORS, MEASURE.TRACKED_PAGE_VIEWS, MEASURE.TRACKED_SESSION_CONVERSION_RATE],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
         icon: 'upstack',
         measure: MEASURE.TRACKED_UNIQUE_SESSIONS,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_AWARENESS,
         valueType: MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -156,13 +196,16 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_UNIQUE_VISITORS]: {
         title: 'Unique Visitors',
         description: 'The number of unique visitors.',
+        tooltip: 'Count of distinct individual visitors identified by the Upstack pixel using identity resolution. One visitor can have multiple sessions.',
+        relatedMeasures: [MEASURE.TRACKED_UNIQUE_SESSIONS, MEASURE.TRACKED_NEW_VISITORS, MEASURE.TRACKED_REVENUE_PER_VISITOR],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
         icon: 'upstack',
         measure: MEASURE.TRACKED_UNIQUE_VISITORS,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_AWARENESS,
         valueType: MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -171,13 +214,19 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_ADD_TO_CART_RATE]: {
         title: 'Add to Cart Rate',
         description: 'The percentage of views that resulted in an add to cart.',
+        shortTitle: 'ATC Rate',
+        tooltip: 'Percentage of product page views that resulted in an add-to-cart action. A key indicator of product page effectiveness.',
+        formulaDisplay: 'Add to Carts ÷ View Contents × 100',
+        formula: 'add_to_carts / view_contents * 100',
+        relatedMeasures: [MEASURE.TRACKED_ADD_TO_CARTS, MEASURE.TRACKED_VIEW_CONTENTS, MEASURE.TRACKED_INITIATE_CHECKOUT_RATE],
         sumPrefix: '',
         sumSuffix: '%',
         avgPrefix: '',
         avgSuffix: '%',
         icon: 'upstack',
         measure: MEASURE.TRACKED_ADD_TO_CART_RATE,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.PERCENTAGE,
         decimalPlaces: 2,
         useCompactNotation: false,
@@ -186,13 +235,19 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_VIEW_CONTENT_RATE]: {
         title: 'View Content Rate',
         description: 'The percentage of page views that resulted in a view content.',
+        shortTitle: 'VC Rate',
+        tooltip: 'Percentage of total page views that were product detail page views. Measures how much of your site traffic reaches product pages.',
+        formulaDisplay: 'View Contents ÷ Page Views × 100',
+        formula: 'view_contents / page_views * 100',
+        relatedMeasures: [MEASURE.TRACKED_VIEW_CONTENTS, MEASURE.TRACKED_PAGE_VIEWS, MEASURE.TRACKED_ADD_TO_CART_RATE],
         sumPrefix: '',
         sumSuffix: '%',
         avgPrefix: '',
         avgSuffix: '%',
         icon: 'upstack',
         measure: MEASURE.TRACKED_VIEW_CONTENT_RATE,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.PERCENTAGE,
         decimalPlaces: 2,
         useCompactNotation: false,
@@ -201,13 +256,19 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_INITIATE_CHECKOUT_RATE]: {
         title: 'Initiate Checkout Rate',
         description: 'The percentage of add to carts that resulted in an initiate checkout.',
+        shortTitle: 'IC Rate',
+        tooltip: 'Percentage of add-to-cart events that proceeded to checkout initiation. Low rates may indicate cart abandonment issues.',
+        formulaDisplay: 'Initiate Checkouts ÷ Add to Carts × 100',
+        formula: 'initiate_checkouts / add_to_carts * 100',
+        relatedMeasures: [MEASURE.TRACKED_INITIATE_CHECKOUTS, MEASURE.TRACKED_ADD_TO_CARTS, MEASURE.TRACKED_IC_TO_PURCHASE_RATE],
         sumPrefix: '',
         sumSuffix: '%',
         avgPrefix: '',
         avgSuffix: '%',
         icon: 'upstack',
         measure: MEASURE.TRACKED_INITIATE_CHECKOUT_RATE,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.PERCENTAGE,
         decimalPlaces: 2,
         useCompactNotation: false,
@@ -216,13 +277,19 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_ATC_TO_IC_RATE]: {
         title: 'Add to Cart to Initiate Checkout Rate',
         description: 'The percentage of add to carts that resulted in an initiate checkout.',
+        shortTitle: 'ATC to IC Rate',
+        tooltip: 'Percentage of add-to-cart events that proceeded to checkout. Measures how effectively your cart page converts shoppers to checkout.',
+        formulaDisplay: 'Initiate Checkouts ÷ Add to Carts × 100',
+        formula: 'initiate_checkouts / add_to_carts * 100',
+        relatedMeasures: [MEASURE.TRACKED_ADD_TO_CARTS, MEASURE.TRACKED_INITIATE_CHECKOUTS, MEASURE.TRACKED_IC_TO_PURCHASE_RATE],
         sumPrefix: '',
         sumSuffix: '%',
         avgPrefix: '',
         avgSuffix: '%',
         icon: 'upstack',
         measure: MEASURE.TRACKED_ATC_TO_IC_RATE,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.PERCENTAGE,
         decimalPlaces: 2,
         useCompactNotation: false,
@@ -231,13 +298,19 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_IC_TO_PURCHASE_RATE]: {
         title: 'Initiate Checkout to Purchase Rate',
         description: 'The percentage of initiate checkouts that resulted in a purchase.',
+        shortTitle: 'IC to Purchase Rate',
+        tooltip: 'Percentage of checkout initiations that completed as purchases. Low rates can indicate checkout friction or payment issues.',
+        formulaDisplay: 'Purchases ÷ Initiate Checkouts × 100',
+        formula: 'purchases / initiate_checkouts * 100',
+        relatedMeasures: [MEASURE.TRACKED_INITIATE_CHECKOUTS, MEASURE.TRACKED_PURCHASES, MEASURE.TRACKED_SESSION_CONVERSION_RATE],
         sumPrefix: '',
         sumSuffix: '%',
         avgPrefix: '',
         avgSuffix: '%',
         icon: 'upstack',
         measure: MEASURE.TRACKED_IC_TO_PURCHASE_RATE,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_CONVERSIONS,
         valueType: MeasureValueType.PERCENTAGE,
         decimalPlaces: 2,
         useCompactNotation: false,
@@ -246,13 +319,16 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_TOTAL_EVENTS]: {
         title: 'Total Events',
         description: 'The total number of events processed.',
+        tooltip: 'Total count of all tracking events processed by the Upstack pixel, including page views, product views, cart events, and purchases.',
+        relatedMeasures: [MEASURE.TRACKED_PAGE_VIEWS, MEASURE.TRACKED_PURCHASES],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
         icon: 'upstack',
         measure: MEASURE.TRACKED_TOTAL_EVENTS,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -261,13 +337,19 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_AVG_VIEW_CONTENTS_PER_SESSION]: {
         title: 'Average View Contents per Session',
         description: 'The average number of view contents per session.',
+        shortTitle: 'Avg. VC/Session',
+        tooltip: 'Average number of product detail pages viewed per session. Higher values indicate active browsing across your product catalog.',
+        formulaDisplay: 'View Contents ÷ Sessions',
+        formula: 'view_contents / sessions',
+        relatedMeasures: [MEASURE.TRACKED_VIEW_CONTENTS, MEASURE.TRACKED_UNIQUE_SESSIONS, MEASURE.TRACKED_AVG_PAGE_VIEWS_PER_SESSION],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
         icon: 'upstack',
         measure: MEASURE.TRACKED_AVG_VIEW_CONTENTS_PER_SESSION,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -276,13 +358,19 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_AVG_PAGE_VIEWS_PER_SESSION]: {
         title: 'Average Page Views per Session',
         description: 'The average number of page views per session.',
+        shortTitle: 'Avg. PV/Session',
+        tooltip: 'Average number of pages visited per session. More page views per session generally indicates stronger engagement with your site.',
+        formulaDisplay: 'Page Views ÷ Sessions',
+        formula: 'page_views / sessions',
+        relatedMeasures: [MEASURE.TRACKED_PAGE_VIEWS, MEASURE.TRACKED_UNIQUE_SESSIONS, MEASURE.TRACKED_AVG_VIEW_CONTENTS_PER_SESSION],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
         icon: 'upstack',
         measure: MEASURE.TRACKED_AVG_PAGE_VIEWS_PER_SESSION,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -291,13 +379,18 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_AVG_SESSIONS_PER_VISITOR]: {
         title: 'Avg. Sessions per Visitor',
         description: 'The number of sessions per visitor.',
+        tooltip: 'Average number of sessions each unique visitor has had. Higher values indicate returning visitors and stronger brand loyalty.',
+        formulaDisplay: 'Sessions ÷ Unique Visitors',
+        formula: 'sessions / unique_visitors',
+        relatedMeasures: [MEASURE.TRACKED_UNIQUE_SESSIONS, MEASURE.TRACKED_UNIQUE_VISITORS, MEASURE.TRACKED_NEW_VISITORS],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
         icon: 'upstack',
         measure: MEASURE.TRACKED_AVG_SESSIONS_PER_VISITOR,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_CONVERSIONS,
         valueType: MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -306,13 +399,17 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.SITE_TTFB]: {
         title: 'Time to First Byte',
         description: 'The time it takes for the server to respond.',
+        shortTitle: 'TTFB',
+        tooltip: 'Time from the browser making a request until it receives the first byte of response from the server. A key indicator of server performance.',
+        relatedMeasures: [MEASURE.SITE_FCP, MEASURE.SITE_LCP],
         sumPrefix: '',
         sumSuffix: 'ms',
         avgPrefix: '',
         avgSuffix: 'ms',
         icon: 'upstack',
         measure: MEASURE.SITE_TTFB,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.DURATION,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -321,13 +418,17 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.SITE_FCP]: {
         title: 'First Contentful Paint',
         description: 'The time it takes for the first content to appear.',
+        shortTitle: 'FCP',
+        tooltip: 'Time until the browser renders the first visible content on screen. Faster FCP improves perceived load speed and user experience.',
+        relatedMeasures: [MEASURE.SITE_TTFB, MEASURE.SITE_LCP],
         sumPrefix: '',
         sumSuffix: 'ms',
         avgPrefix: '',
         avgSuffix: 'ms',
         icon: 'upstack',
         measure: MEASURE.SITE_FCP,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.DURATION,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -336,13 +437,17 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.SITE_LCP]: {
         title: 'Largest Contentful Paint',
         description: 'The time it takes for the largest content to appear.',
+        shortTitle: 'LCP',
+        tooltip: 'Time until the largest visible element (hero image, headline) finishes rendering. A core Google Web Vitals metric for page performance.',
+        relatedMeasures: [MEASURE.SITE_FCP, MEASURE.SITE_TTFB],
         sumPrefix: '',
         sumSuffix: 'ms',
         avgPrefix: '',
         avgSuffix: 'ms',
         icon: 'upstack',
         measure: MEASURE.SITE_LCP,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.DURATION,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -351,13 +456,16 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.SITE_TIME_ON_SITE]: {
         title: 'Time on Site',
         description: 'The average time spent on the site.',
+        tooltip: 'Average total duration of a visit across all pages in a session. Longer time on site generally correlates with higher purchase intent.',
+        relatedMeasures: [MEASURE.TRACKED_AVG_TIME_ON_PAGE, MEASURE.TRACKED_AVG_ACTIVE_TIME, MEASURE.TRACKED_AVG_IDLE_TIME],
         sumPrefix: '',
         sumSuffix: 's',
         avgPrefix: '',
         avgSuffix: 's',
         icon: 'upstack',
         measure: MEASURE.SITE_TIME_ON_SITE,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.DURATION,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -366,13 +474,19 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_AVG_PAGE_VISITS_PER_SESSION]: {
         title: 'Average Page Visits per Session',
         description: 'The average number of page visits per session.',
+        shortTitle: 'Avg. Visits/Session',
+        tooltip: 'Average number of page visits (including repeat visits to the same page) per session. Differs from page views per session which counts unique pages.',
+        formulaDisplay: 'Page Visits ÷ Sessions',
+        formula: 'page_visits / sessions',
+        relatedMeasures: [MEASURE.TRACKED_AVG_PAGE_VIEWS_PER_SESSION, MEASURE.TRACKED_UNIQUE_SESSIONS],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
         icon: 'upstack',
         measure: MEASURE.TRACKED_AVG_PAGE_VISITS_PER_SESSION,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -381,13 +495,19 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_PV_TO_VC_RATE]: {
         title: 'Page Views to View Contents Rate',
         description: 'The percentage of page views that resulted in a view content.',
+        shortTitle: 'PV to VC Rate',
+        tooltip: 'Percentage of all page views that were product detail page views. Measures how well your site navigation drives visitors to product pages.',
+        formulaDisplay: 'View Contents ÷ Page Views × 100',
+        formula: 'view_contents / page_views * 100',
+        relatedMeasures: [MEASURE.TRACKED_PAGE_VIEWS, MEASURE.TRACKED_VIEW_CONTENTS, MEASURE.TRACKED_VC_TO_ATC_RATE],
         sumPrefix: '',
         sumSuffix: '%',
         avgPrefix: '',
         avgSuffix: '%',
         icon: 'upstack',
         measure: MEASURE.TRACKED_PV_TO_VC_RATE,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.PERCENTAGE,
         decimalPlaces: 2,
         useCompactNotation: false,
@@ -396,13 +516,19 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_VC_TO_ATC_RATE]: {
         title: 'View Contents to Add to Cart Rate',
         description: 'The percentage of view contents that resulted in an add to cart.',
+        shortTitle: 'VC to ATC Rate',
+        tooltip: 'Percentage of product page views that resulted in an add to cart. Measures product page persuasiveness and purchase intent conversion.',
+        formulaDisplay: 'Add to Carts ÷ View Contents × 100',
+        formula: 'add_to_carts / view_contents * 100',
+        relatedMeasures: [MEASURE.TRACKED_VIEW_CONTENTS, MEASURE.TRACKED_ADD_TO_CARTS, MEASURE.TRACKED_ATC_TO_IC_RATE],
         sumPrefix: '',
         sumSuffix: '%',
         avgPrefix: '',
         avgSuffix: '%',
         icon: 'upstack',
         measure: MEASURE.TRACKED_VC_TO_ATC_RATE,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.PERCENTAGE,
         decimalPlaces: 2,
         useCompactNotation: false,
@@ -411,13 +537,16 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_NEW_VISITORS]: {
         title: 'New Visitors',
         description: 'The number of new visitors.',
+        tooltip: 'Count of visitors identified by the Upstack pixel as first-time visitors to your store. Indicates the effectiveness of customer acquisition.',
+        relatedMeasures: [MEASURE.TRACKED_UNIQUE_VISITORS, MEASURE.TRACKED_NEW_VISITORS_PERCENT, MEASURE.TRACKED_NEW_SESSIONS],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
         icon: 'upstack',
         measure: MEASURE.TRACKED_NEW_VISITORS,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_AWARENESS,
         valueType: MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -426,13 +555,19 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_NEW_VISITORS_PERCENT]: {
         title: 'New Visitors Percentage',
         description: 'The percentage of visitors that are new visitors.',
+        shortTitle: 'New Visitors %',
+        tooltip: 'Percentage of total unique visitors who are first-time visitors. High percentages indicate strong acquisition but may suggest retention challenges.',
+        formulaDisplay: 'New Visitors ÷ Unique Visitors × 100',
+        formula: 'new_visitors / unique_visitors * 100',
+        relatedMeasures: [MEASURE.TRACKED_NEW_VISITORS, MEASURE.TRACKED_UNIQUE_VISITORS, MEASURE.TRACKED_NEW_SESSION_PERCENT],
         sumPrefix: '',
         sumSuffix: '%',
         avgPrefix: '',
         avgSuffix: '%',
         icon: 'upstack',
         measure: MEASURE.TRACKED_NEW_VISITORS_PERCENT,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_AWARENESS,
         valueType: MeasureValueType.PERCENTAGE,
         decimalPlaces: 2,
         useCompactNotation: false,
@@ -441,13 +576,19 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_NEW_SESSION_PERCENT]: {
         title: 'New Session Percentage',
         description: 'The percentage of sessions that are new sessions.',
+        shortTitle: 'New Sessions %',
+        tooltip: 'Percentage of all sessions that are first-ever sessions from new visitors. A complement to New Visitors Percentage at the session level.',
+        formulaDisplay: 'New Sessions ÷ Total Sessions × 100',
+        formula: 'new_sessions / total_sessions * 100',
+        relatedMeasures: [MEASURE.TRACKED_NEW_SESSIONS, MEASURE.TRACKED_UNIQUE_SESSIONS, MEASURE.TRACKED_NEW_VISITORS_PERCENT],
         sumPrefix: '',
         sumSuffix: '%',
         avgPrefix: '',
         avgSuffix: '%',
         icon: 'upstack',
         measure: MEASURE.TRACKED_NEW_SESSION_PERCENT,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_AWARENESS,
         valueType: MeasureValueType.PERCENTAGE,
         decimalPlaces: 2,
         useCompactNotation: false,
@@ -456,13 +597,16 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_NEW_SESSIONS]: {
         title: 'New Sessions',
         description: 'The number of new sessions.',
+        tooltip: 'Count of sessions that are the visitor\'s first-ever session on your store, tracked via the Upstack pixel identity graph.',
+        relatedMeasures: [MEASURE.TRACKED_UNIQUE_SESSIONS, MEASURE.TRACKED_NEW_VISITORS, MEASURE.TRACKED_NEW_SESSION_PERCENT],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
         icon: 'upstack',
         measure: MEASURE.TRACKED_NEW_SESSIONS,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_AWARENESS,
         valueType: MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -471,13 +615,19 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_SESSION_VIEW_PRODUCT_RATE]: {
         title: 'Session View Product Rate',
         description: 'The percentage of sessions that view a product.',
+        shortTitle: 'View Product Rate',
+        tooltip: 'Percentage of sessions where the visitor viewed at least one product detail page. Measures how well your site funnels visitors from landing to product discovery.',
+        formulaDisplay: 'Sessions with Product View ÷ Total Sessions × 100',
+        formula: 'sessions_with_view_content / total_sessions * 100',
+        relatedMeasures: [MEASURE.TRACKED_VIEW_CONTENTS, MEASURE.TRACKED_UNIQUE_SESSIONS, MEASURE.TRACKED_ADD_TO_CART_RATE],
         sumPrefix: '',
         sumSuffix: '%',
         avgPrefix: '',
         avgSuffix: '%',
         icon: 'upstack',
         measure: MEASURE.TRACKED_SESSION_VIEW_PRODUCT_RATE,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.PERCENTAGE,
         decimalPlaces: 2,
         useCompactNotation: false,
@@ -486,13 +636,17 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_AVG_TIME_ON_PAGE]: {
         title: 'Average Time on Page',
         description: 'The average time spent on a page.',
+        shortTitle: 'Avg. Time on Page',
+        tooltip: 'Average time visitors spend on each individual page. Longer time on product pages typically correlates with higher purchase intent.',
+        relatedMeasures: [MEASURE.SITE_TIME_ON_SITE, MEASURE.TRACKED_AVG_ACTIVE_TIME, MEASURE.TRACKED_AVG_SCROLL_DEPTH],
         sumPrefix: '',
         sumSuffix: 's',
         avgPrefix: '',
         avgSuffix: 's',
         icon: 'upstack',
         measure: MEASURE.TRACKED_AVG_TIME_ON_PAGE,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.DURATION,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -501,13 +655,18 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_BOUNCE_RATE]: {
         title: 'Bounce Rate',
         description: 'The percentage of sessions that bounce.',
+        tooltip: 'Percentage of sessions where the visitor viewed only one page and left without any further interaction. High bounce rates may indicate landing page relevance issues.',
+        formulaDisplay: 'Bounced Sessions ÷ Total Sessions × 100',
+        formula: 'bounced_sessions / total_sessions * 100',
+        relatedMeasures: [MEASURE.TRACKED_UNIQUE_SESSIONS, MEASURE.TRACKED_AVG_TIME_ON_PAGE, MEASURE.TRACKED_SESSION_CONVERSION_RATE],
         sumPrefix: '',
         sumSuffix: '%',
         avgPrefix: '',
         avgSuffix: '%',
         icon: 'upstack',
         measure: MEASURE.TRACKED_BOUNCE_RATE,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.PERCENTAGE,
         decimalPlaces: 2,
         useCompactNotation: false,
@@ -516,13 +675,16 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_AVG_ACTIVE_TIME]: {
         title: 'Avg. Active Time',
         description: 'The average active time spent on a page.',
+        tooltip: 'Average time per page where the visitor was actively engaged (scrolling, clicking, typing), excluding idle periods.',
+        relatedMeasures: [MEASURE.TRACKED_AVG_TIME_ON_PAGE, MEASURE.TRACKED_AVG_IDLE_TIME],
         sumPrefix: '',
         sumSuffix: 's',
         avgPrefix: '',
         avgSuffix: 's',
         icon: 'upstack',
         measure: MEASURE.TRACKED_AVG_ACTIVE_TIME,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.DURATION,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -531,13 +693,16 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_AVG_IDLE_TIME]: {
         title: 'Avg. Idle Time',
         description: 'The average idle time on a page.',
+        tooltip: 'Average time per page where the visitor was inactive. Very high idle time may indicate distraction or confusion navigating the page.',
+        relatedMeasures: [MEASURE.TRACKED_AVG_TIME_ON_PAGE, MEASURE.TRACKED_AVG_ACTIVE_TIME],
         sumPrefix: '',
         sumSuffix: 's',
         avgPrefix: '',
         avgSuffix: 's',
         icon: 'upstack',
         measure: MEASURE.TRACKED_AVG_IDLE_TIME,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.DURATION,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -546,13 +711,16 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_AVG_SCROLL_DEPTH]: {
         title: 'Avg. Scroll Depth',
         description: 'The average maximum scroll depth reached on a page.',
+        tooltip: 'Average percentage of page height scrolled per page view. Higher scroll depth on product pages indicates visitors are reading full product descriptions.',
+        relatedMeasures: [MEASURE.TRACKED_AVG_EXIT_SCROLL_DEPTH, MEASURE.TRACKED_AVG_TIME_ON_PAGE],
         sumPrefix: '',
         sumSuffix: '%',
         avgPrefix: '',
         avgSuffix: '%',
         icon: 'upstack',
         measure: MEASURE.TRACKED_AVG_SCROLL_DEPTH,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.PERCENTAGE,
         decimalPlaces: 2,
         useCompactNotation: false,
@@ -561,13 +729,17 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_AVG_EXIT_SCROLL_DEPTH]: {
         title: 'Avg. Exit Scroll Depth',
         description: 'The average scroll depth at the time of page exit.',
+        shortTitle: 'Exit Scroll Depth',
+        tooltip: 'Average scroll position when visitors left the page. Compares to max scroll depth to identify how much content visitors see before leaving.',
+        relatedMeasures: [MEASURE.TRACKED_AVG_SCROLL_DEPTH, MEASURE.TRACKED_BOUNCE_RATE],
         sumPrefix: '',
         sumSuffix: '%',
         avgPrefix: '',
         avgSuffix: '%',
         icon: 'upstack',
         measure: MEASURE.TRACKED_AVG_EXIT_SCROLL_DEPTH,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.PERCENTAGE,
         decimalPlaces: 2,
         useCompactNotation: false,
@@ -576,13 +748,16 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_AVG_INTERACTION_COUNT]: {
         title: 'Avg. Interactions',
         description: 'The average number of interactions per page view.',
+        tooltip: 'Average count of all interaction events (clicks, keypresses, scrolls, swipes) per page view. Higher counts indicate more engaged visitors.',
+        relatedMeasures: [MEASURE.TRACKED_AVG_CLICK_COUNT, MEASURE.TRACKED_AVG_KEYPRESS_COUNT, MEASURE.TRACKED_AVG_SCROLL_DEPTH],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
         icon: 'upstack',
         measure: MEASURE.TRACKED_AVG_INTERACTION_COUNT,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -591,13 +766,16 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_AVG_CLICK_COUNT]: {
         title: 'Avg. Clicks',
         description: 'The average number of clicks per page view.',
+        tooltip: 'Average number of click events per page view, indicating how actively visitors engage with links, buttons, and interactive elements.',
+        relatedMeasures: [MEASURE.TRACKED_AVG_INTERACTION_COUNT, MEASURE.TRACKED_AVG_RAPID_CLICK_COUNT],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
         icon: 'upstack',
         measure: MEASURE.TRACKED_AVG_CLICK_COUNT,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -606,13 +784,16 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_AVG_KEYPRESS_COUNT]: {
         title: 'Avg. Keypresses',
         description: 'The average number of keypresses per page view.',
+        tooltip: 'Average keyboard interactions per page view. High keypress counts typically indicate search usage or checkout form completion.',
+        relatedMeasures: [MEASURE.TRACKED_AVG_INTERACTION_COUNT, MEASURE.TRACKED_AVG_INPUT_FIELD_FOCUS_COUNT],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
         icon: 'upstack',
         measure: MEASURE.TRACKED_AVG_KEYPRESS_COUNT,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -621,13 +802,16 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_AVG_SWIPE_COUNT]: {
         title: 'Avg. Swipes',
         description: 'The average number of swipe gestures per page view.',
+        tooltip: 'Average swipe gestures per page view on mobile devices. High swipe counts indicate active mobile browsing through product images or carousels.',
+        relatedMeasures: [MEASURE.TRACKED_AVG_INTERACTION_COUNT, MEASURE.TRACKED_AVG_PINCH_ZOOM_COUNT],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
         icon: 'upstack',
         measure: MEASURE.TRACKED_AVG_SWIPE_COUNT,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -636,13 +820,16 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_AVG_PINCH_ZOOM_COUNT]: {
         title: 'Avg. Pinch Zooms',
         description: 'The average number of pinch-to-zoom actions per page view.',
+        tooltip: 'Average pinch-to-zoom gestures per page view on mobile devices. Frequent zooming on product pages often indicates interest in product images or fine print.',
+        relatedMeasures: [MEASURE.TRACKED_AVG_SWIPE_COUNT, MEASURE.TRACKED_AVG_INTERACTION_COUNT],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
         icon: 'upstack',
         measure: MEASURE.TRACKED_AVG_PINCH_ZOOM_COUNT,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -651,13 +838,16 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_AVG_SCROLL_UP_COUNT]: {
         title: 'Avg. Scroll Ups',
         description: 'The average number of scroll-up actions per page view.',
+        tooltip: 'Average times a visitor scrolled back up per page view. Repeated upward scrolling can indicate re-reading content or searching for specific information.',
+        relatedMeasures: [MEASURE.TRACKED_AVG_SCROLL_DEPTH, MEASURE.TRACKED_AVG_INTERACTION_COUNT],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
         icon: 'upstack',
         measure: MEASURE.TRACKED_AVG_SCROLL_UP_COUNT,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -666,13 +856,17 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_AVG_INPUT_FIELD_FOCUS_COUNT]: {
         title: 'Avg. Input Field Focuses',
         description: 'The average number of input field focus events per page view.',
+        shortTitle: 'Avg. Form Focuses',
+        tooltip: 'Average times visitors clicked into input fields per page view. High values on checkout pages indicate active form engagement.',
+        relatedMeasures: [MEASURE.TRACKED_AVG_KEYPRESS_COUNT, MEASURE.TRACKED_AVG_INTERACTION_COUNT],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
         icon: 'upstack',
         measure: MEASURE.TRACKED_AVG_INPUT_FIELD_FOCUS_COUNT,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -681,13 +875,16 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_AVG_COPY_COUNT]: {
         title: 'Avg. Copy Actions',
         description: 'The average number of copy actions per page view.',
+        tooltip: 'Average times visitors copied text per page view. Copy actions on product pages can indicate interest in product details, prices, or discount codes.',
+        relatedMeasures: [MEASURE.TRACKED_AVG_INTERACTION_COUNT, MEASURE.TRACKED_AVG_CLICK_COUNT],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
         icon: 'upstack',
         measure: MEASURE.TRACKED_AVG_COPY_COUNT,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -696,13 +893,16 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_AVG_RAPID_CLICK_COUNT]: {
         title: 'Avg. Rapid Clicks',
         description: 'The average number of rapid click events per page view.',
+        tooltip: 'Average count of rapid successive clicks per page view. Elevated rapid click counts may signal frustration with slow or unresponsive page elements.',
+        relatedMeasures: [MEASURE.TRACKED_AVG_CLICK_COUNT, MEASURE.TRACKED_AVG_INTERACTION_COUNT],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
         icon: 'upstack',
         measure: MEASURE.TRACKED_AVG_RAPID_CLICK_COUNT,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -711,13 +911,16 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_AVG_PAGE_SCORE]: {
         title: 'Avg. Page Score',
         description: 'The average page engagement score.',
+        tooltip: 'Average engagement score (0-100) per page view, combining scroll depth, active time, interactions, and other engagement signals.',
+        relatedMeasures: [MEASURE.TRACKED_AVG_INTENT_SCORE, MEASURE.TRACKED_AVG_SCROLL_DEPTH, MEASURE.TRACKED_AVG_TIME_ON_PAGE],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '/100',
         icon: 'upstack',
         measure: MEASURE.TRACKED_AVG_PAGE_SCORE,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.NUMBER,
         decimalPlaces: 1,
         useCompactNotation: false,
@@ -726,13 +929,16 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_AVG_INTENT_SCORE]: {
         title: 'Avg. Intent Score',
         description: 'The average purchase intent score.',
+        tooltip: 'Average purchase intent score (0-100) per page view, estimating how likely a visitor is to convert based on behavioral signals from the session.',
+        relatedMeasures: [MEASURE.TRACKED_AVG_PAGE_SCORE, MEASURE.TRACKED_SESSION_CONVERSION_RATE],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '/100',
         icon: 'upstack',
         measure: MEASURE.TRACKED_AVG_INTENT_SCORE,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.NUMBER,
         decimalPlaces: 1,
         useCompactNotation: false,
@@ -741,13 +947,17 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_PAGE_END_EVENTS]: {
         title: 'Page End Events',
         description: 'The total number of page end events processed.',
+        shortTitle: 'Page Exits',
+        tooltip: 'Total count of page exit events fired by the Upstack pixel when visitors leave a page. Used to calculate time on page and exit scroll depth.',
+        relatedMeasures: [MEASURE.TRACKED_PAGE_VIEWS, MEASURE.TRACKED_AVG_EXIT_SCROLL_DEPTH],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
         icon: 'upstack',
         measure: MEASURE.TRACKED_PAGE_END_EVENTS,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -756,13 +966,17 @@ export const TRACKED_MEASURES_MAP = {
     [MEASURE.TRACKED_AVG_TIME_TO_FIRST_INTERACTION]: {
         title: 'Avg. Time to First Interaction',
         description: 'The average time until the first user interaction on a page.',
+        shortTitle: 'Time to First Interact',
+        tooltip: 'Average time from page load until the visitor makes their first interaction (click, scroll, or keypress). Lower values indicate faster engagement.',
+        relatedMeasures: [MEASURE.TRACKED_AVG_ACTIVE_TIME, MEASURE.SITE_FCP, MEASURE.TRACKED_AVG_INTERACTION_COUNT],
         sumPrefix: '',
         sumSuffix: 's',
         avgPrefix: '',
         avgSuffix: 's',
         icon: 'upstack',
         measure: MEASURE.TRACKED_AVG_TIME_TO_FIRST_INTERACTION,
-        category: MEASURE_CATEGORY.UPSTACK_DATA,
+        category: MEASURE_CATEGORY.FUNNEL,
+        subcategory: MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: MeasureValueType.DURATION,
         decimalPlaces: 0,
         useCompactNotation: false,