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

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

@@ -3,19 +3,23 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TRACKED_MEASURES_MAP = void 0;
 const measures_js_1 = require("../measures.js");
 const measure_categories_js_1 = require("./measure-categories.js");
+const measure_icon_js_1 = require("./measure-icon.js");
 const measure_value_type_js_1 = require("./measure-value-type.js");
 const measure_applicable_contexts_js_1 = require("./measure-applicable-contexts.js");
 exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_UNIQUE_SESSIONS, measures_js_1.MEASURE.TRACKED_AVG_PAGE_VIEWS_PER_SESSION],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_PAGE_VIEWS,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_AWARENESS,
         valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -24,13 +28,16 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_ADD_TO_CARTS, measures_js_1.MEASURE.TRACKED_VIEW_CONTENT_RATE, measures_js_1.MEASURE.TRACKED_VC_TO_ATC_RATE],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_VIEW_CONTENTS,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -39,13 +46,16 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_VIEW_CONTENTS, measures_js_1.MEASURE.TRACKED_INITIATE_CHECKOUTS, measures_js_1.MEASURE.TRACKED_ADD_TO_CART_RATE],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_ADD_TO_CARTS,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -54,13 +64,17 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_ADD_TO_CARTS, measures_js_1.MEASURE.TRACKED_PURCHASES, measures_js_1.MEASURE.TRACKED_ATC_TO_IC_RATE],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_INITIATE_CHECKOUTS,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -69,13 +83,16 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_REVENUE, measures_js_1.MEASURE.TRACKED_INITIATE_CHECKOUTS, measures_js_1.MEASURE.TRACKED_IC_TO_PURCHASE_RATE],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_PURCHASES,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_CONVERSIONS,
         valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -84,13 +101,16 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_PURCHASES, measures_js_1.MEASURE.TRACKED_REVENUE_PER_VISITOR, measures_js_1.MEASURE.TRACKED_REVENUE_PER_SESSION],
         sumPrefix: '$',
         sumSuffix: '',
         avgPrefix: '$',
         avgSuffix: '',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_REVENUE,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_CONVERSIONS,
         valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
         decimalPlaces: 2,
         useCompactNotation: true,
@@ -99,13 +119,19 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_PURCHASES, measures_js_1.MEASURE.TRACKED_UNIQUE_SESSIONS, measures_js_1.MEASURE.TRACKED_REVENUE],
         sumPrefix: '',
         sumSuffix: '%',
         avgPrefix: '',
         avgSuffix: '%',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_SESSION_CONVERSION_RATE,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_CONVERSIONS,
         valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
         decimalPlaces: 2,
         useCompactNotation: false,
@@ -114,13 +140,19 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_REVENUE, measures_js_1.MEASURE.TRACKED_UNIQUE_VISITORS, measures_js_1.MEASURE.TRACKED_REVENUE_PER_SESSION],
         sumPrefix: '$',
         sumSuffix: '',
         avgPrefix: '$',
         avgSuffix: '',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_REVENUE_PER_VISITOR,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_CONVERSIONS,
         valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
         decimalPlaces: 2,
         useCompactNotation: true,
@@ -129,13 +161,19 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_REVENUE, measures_js_1.MEASURE.TRACKED_UNIQUE_SESSIONS, measures_js_1.MEASURE.TRACKED_REVENUE_PER_VISITOR],
         sumPrefix: '$',
         sumSuffix: '',
         avgPrefix: '$',
         avgSuffix: '',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_REVENUE_PER_SESSION,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_CONVERSIONS,
         valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
         decimalPlaces: 2,
         useCompactNotation: true,
@@ -144,13 +182,16 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_UNIQUE_VISITORS, measures_js_1.MEASURE.TRACKED_PAGE_VIEWS, measures_js_1.MEASURE.TRACKED_SESSION_CONVERSION_RATE],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_UNIQUE_SESSIONS,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_AWARENESS,
         valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -159,13 +200,16 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_UNIQUE_SESSIONS, measures_js_1.MEASURE.TRACKED_NEW_VISITORS, measures_js_1.MEASURE.TRACKED_REVENUE_PER_VISITOR],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_UNIQUE_VISITORS,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_AWARENESS,
         valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -174,13 +218,19 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_ADD_TO_CARTS, measures_js_1.MEASURE.TRACKED_VIEW_CONTENTS, measures_js_1.MEASURE.TRACKED_INITIATE_CHECKOUT_RATE],
         sumPrefix: '',
         sumSuffix: '%',
         avgPrefix: '',
         avgSuffix: '%',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_ADD_TO_CART_RATE,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
         decimalPlaces: 2,
         useCompactNotation: false,
@@ -189,13 +239,19 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_VIEW_CONTENTS, measures_js_1.MEASURE.TRACKED_PAGE_VIEWS, measures_js_1.MEASURE.TRACKED_ADD_TO_CART_RATE],
         sumPrefix: '',
         sumSuffix: '%',
         avgPrefix: '',
         avgSuffix: '%',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_VIEW_CONTENT_RATE,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
         decimalPlaces: 2,
         useCompactNotation: false,
@@ -204,13 +260,19 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_INITIATE_CHECKOUTS, measures_js_1.MEASURE.TRACKED_ADD_TO_CARTS, measures_js_1.MEASURE.TRACKED_IC_TO_PURCHASE_RATE],
         sumPrefix: '',
         sumSuffix: '%',
         avgPrefix: '',
         avgSuffix: '%',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_INITIATE_CHECKOUT_RATE,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
         decimalPlaces: 2,
         useCompactNotation: false,
@@ -219,13 +281,19 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_ADD_TO_CARTS, measures_js_1.MEASURE.TRACKED_INITIATE_CHECKOUTS, measures_js_1.MEASURE.TRACKED_IC_TO_PURCHASE_RATE],
         sumPrefix: '',
         sumSuffix: '%',
         avgPrefix: '',
         avgSuffix: '%',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_ATC_TO_IC_RATE,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
         decimalPlaces: 2,
         useCompactNotation: false,
@@ -234,13 +302,19 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_INITIATE_CHECKOUTS, measures_js_1.MEASURE.TRACKED_PURCHASES, measures_js_1.MEASURE.TRACKED_SESSION_CONVERSION_RATE],
         sumPrefix: '',
         sumSuffix: '%',
         avgPrefix: '',
         avgSuffix: '%',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_IC_TO_PURCHASE_RATE,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_CONVERSIONS,
         valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
         decimalPlaces: 2,
         useCompactNotation: false,
@@ -249,13 +323,16 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_PAGE_VIEWS, measures_js_1.MEASURE.TRACKED_PURCHASES],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_TOTAL_EVENTS,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -264,13 +341,19 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_VIEW_CONTENTS, measures_js_1.MEASURE.TRACKED_UNIQUE_SESSIONS, measures_js_1.MEASURE.TRACKED_AVG_PAGE_VIEWS_PER_SESSION],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_AVG_VIEW_CONTENTS_PER_SESSION,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -279,13 +362,19 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_PAGE_VIEWS, measures_js_1.MEASURE.TRACKED_UNIQUE_SESSIONS, measures_js_1.MEASURE.TRACKED_AVG_VIEW_CONTENTS_PER_SESSION],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_AVG_PAGE_VIEWS_PER_SESSION,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -294,13 +383,18 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_UNIQUE_SESSIONS, measures_js_1.MEASURE.TRACKED_UNIQUE_VISITORS, measures_js_1.MEASURE.TRACKED_NEW_VISITORS],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_AVG_SESSIONS_PER_VISITOR,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_CONVERSIONS,
         valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -309,13 +403,17 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.SITE_FCP, measures_js_1.MEASURE.SITE_LCP],
         sumPrefix: '',
         sumSuffix: 'ms',
         avgPrefix: '',
         avgSuffix: 'ms',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.SITE_TTFB,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.DURATION,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -324,13 +422,17 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.SITE_TTFB, measures_js_1.MEASURE.SITE_LCP],
         sumPrefix: '',
         sumSuffix: 'ms',
         avgPrefix: '',
         avgSuffix: 'ms',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.SITE_FCP,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.DURATION,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -339,13 +441,17 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.SITE_FCP, measures_js_1.MEASURE.SITE_TTFB],
         sumPrefix: '',
         sumSuffix: 'ms',
         avgPrefix: '',
         avgSuffix: 'ms',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.SITE_LCP,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.DURATION,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -354,13 +460,16 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_AVG_TIME_ON_PAGE, measures_js_1.MEASURE.TRACKED_AVG_ACTIVE_TIME, measures_js_1.MEASURE.TRACKED_AVG_IDLE_TIME],
         sumPrefix: '',
         sumSuffix: 's',
         avgPrefix: '',
         avgSuffix: 's',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.SITE_TIME_ON_SITE,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.DURATION,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -369,13 +478,19 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_AVG_PAGE_VIEWS_PER_SESSION, measures_js_1.MEASURE.TRACKED_UNIQUE_SESSIONS],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_AVG_PAGE_VISITS_PER_SESSION,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -384,13 +499,19 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_PAGE_VIEWS, measures_js_1.MEASURE.TRACKED_VIEW_CONTENTS, measures_js_1.MEASURE.TRACKED_VC_TO_ATC_RATE],
         sumPrefix: '',
         sumSuffix: '%',
         avgPrefix: '',
         avgSuffix: '%',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_PV_TO_VC_RATE,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
         decimalPlaces: 2,
         useCompactNotation: false,
@@ -399,13 +520,19 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_VIEW_CONTENTS, measures_js_1.MEASURE.TRACKED_ADD_TO_CARTS, measures_js_1.MEASURE.TRACKED_ATC_TO_IC_RATE],
         sumPrefix: '',
         sumSuffix: '%',
         avgPrefix: '',
         avgSuffix: '%',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_VC_TO_ATC_RATE,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
         decimalPlaces: 2,
         useCompactNotation: false,
@@ -414,13 +541,16 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_UNIQUE_VISITORS, measures_js_1.MEASURE.TRACKED_NEW_VISITORS_PERCENT, measures_js_1.MEASURE.TRACKED_NEW_SESSIONS],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_NEW_VISITORS,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_AWARENESS,
         valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -429,13 +559,19 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_NEW_VISITORS, measures_js_1.MEASURE.TRACKED_UNIQUE_VISITORS, measures_js_1.MEASURE.TRACKED_NEW_SESSION_PERCENT],
         sumPrefix: '',
         sumSuffix: '%',
         avgPrefix: '',
         avgSuffix: '%',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_NEW_VISITORS_PERCENT,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_AWARENESS,
         valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
         decimalPlaces: 2,
         useCompactNotation: false,
@@ -444,13 +580,19 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_NEW_SESSIONS, measures_js_1.MEASURE.TRACKED_UNIQUE_SESSIONS, measures_js_1.MEASURE.TRACKED_NEW_VISITORS_PERCENT],
         sumPrefix: '',
         sumSuffix: '%',
         avgPrefix: '',
         avgSuffix: '%',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_NEW_SESSION_PERCENT,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_AWARENESS,
         valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
         decimalPlaces: 2,
         useCompactNotation: false,
@@ -459,13 +601,16 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_UNIQUE_SESSIONS, measures_js_1.MEASURE.TRACKED_NEW_VISITORS, measures_js_1.MEASURE.TRACKED_NEW_SESSION_PERCENT],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_NEW_SESSIONS,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_AWARENESS,
         valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -474,13 +619,19 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_VIEW_CONTENTS, measures_js_1.MEASURE.TRACKED_UNIQUE_SESSIONS, measures_js_1.MEASURE.TRACKED_ADD_TO_CART_RATE],
         sumPrefix: '',
         sumSuffix: '%',
         avgPrefix: '',
         avgSuffix: '%',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_SESSION_VIEW_PRODUCT_RATE,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
         decimalPlaces: 2,
         useCompactNotation: false,
@@ -489,13 +640,17 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.SITE_TIME_ON_SITE, measures_js_1.MEASURE.TRACKED_AVG_ACTIVE_TIME, measures_js_1.MEASURE.TRACKED_AVG_SCROLL_DEPTH],
         sumPrefix: '',
         sumSuffix: 's',
         avgPrefix: '',
         avgSuffix: 's',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_AVG_TIME_ON_PAGE,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.DURATION,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -504,13 +659,18 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_UNIQUE_SESSIONS, measures_js_1.MEASURE.TRACKED_AVG_TIME_ON_PAGE, measures_js_1.MEASURE.TRACKED_SESSION_CONVERSION_RATE],
         sumPrefix: '',
         sumSuffix: '%',
         avgPrefix: '',
         avgSuffix: '%',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_BOUNCE_RATE,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
         decimalPlaces: 2,
         useCompactNotation: false,
@@ -519,13 +679,16 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_AVG_TIME_ON_PAGE, measures_js_1.MEASURE.TRACKED_AVG_IDLE_TIME],
         sumPrefix: '',
         sumSuffix: 's',
         avgPrefix: '',
         avgSuffix: 's',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_AVG_ACTIVE_TIME,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.DURATION,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -534,13 +697,16 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_AVG_TIME_ON_PAGE, measures_js_1.MEASURE.TRACKED_AVG_ACTIVE_TIME],
         sumPrefix: '',
         sumSuffix: 's',
         avgPrefix: '',
         avgSuffix: 's',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_AVG_IDLE_TIME,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.DURATION,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -549,13 +715,16 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_AVG_EXIT_SCROLL_DEPTH, measures_js_1.MEASURE.TRACKED_AVG_TIME_ON_PAGE],
         sumPrefix: '',
         sumSuffix: '%',
         avgPrefix: '',
         avgSuffix: '%',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_AVG_SCROLL_DEPTH,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
         decimalPlaces: 2,
         useCompactNotation: false,
@@ -564,13 +733,17 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_AVG_SCROLL_DEPTH, measures_js_1.MEASURE.TRACKED_BOUNCE_RATE],
         sumPrefix: '',
         sumSuffix: '%',
         avgPrefix: '',
         avgSuffix: '%',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_AVG_EXIT_SCROLL_DEPTH,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
         decimalPlaces: 2,
         useCompactNotation: false,
@@ -579,13 +752,16 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_AVG_CLICK_COUNT, measures_js_1.MEASURE.TRACKED_AVG_KEYPRESS_COUNT, measures_js_1.MEASURE.TRACKED_AVG_SCROLL_DEPTH],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_AVG_INTERACTION_COUNT,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -594,13 +770,16 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_AVG_INTERACTION_COUNT, measures_js_1.MEASURE.TRACKED_AVG_RAPID_CLICK_COUNT],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_AVG_CLICK_COUNT,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -609,13 +788,16 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_AVG_INTERACTION_COUNT, measures_js_1.MEASURE.TRACKED_AVG_INPUT_FIELD_FOCUS_COUNT],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_AVG_KEYPRESS_COUNT,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -624,13 +806,16 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_AVG_INTERACTION_COUNT, measures_js_1.MEASURE.TRACKED_AVG_PINCH_ZOOM_COUNT],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_AVG_SWIPE_COUNT,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -639,13 +824,16 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_AVG_SWIPE_COUNT, measures_js_1.MEASURE.TRACKED_AVG_INTERACTION_COUNT],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_AVG_PINCH_ZOOM_COUNT,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -654,13 +842,16 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_AVG_SCROLL_DEPTH, measures_js_1.MEASURE.TRACKED_AVG_INTERACTION_COUNT],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_AVG_SCROLL_UP_COUNT,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -669,13 +860,17 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_AVG_KEYPRESS_COUNT, measures_js_1.MEASURE.TRACKED_AVG_INTERACTION_COUNT],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_AVG_INPUT_FIELD_FOCUS_COUNT,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -684,13 +879,16 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_AVG_INTERACTION_COUNT, measures_js_1.MEASURE.TRACKED_AVG_CLICK_COUNT],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_AVG_COPY_COUNT,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -699,13 +897,16 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_AVG_CLICK_COUNT, measures_js_1.MEASURE.TRACKED_AVG_INTERACTION_COUNT],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_AVG_RAPID_CLICK_COUNT,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -714,13 +915,16 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_AVG_INTENT_SCORE, measures_js_1.MEASURE.TRACKED_AVG_SCROLL_DEPTH, measures_js_1.MEASURE.TRACKED_AVG_TIME_ON_PAGE],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '/100',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_AVG_PAGE_SCORE,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
         decimalPlaces: 1,
         useCompactNotation: false,
@@ -729,13 +933,16 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_AVG_PAGE_SCORE, measures_js_1.MEASURE.TRACKED_SESSION_CONVERSION_RATE],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '/100',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_AVG_INTENT_SCORE,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
         decimalPlaces: 1,
         useCompactNotation: false,
@@ -744,13 +951,17 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_PAGE_VIEWS, measures_js_1.MEASURE.TRACKED_AVG_EXIT_SCROLL_DEPTH],
         sumPrefix: '',
         sumSuffix: '',
         avgPrefix: '',
         avgSuffix: '',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_PAGE_END_EVENTS,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
         decimalPlaces: 0,
         useCompactNotation: false,
@@ -759,13 +970,17 @@ exports.TRACKED_MEASURES_MAP = {
     [measures_js_1.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: [measures_js_1.MEASURE.TRACKED_AVG_ACTIVE_TIME, measures_js_1.MEASURE.SITE_FCP, measures_js_1.MEASURE.TRACKED_AVG_INTERACTION_COUNT],
         sumPrefix: '',
         sumSuffix: 's',
         avgPrefix: '',
         avgSuffix: 's',
-        icon: 'upstack',
+        icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
         measure: measures_js_1.MEASURE.TRACKED_AVG_TIME_TO_FIRST_INTERACTION,
-        category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
+        category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
+        subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_ENGAGEMENT,
         valueType: measure_value_type_js_1.MeasureValueType.DURATION,
         decimalPlaces: 0,
         useCompactNotation: false,