@liiift-studio/sanity-visitor-insights 0.60.0 → 0.62.0

package/dist/index.js

@@ -348,10 +348,14 @@ var import_jsx_runtime = require("react/jsx-runtime");
 var REASON_TEXT = {
   not_instrumented: "Not tracked on this site",
   before_cutover: "Not tracked during this period",
-  suppressed: "Withheld by GA4 for privacy",
+  // "Withheld ... for privacy" reads as a legal hold on the reader's own data. What actually
+  // happened is that too few people did the thing for Google to report it.
+  suppressed: "Google hid it: too few people",
   outage: "Not recorded during part of this period",
   source_error: "Source did not respond",
-  not_applicable: "Does not apply to this site",
+  // "Does not apply" reads as a choice someone made. It is not — there is simply nothing here to
+  // compute it from.
+  not_applicable: "Nothing here to work this out from",
   // Its own reason, because it was borrowing not_applicable — so a figure that is temporarily
   // missing rendered "Does not apply to this site. This site's API route predates this figure."
   // Two flatly contradictory sentences, and a hurried reader takes the first: this foundry has no
@@ -463,7 +467,7 @@ function MetricFigure({ metric, label, size = 4, unit = "count" }) {
           metric.note
         ] })
       ] }),
-      /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_sanity_ui_compat.Badge, { tone: "caution", fontSize: 0, children: "Partial" })
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_sanity_ui_compat.Badge, { tone: "caution", fontSize: 0, children: "Some orders only" })
     ] });
   }
   if (metric.status === "estimated") {
@@ -735,7 +739,7 @@ function NoticeList({ notices }) {
   const alwaysShown = notices.slice(0, 2);
   const hidden = notices.slice(2);
   const item = (notice) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)("li", { children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_sanity_ui_compat.Card, { padding: 3, radius: 2, tone: "caution", border: true, children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: noticeRow, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: noticeBadge, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_sanity_ui_compat.Badge, { tone: "caution", fontSize: 0, children: "Caveat" }) }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: noticeBadge, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_sanity_ui_compat.Badge, { tone: "caution", fontSize: 0, children: "Note" }) }),
     /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_sanity_ui_compat.Text, { size: 1, children: notice })
   ] }) }) }, notice);
   return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_sanity_ui_compat.Stack, { space: 2, children: [
@@ -2066,7 +2070,7 @@ function OverviewPanel({ data, previous, onBrush }) {
              */
             ...(data.crossSource ?? []).some((d) => d.vercelPageviews !== null && d.ga4Pageviews !== null) ? [{
               key: "coverage",
-              label: "GA4 coverage",
+              label: "Share GA4 saw",
               source: "GA4",
               complete: true,
               unit: "percent",
@@ -2163,7 +2167,7 @@ function OverviewPanel({ data, previous, onBrush }) {
                * worst. Sorting on it is how a reader dates a collapse.
                */
               key: "coverage",
-              label: "GA4 coverage",
+              label: "Share GA4 saw",
               numeric: true,
               sortValue: (d) => coverageOf(d),
               // The FORMATTED value, matching the cell. Passing the raw ratio through
@@ -2285,16 +2289,21 @@ function Verdict({ data, previous }) {
       parts.push(Math.abs(change) < 5e-3 ? `${label} flat` : `${label} little changed (${change > 0 ? "+" : "\u2212"}${formatPercent(Math.abs(change), 0)})`);
     } else if (unit === "money") {
       parts.push(`${label} ${change > 0 ? "up" : "down"} to ${formatMoney(a, data.currency ?? null)} from ${formatMoney(b, data.currency ?? null)}`);
+    } else if (Math.abs(b) < MIN_DELTA_BASE) {
+      parts.push(`${label} ${formatCount(a)}, was ${formatCount(b)}`);
     } else parts.push(`${label} ${change > 0 ? "up" : "down"} ${formatPercent(Math.abs(change), 0)}`);
   };
   say("Revenue", data.revenue, previous?.revenue, "money");
+  say("Orders", data.orders, previous?.orders, "count");
   say("Traffic", data.vercelPageviews, previous?.vercelPageviews, "count");
   const sends = data.campaigns?.length ?? 0;
   const shortfall = data.shortfallRatio;
   const seeing = shortfall !== null && shortfall !== void 0 ? `GA4 is seeing ${formatPercent(1 - shortfall, 0)} of your traffic` : null;
   const broken = shortfall === null || shortfall === void 0 ? data.capture?.discrepancy ? "measurement disagrees between sources" : null : shortfall > 0.6 ? `${seeing} \u2014 treat its figures as broken` : shortfall > 0.35 ? `${seeing} \u2014 its figures are undercounts, not what happened` : data.capture?.discrepancy ? "measurement disagrees between sources" : null;
   if (broken) parts.push(broken);
-  if (parts.length === 0) return null;
+  if (parts.length === 0) {
+    return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Card, { padding: 3, radius: 2, tone: "transparent", border: true, style: { borderLeftWidth: 3, borderLeftStyle: "solid" }, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Text, { size: 4, children: "No figures arrived for this window." }) });
+  }
   const noticeable = shortfall !== null && shortfall !== void 0 && shortfall > 0.2;
   const closing = broken || !noticeable ? "" : ` \xB7 ${seeing}`;
   return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
@@ -2340,7 +2349,7 @@ function DataHealthPanel({ data, diagnostics }) {
     ((data.capture?.estimates?.length ?? 0) > 0 || data.estimatedSessions?.status === "estimated") && /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_sanity_ui_compat3.Stack, { space: 3, children: [
       /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(SectionTitle, { title: "How much GA4 is seeing" }),
       /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { style: cardGrid, children: (data.capture?.estimates ?? []).map((estimate) => /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Card, { padding: 3, radius: 2, tone: "transparent", border: true, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_sanity_ui_compat3.Stack, { space: 3, children: [
-        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Label, { size: 1, muted: true, children: estimate.basis === "orders" ? "Measured against orders" : estimate.basis === "email" ? "Measured against email clicks" : "Measured against Vercel" }),
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Label, { size: 1, muted: true, children: estimate.basis === "orders" ? "Checked against your orders" : estimate.basis === "email" ? "Checked against email clicks" : "Checked against Vercel" }),
         /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Text, { size: 4, children: formatPercent(estimate.rate, 0) }),
         estimate.rate > 1.05 && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Text, { size: 0, children: "Above 100%: GA4 is counting more than the source it is measured against. That is usually a tag firing twice, not extra traffic." }),
         /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_sanity_ui_compat3.Text, { size: 0, muted: true, children: [
@@ -2444,7 +2453,7 @@ function AcquisitionPanel({ data, previous }) {
         ] })
       ] }) }),
       unattributedShare !== null && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Card, { padding: 3, radius: 2, tone: "transparent", border: true, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_sanity_ui_compat3.Stack, { space: 3, children: [
-        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Label, { size: 1, muted: true, children: "Unattributed" }),
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Label, { size: 1, muted: true, children: "No source" }),
         /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { style: figureRow, children: [
           /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Text, { size: 4, children: formatPercent(unattributedShare, 1) }),
           /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
@@ -2495,7 +2504,7 @@ function AcquisitionPanel({ data, previous }) {
                   }
                 ) : row.source }),
                 row.designIndustry && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Badge, { tone: "primary", fontSize: 0, children: "Design" }),
-                row.unattributed && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Badge, { tone: "caution", fontSize: 0, children: "Unattributed" })
+                row.unattributed && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Badge, { tone: "caution", fontSize: 0, children: "No source" })
               ] })
             },
             {
@@ -2681,7 +2690,7 @@ function JourneyPanel({ data }) {
   const tracked = data.measurement === "sequence";
   return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_sanity_ui_compat3.Stack, { space: 4, children: [
     /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Card, { padding: 3, radius: 2, tone: tracked ? "transparent" : "caution", border: true, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_sanity_ui_compat3.Stack, { space: 2, children: [
-      /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Text, { size: 1, weight: "medium", children: tracked ? "Tracked funnel" : "Independent per-step totals" }),
+      /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Text, { size: 1, weight: "medium", children: tracked ? "Tracked path" : "Not a tracked path" }),
       /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Text, { size: 1, muted: tracked, children: data.approximationNote })
     ] }) }),
     /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(SegmentTable, { segments, dimension: data.segmentDimension ?? "segment" }),
@@ -3081,11 +3090,11 @@ var RANGES = [
 ];
 var GA4_ONLY_TABS = ["acquisition", "journey", "typeface-interest"];
 var PANELS = [
-  { id: "overview", report: "measurement-health", label: "Overview", blurb: "Money, traffic and what moved this period" },
-  { id: "acquisition", report: "acquisition", label: "Acquisition", blurb: "Where visitors come from" },
-  { id: "journey", report: "journey", label: "Journey", blurb: "How far visitors get" },
-  { id: "typeface-interest", report: "typeface-interest", label: "Typeface interest", blurb: "Viewed, tested and bought, by family" },
-  { id: "data-health", report: "measurement-health", label: "Data health", blurb: "Whether to trust what the other tabs are telling you" }
+  { id: "overview", report: "measurement-health", label: "Overview" },
+  { id: "acquisition", report: "acquisition", label: "Acquisition" },
+  { id: "journey", report: "journey", label: "Journey" },
+  { id: "typeface-interest", report: "typeface-interest", label: "Typeface interest" },
+  { id: "data-health", report: "measurement-health", label: "Data health" }
 ];
 function RangeSelector({
   value,
@@ -3491,7 +3500,7 @@ function VisitorInsightsTool(props) {
         /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_sanity_ui_compat4.Heading, { size: 2, children: "Visitor insights" }),
         /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(import_sanity_ui_compat4.Stack, { space: 2, children: [
           /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(RangeSelector, { value: range, custom, onChange: setRange, onCustomChange: setCustom }),
-          /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(BasisSelector, { value: compare, onChange: setCompare })
+          COMPARED_TABS.includes(activePanel) && /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(BasisSelector, { value: compare, onChange: setCompare })
         ] })
       ] }),
       /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(PanelTabs, { value: activePanel, onChange: setActivePanel }),
@@ -3551,25 +3560,22 @@ function VisitorInsightsTool(props) {
           "aria-labelledby": `tab-${activePanel}`,
           tabIndex: 0,
           style: { position: "relative" },
-          children: /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(import_sanity_ui_compat4.Stack, { space: 4, children: [
-            active && /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_sanity_ui_compat4.Text, { size: 1, muted: true, children: active.blurb }),
-            /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(PanelBoundary, { resetKey: `${activePanel}|${range}|${custom.start}|${custom.end}`, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
-              ReportPanel,
-              {
-                tabId: active?.id ?? "overview",
-                report: active?.report ?? "measurement-health",
-                apiBaseUrl,
-                range,
-                custom,
-                compare,
-                onBrush: (start, end) => {
-                  if (range !== "custom") setRangeBeforeBrush(range);
-                  setCustom({ start, end });
-                  setRange("custom");
-                }
+          children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_sanity_ui_compat4.Stack, { space: 4, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(PanelBoundary, { resetKey: `${activePanel}|${range}|${custom.start}|${custom.end}`, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+            ReportPanel,
+            {
+              tabId: active?.id ?? "overview",
+              report: active?.report ?? "measurement-health",
+              apiBaseUrl,
+              range,
+              custom,
+              compare,
+              onBrush: (start, end) => {
+                if (range !== "custom") setRangeBeforeBrush(range);
+                setCustom({ start, end });
+                setRange("custom");
               }
-            ) })
-          ] })
+            }
+          ) }) })
         }
       )
     ] }) })