@koda-sl/baker-cli 0.298.0 → 0.299.0

package/dist/cli.js

@@ -13963,9 +13963,27 @@ var analyticsLandingRowSchema = z28.object({
   /** Sessions that BEGAN here. The honest denominator for this page's rate. */
   entrances: z28.number().int().nonnegative(),
   visitors: z28.number().int().nonnegative(),
+  /**
+   * Conversions that fired ON this landing — rarely the number to show.
+   *
+   * A landing's outcome usually happens somewhere else: the client's checkout,
+   * their shop, a CRM days later. None of those rows carries a landing id, so
+   * this reads 0 for a page whose visits convert reliably.
+   */
   conversions: z28.number().int().nonnegative(),
   /** Visits that converted on this page at least once. */
   convertingSessions: z28.number().int().nonnegative(),
+  /**
+   * Conversions the attribution model credited to this landing — what the page
+   * is bought for, and what {@link conversionRate} is built from.
+   *
+   * Last non-direct click over a 90-day lookback, resolved per person, so it
+   * includes the sale a returning visitor made next week and the deal a CRM
+   * posted with no cookie at all.
+   */
+  creditedConversions: z28.number().int().nonnegative(),
+  /** People whose credited touch arrived here and who then converted. */
+  creditedVisitors: z28.number().int().nonnegative(),
   outboundClicks: z28.number().int().nonnegative(),
   /**
    * Converting visits per entrance. Null when nobody entered here at all.
@@ -14090,9 +14108,25 @@ var analyticsPageRowSchema = z28.object({
   pageViews: z28.number().int().nonnegative(),
   /** Sessions that began on this page — its value as a landing page. */
   entrances: z28.number().int().nonnegative(),
+  /**
+   * Conversions that fired ON this page — "which page converts".
+   *
+   * Almost never the number to put beside Entrances. A landing page's job is to
+   * start a visit that converts, and the conversion is usually somewhere else:
+   * the shop, the checkout, a CRM a week later. Read alone this makes every
+   * landing page of a real funnel report zero.
+   */
   conversions: z28.number().int().nonnegative(),
   /** Visits that converted on this page at least once. */
   convertingSessions: z28.number().int().nonnegative(),
+  /**
+   * Conversions the attribution model credited to this page — last non-direct
+   * click, 90-day lookback, resolved per person. The number a landing-page
+   * table means by "conversions", and the one the rate is built from.
+   */
+  creditedConversions: z28.number().int().nonnegative(),
+  /** People whose credited touch arrived here and who then converted. */
+  creditedVisitors: z28.number().int().nonnegative(),
   /** Converting visits per entrance, 0–1. Null when nobody landed here. */
   conversionRate: z28.number().min(0).max(1).nullable(),
   avgEngagementMs: z28.number().nonnegative().nullable()
@@ -14861,6 +14895,13 @@ var analyticsVisitorRowSchema = z28.object({
   identityHash: z28.string(),
   identityKind: z28.string()
 });
+var analyticsMeasureScopeSchema = z28.object({
+  scope: z28.enum(["campaigns", "outcomes", "all", "unknown"]),
+  /** Every event the tag on the client's own site sent in this window. */
+  websiteEvents: z28.number(),
+  /** Browser ids it minted off-Baker. Any at all means the tag is on `all`. */
+  websiteNewVisitors: z28.number()
+});
 var analyticsQueryDataSchema = z28.object({
   preset: analyticsPresetSchema,
   window: analyticsWindowSchema,
@@ -14877,6 +14918,7 @@ var analyticsQueryDataSchema = z28.object({
   triggers: z28.array(analyticsTriggerRowSchema).optional(),
   releases: z28.array(analyticsReleaseRowSchema).optional(),
   paid: z28.array(analyticsPaidRowSchema).optional(),
+  measureScope: analyticsMeasureScopeSchema.optional(),
   deliveries: z28.array(analyticsDeliveryRowSchema).optional(),
   submissions: z28.array(analyticsSubmissionRowSchema).optional(),
   geo: z28.array(analyticsGeoRowSchema).optional(),
@@ -28894,8 +28936,23 @@ function sessionlessHint(data, origin) {
     "Pages were served but no sessions were counted \u2014 visitors are declining analytics consent, so traffic is measurable and per-visitor behaviour is not. Say so rather than reporting zero visitors."
   ];
 }
+function measureScopeHint(data) {
+  const scope = data.measureScope?.scope;
+  if (scope === "all") {
+    return [
+      "This company's website tag measures EVERY visitor, not only the ones Baker's campaigns brought. So visits, views and conversions here describe the whole business \u2014 organic, email and direct included. Do not report these as what the campaigns produced; use the per-campaign and per-landing credit for that."
+    ];
+  }
+  if (scope === "outcomes") {
+    return [
+      "This company's website tag reports outcomes only, so no browsing on their own site is measured. Visits and views cover Baker pages alone, and a drop-off between a Baker page and a sale is invisible rather than absent."
+    ];
+  }
+  return [];
+}
 function buildAnalyticsHints(data, platform, origin) {
   const hints2 = [];
+  hints2.push(...measureScopeHint(data));
   for (const funnel of data.funnels ?? []) {
     const worst = funnel.worstStep;
     if (worst && worst.dropRate !== null && worst.dropRate >= SEVERE_STEP_DROP) {