Skip to content
QuorlyticTalk to a Data ExpertContact
Menu
Illustration: a laptop on a desk above a night skyline, with account, usage, revenue and storage panels streaming out of its screen.

Industry / SaaS

Product signals into growth decisions.

Data and AI for SaaS connects product usage, billing and revenue data into one governed model, so retention and expansion decisions rest on a shared definition of an active user or account rather than competing dashboards. Quorlytic reconciles usage events to the billing source of truth and segments retention analysis by cohort and acquisition source.

By QuorlyticUpdated

A software business measures itself with two sets of records that disagree by design: what the product observed someone do, and what the contract says they bought. Usage is eventful, anonymous at the edges and versioned by whoever shipped last; billing is periodic, account-shaped and governed by a subscription state machine. This page sets out the lifecycle both describe, and what has to be true before product and revenue decisions can be made from them together.

  • Anonymous joined to known
  • User rolled up to account
  • Events versioned, not renamed
  • Contract state kept separate
  • One account, one identityAnonymous sessions, users and billing accounts reconciled with the join stated
  • Events that survive a renameA versioned event contract, so a shipped change does not silently end a metric
  • Product state ≠ contract stateWhat someone can do and what they are paying for tracked as two different facts
  • Association stated as associationUsage that precedes renewal is a signal, not a demonstrated cause

Lifecycle

The customer lifecycle, and the records underneath it

Eight stages of a customer relationship, and a second structure underneath it. The stages are what the business talks about; the identity, account, event, plan and revenue records are what the data actually has. Most reporting arguments come from treating one as if it were the other.

  1. Acquire

    Someone arrives from a campaign, a search, a referral or a colleague's link. At this point the business has an anonymous identifier and nothing else.

    Data
    Anonymous identifiers, campaign and referrer context, landing and pricing-page events, form submissions.
    Decision
    Where acquisition spend goes, and which source is worth repeating.
  2. Sign up and join identity

    An account is created and the anonymous visitor becomes a known user. Analytics platforms backfill within the session; activity from before the identifier existed is not reprocessed, so the join has a hard boundary.

    Data
    User and account records, authentication identity, anonymous-to-known mapping, invited colleagues.
    Decision
    Which prior activity can honestly be attributed to this account.
  3. Activate

    The user reaches the point where the product has actually done something for them. Activation is a definition the business chooses, and it is worth writing down before it is measured.

    Data
    First-run events, setup and integration completion, first meaningful action, time to that action.
    Decision
    Whether this account has started, and which step is losing people.
  4. Adopt across the account

    Usage spreads from the person who signed up to the team around them. An account is not a user, and a healthy-looking account can be one enthusiast and twenty dormant seats.

    Data
    Per-user and per-seat activity, feature coverage, invitation and acceptance, role distribution.
    Decision
    Where adoption is genuine and where it is concentrated in one person.
  5. Subscribe and bill

    The commercial relationship becomes a subscription with a state machine of its own: trialing, active, past due, paused, cancelled. That state is about payment, not about use.

    Data
    Subscription status and period boundaries, plan and seat counts, invoices, proration on mid-period change.
    Decision
    What the customer is entitled to, and what they owe.
  6. Expand

    Seats, usage or plan tier increase. A mid-period change prorates, which means revenue attributed to a period and product used in that period are computed on different boundaries.

    Data
    Plan changes, seat additions, usage-based charges, proration records, contract amendments.
    Decision
    Where expansion is available, and what triggered the ones that happened.
  7. Renew or churn

    The relationship continues or it ends. By the time the decision is visible in billing, the behaviour that produced it is months old.

    Data
    Renewal and cancellation records, cancellation reason where captured, notice periods, downgrade paths.
    Decision
    Which accounts to intervene with, and how far in advance.
  8. Learn

    Work out which product and commercial changes actually moved anything — which requires a comparison group, not a before-and-after chart.

    Data
    Release and feature-flag history, experiment assignment, cohort definitions, support and complaint records.
    Decision
    What to build next, and what to stop maintaining.

Where it breaks

Where software data estates break

Six failures that appear in software data estates repeatedly. Most of them are identity or versioning problems that only become visible when someone asks a revenue question of product data.

The anonymous-to-known join is assumed rather than stated

Product analytics stitches an anonymous visitor to a user when they sign in, but the rules and the boundary differ per tool — and activity recorded before the identifier existed is generally not reprocessed.

What it costsAcquisition attribution and time-to-activation are computed over a population that silently excludes part of the journey, and two tools give two different answers with no way to reconcile them.

User and account are used interchangeably

Metrics are defined per user, reported per account and sold per seat, with no single place that states how one rolls up to the other — especially where a person belongs to more than one account.

What it costsAdoption looks healthy because one power user is active, retention is computed on the wrong denominator, and account health scores rank the wrong customers.

A shipped rename ends a metric silently

An event is renamed or its properties change in a release, and the dashboard that depended on it keeps rendering — just with a series that stops.

What it costsA trend break is read as a product or market change, and the correction arrives weeks later after someone has already acted on it.

Contract state is treated as product state

Subscription status describes payment, not use. A subscription can be active while invoices are outstanding, and it can be past due while the product is being used normally.

What it costsChurn risk is assessed from billing records that are healthy right up until they are not, and genuine disengagement is invisible until the renewal date.

Internal and test traffic is never excluded

Staff accounts, automated tests, demo tenants and support impersonation all emit the same events as customers, and no flag separates them at source.

What it costsUsage is overstated in exactly the accounts the team looks at most, and any model trained on the mixture learns the company's own behaviour.

Backfills are indistinguishable from behaviour

A pipeline replay or a historical import writes events with the processing date rather than the original event time, or overwrites a period that had already been reported.

What it costsA quiet week becomes a record week, cohort analysis shifts under the reader, and nobody can tell a data operation from a customer action.

Functions

What each software function owns

Software organisations divide by function, and each function trusts a different system. The foundation has to make product, commercial and finance views reconcilable without asking any of them to abandon the tool they run on.

Software business functions, the question each owns, and what answering it requires
FunctionThe question it ownsData it needsAnalyticsDecision
Product managementIs this feature used, by whom, and does it matter?Versioned product events, feature coverage by account and role, release and flag historyAdoption and depth analysis by cohort, funnel analysis, experiment readout where one existsWhat to invest in, change or retire
Growth and acquisitionWhich acquisition sources produce accounts that stay?Anonymous-to-known join, campaign context, signup and activation events, early retentionCohort retention by source, activation funnel analysis, incrementality testing where feasibleWhere acquisition spend goes
Customer successWhich accounts need attention, and how far before renewal?Per-seat activity, feature coverage, support history, contract state and renewal datesEngagement scoring with a stated definition, disengagement detection, intervention trackingWhich accounts a human contacts this week
Revenue and financeWhat did we actually earn, under which arrangement, in which period?Subscription status and period boundaries, invoices, proration, plan and seat historyRecurring revenue movement analysis, reconciliation of billing to product entitlementWhat is reported, and where revenue and usage disagree
Pricing and packagingWhat does each plan actually deliver, and to whom?Entitlements by plan, usage against limits, plan-change history, discountingUsage-to-plan fit analysis, migration impact modelling, limit-breach patternsHow plans are structured and what moves between them
Platform and dataCan these numbers be trusted together?Event contract and schema versions, identity mapping, internal-traffic flags, backfill logContract compliance checks, identity coverage analysis, reconciliation between product and billingWhich measures are safe to publish and which need repair first

Decisions

Four product and revenue decisions, traced end to end

Four decisions traced from the question to the measure. The recurring caveat is the same one every software business has to live with: usage that precedes an outcome is evidence of association, and only a designed comparison turns that into a claim about cause.

Which accounts are genuinely activated?

  1. Question
  2. Data
  3. Analytics
  4. Decision
  5. Measurement

Data required

  • A written activation definition with an owner
  • Versioned product events covering the defining action
  • Per-seat activity rolled up to the account
  • Internal, test and impersonation traffic flagged at source
  • Setup and integration completion records

Analytics

  • Funnel analysis to the defined activation event
  • Per-seat coverage within each account, not account-level aggregates
  • Time-to-activation distribution by cohort and source

Decision

Which accounts have started, which step to fix, and which onboarding cohort needs contact.

Measurement

  • Share of accounts reaching the defined activation event
  • Seat coverage within activated accounts
  • Median and tail of time to activation
  • Proportion of events excluded as internal traffic

What this does not settleActivation is a definition, not a fact. Changing it changes every historical number, so the definition needs a version and an owner before it is used to judge anything — and an account can satisfy it while remaining one enthusiast and twenty dormant seats.

Which usage patterns precede retention or expansion?

  1. Question
  2. Data
  3. Analytics
  4. Decision
  5. Measurement

Data required

  • Per-account usage history at a consistent grain
  • Renewal, expansion and cancellation outcomes with dates
  • Plan and seat change history
  • Cohort definitions fixed before the analysis
  • Support and complaint history

Analytics

  • Cohort comparison between retained and churned accounts
  • Leading-indicator analysis with the observation window fixed in advance
  • Survival-style analysis where the data supports it

Decision

Which behaviours to treat as early signals, and how far ahead they are visible.

Measurement

  • Retention by cohort and acquisition source
  • Lead time between a signal appearing and the outcome
  • Precision of the signal when used as a trigger
  • Share of churned accounts the signal would have caught

What this does not settleAccounts that use a feature and renew may be renewing for reasons that also caused them to use it. Without a deliberate comparison group, this identifies where to look rather than what to change, and a signal tuned on past churn will be optimistic about future churn.

Which accounts need intervention before renewal?

  1. Question
  2. Data
  3. Analytics
  4. Decision
  5. Measurement

Data required

  • Contract state and renewal date from the billing system
  • Product state: authenticated activity by seat over the current period
  • Recent plan or seat changes
  • Support tickets and escalations
  • Named owner for each account

Analytics

  • Comparison of contract state against product state rather than either alone
  • Disengagement detection against the account's own baseline
  • Prioritisation by time remaining before the renewal decision

Decision

Which accounts a person contacts this week, and what the conversation is about.

Measurement

  • Share of at-risk accounts identified before the notice period
  • Interventions attempted against outcomes observed
  • False-positive rate on the risk signal
  • Accounts renewed after intervention, recorded but not claimed as caused by it

What this does not settleSubscription status answers a payment question. An active subscription does not mean every invoice is paid, and a past-due one does not mean the product has stopped being used — so a risk model built on billing alone will be confidently wrong in both directions.

Did that product change move anything?

  1. Question
  2. Data
  3. Analytics
  4. Decision
  5. Measurement

Data required

  • Release and feature-flag history with dates
  • Experiment assignment where an experiment was run
  • A comparison population that did not receive the change
  • Outcome measures defined before the change shipped
  • Concurrent release and campaign calendar

Analytics

  • Comparison against the untreated group rather than against the prior period
  • Pre-registered outcome measures to prevent post-hoc selection
  • Where no experiment is possible, explicit statement of the confound

Decision

Whether to keep, extend, change or retire the thing that shipped.

Measurement

  • Difference against the comparison group
  • Share of releases with a defined outcome measure agreed beforehand
  • Proportion of changes evaluated at all
  • Consistency between methods where more than one was used

What this does not settleMost product changes ship alongside other product changes, a pricing test and a marketing push. A before-and-after chart cannot separate them, and presenting one as an effect is the most common measurement error in software businesses.

Illustrative interface

Account review — product state against contract state

A fictional screen showing the shape of a pre-renewal review. No real company, account, person or figure is represented, and every value here is invented.

Account review — product state against contract state
AccountContract stateProduct stateReview
OK: Account A · 14 seatsActive, renews next periodCore workflow used weekly by most seatsNo action
Watch: Account B · 60 seatsActiveUsage concentrated in two seats since a plan changeInvestigate before renewal
Watch: Account C · 8 seatsPast due — invoice unpaid, access retainedUnchangedBilling issue, not a product issue
Risk: Account D · 25 seatsActiveNo authenticated events for a full billing periodEscalate — contract state is hiding it
  • No action — product and contract state agree
  • Investigate — the two disagree in a way a person should look at
  • Escalate — the contract says healthy and the product says otherwise

Data foundation

The product and revenue data foundation

Software data is unusual in that the business generates nearly all of it and still cannot reconcile it. The systems are internal, the schemas change with every release, and the join between what the product saw and what the contract says is the piece that is almost never owned by anyone.

  1. Source systems

    Nearly all internal, and still hard to reconcile. The ten systems are enumerated in the inventory below.

    • Product event stream
    • Application and identity stores
    • Billing and subscriptions
    • CRM, support and marketing
  2. Ingestion

    Replay preserves event time rather than rewriting a reported period

    • Event collection with schema validation at the edge
    • Change data capture from the application store
    • Billing and CRM extracts
    • Backfills recorded as operations
  3. Cloud platform

    One place product and commercial history meet

    • Raw landing with original event time
    • Validated and versioned event models
    • Account, subscription and revenue models
  4. Identity & rollup

    Four hops, each one measured for coverage

    • Anonymous identifier to user
    • User to account, including multi-account people
    • Account to subscription
    • Internal, test and impersonation traffic flagged
  5. Contracts & quality

    A rename fails a build instead of ending a chart

    • Declared event schema and version
    • Compatibility rules and deprecation windows
    • Join coverage published with the numbers
    • Lineage from metric back to event
  6. Product & revenue models

    Defined once, reconciled between product and finance

    • Activation and adoption
    • Retention and expansion by cohort
    • Recurring revenue movement
    • Entitlement against usage
  7. Decision surfaces

    Where product, growth and success teams work

    • Adoption and funnel analysis
    • Account review: product state against contract state
    • Renewal risk queues
    • Experiment readouts
  8. Action

    A decision with an owner and a recorded outcome

    • Onboarding and product changes
    • Account intervention
    • Packaging and plan changes
    • Keep, change or retire what shipped
Reference architecture — a target-state shape, not a description of a client engagement.

The join that matters most is the cheapest one to neglect: anonymous identifier to user, user to account, account to subscription, subscription to revenue. Each hop loses some population, and the loss is not random — it concentrates in exactly the self-serve and multi-account customers that growth teams care about. State the join, measure its coverage, and publish that coverage next to any number computed across it. The semantic-model and metric-governance guide explains how to carry those account-grain definitions into shared reporting, so a product activation measure and a finance revenue measure retain their distinct denominators.

10 source systems, and what to check before trusting each
  • Product event stream

    User and account actions, feature usage, client and version context

    Check before trustingSchema changes ship with releases; an unversioned rename ends a series without an error

  • Application database

    Accounts, users, entitlements, configuration, current state

    Check before trustingHolds state, not history — yesterday's plan is frequently unrecoverable from it

  • Identity and authentication

    Login identity, session records, SSO and directory mapping, roles

    Check before trustingThe authoritative user record; one person may map to several accounts and several identities

  • Billing and subscriptions

    Subscription status, period boundaries, invoices, plan and seat changes, proration

    Check before trustingStatus describes payment rather than use; period boundaries rarely align with product reporting periods

  • CRM

    Opportunities, contract terms, renewal dates, account ownership

    Check before trustingMaintained by people under quota pressure, so timeliness and completeness vary by stage

  • Support platform

    Tickets, severity, resolution, contact history

    Check before trustingContact identity is often an email address that matches no user record

  • Marketing automation

    Campaign exposure, email engagement, lead records

    Check before trustingIts account concept is usually a lead or a domain, not the billing account

  • Feature flags and experiments

    Flag state by account and user, experiment assignment, rollout history

    Check before trustingThe only reliable record of who actually received a change; frequently retained for weeks, not years

  • Warehouse or lakehouse

    Modelled and reconciled history across all of the above

    Check before trustingBackfills must preserve event time; a replay written at processing time rewrites history

  • Contract and entitlement reference

    What each plan grants, limits, and how migrations map

    Check before trustingEntitlement drift between what is sold, what is configured and what the product enforces

Analytics & AI

From an event contract to evidence, in dependency order

The same dependency chain as elsewhere, with a software-specific first rung: the event contract. Everything above it inherits whatever the instrumentation did or did not record, and no modelling recovers an event that was never emitted.

  1. A trusted event contract

    Events that are named, versioned, owned and tested, so a release cannot silently end a metric. This is instrumentation work, not analytics work, and it is the rung most often skipped.

    RequiresA declared event schema with compatibility rules, and a check that fails a build rather than a dashboard

  2. Reconciled identity

    Anonymous to user, user to account, account to subscription — each hop stated, measured for coverage, and published with the number that depends on it.

    RequiresOne authoritative user record, an account roll-up rule, and internal traffic flagged at source

  3. Agreed product and revenue reporting

    Adoption, retention and recurring revenue movement defined once, reconciled between product and finance, with period boundaries stated.

    RequiresDefinitions with named owners, and an agreed treatment of proration and mid-period change

  4. Diagnosis

    Explaining a movement: which cohort, which plan, which release, and how much of it is a data artefact such as a backfill or a flag rollout.

    RequiresRelease and flag history joined to usage, and backfills recorded as operations rather than behaviour

  5. Prediction and prioritisation

    Scoring accounts for risk or expansion potential, with the observation window fixed in advance and the score expressed as a prioritisation rather than a verdict.

    RequiresOutcome history at account grain, a fixed window, and a named owner for each triggered action

  6. Experimentation as the default

    Changes shipped with a comparison group and an outcome measure agreed beforehand, so the business can say what worked rather than what happened.

    RequiresAssignment recorded and retained, pre-registered measures, and the discipline to report a null result

Maturity

A maturity progression, with readiness tests

Progress here is usually blocked by instrumentation rather than by modelling. The readiness test for each stage is something you can check in an afternoon.

  1. Counting

    Product, billing and marketing each report their own numbers, and the three do not agree in any meeting.

    Ready for the next stage whenOne authoritative user and account record exists, and internal traffic is flagged at source.

  2. A contract for events

    Events are named, versioned and owned; a rename fails a check instead of ending a chart.

    Ready for the next stage whenThe event schema is declared, compatibility rules are stated, and a breach fails a build.

  3. Reconciled product and revenue

    Adoption, retention and revenue movement are defined once and reconcile between product and finance.

    Ready for the next stage whenIdentity join coverage is measured and published alongside the numbers that depend on it.

  4. Prioritised action

    Risk and expansion signals route to a named owner with a recorded intervention and outcome.

    Ready for the next stage whenObservation windows are fixed in advance and false-positive rates are tracked rather than assumed.

  5. Evidence by default

    Product and commercial changes ship with a comparison group and a pre-agreed outcome measure.

    Ready for the next stage whenAssignment is retained, null results are reported, and post-hoc measure selection is treated as a defect.

Measurement

What a software business should measure

A measurement framework for the decisions above. Software metrics are unusually easy to compute and unusually easy to compute differently, so each one needs a definition owner before it is compared across teams.

Software business measures, what each one captures, and the decision it informs
MeasureWhat it capturesDecision it informs
Activation rateShare of new accounts reaching a defined first meaningful actionWhich onboarding step to fix
Time to activationElapsed time to that action, read as a distribution with its tailWhere onboarding friction actually sits
Seat coverage within accountsProportion of purchased seats showing regular authenticated activityWhether adoption is genuine or concentrated in one person
Feature adoption depthHow many of the capabilities an account pays for are actually usedPackaging, onboarding focus and what to retire
Gross and net revenue retentionRevenue kept from an existing cohort, before and after expansionWhether growth is coming from keeping customers or replacing them
Logo retention by cohortAccounts retained, by the period they were acquired inWhich acquisition sources produce durable customers
Expansion rateShare of accounts adding seats, usage or tier in a periodWhere packaging is meeting demand
Identity join coverageProportion of events and accounts successfully joined across each identity hopHow much to trust any cross-system number
Event contract complianceShare of emitted events conforming to the declared schema and versionWhether instrumentation is safe to build reporting on
Share of changes evaluatedProportion of shipped changes with a comparison group and a pre-agreed measureWhether the organisation can say what worked

These are common software measures and their usual reading, not results Quorlytic has produced for a client. Definitions vary between organisations — particularly for activation, an active account and the treatment of proration — which is why each needs an owner and a version before it is compared.

Principles

Principles we work to

The 5 principles this work is built on
  1. 01

    Agree what growth means

    Active user, seat, account and revenue can each be counted several ways. Define the metric, its grain and its owner before building retention or expansion views. A single semantic model prevents the same customer being counted differently by two teams.

  2. 02

    Connect product to revenue

    Usage events and billing records arrive on different clocks. Model them with clear identity and time handling, and reconcile to the billing source of truth. Preserve trial, upgrade, downgrade and churn context so movement can be explained.

  3. 03

    Make retention analysis honest

    Compare against a baseline and segment by cohort, plan and acquisition source. Expose where data is sparse or confounded. Avoid presenting a single retention figure without the definitions and filters behind it.

    • Usage, retention and expansion analytics
    • Reconciled product and revenue models
    • Churn and cohort decision support
  4. 04

    Start with one growth question

    Choose a decision such as which accounts need attention, define the acceptance metric and identify the owner. Expand the model only after the first output is used.

  5. 05

    Product analytics needs an event contract

    Product analysis is only reproducible when events are governed: a stable name, the properties that travel with them, the identity that connects them to an account, and a version for every change. Without that contract, usage numbers drift silently and every retention debate becomes an argument about instrumentation rather than customers.

    • Event names, properties and owners recorded in one place
    • Identity keys defined before funnels or cohorts are built
    • Breaking event changes versioned and announced to consumers

Engagement

How an engagement can progress

A typical engagement can progress through these stages. It is a sequence rather than a proprietary method, and in software the instrumentation stage is the one most often underestimated because the data appears to exist already.

  1. Discover

    OutputAn inventory of the product and commercial decisions in scope, and who owns each one

  2. Map identity

    OutputA documented picture of the anonymous-to-user-to-account-to-subscription joins, with measured coverage at each hop

  3. Audit instrumentation

    OutputAn event inventory: what is emitted, what is versioned, what is missing and what is internal traffic

  4. Define the measures

    OutputActivation, active account, retention and revenue movement defined once, with owners and versions

  5. Design the architecture

    OutputA target-state design covering event contracts, identity resolution and product-to-billing reconciliation

  6. Build the foundation

    OutputPipelines, contract checks that fail a build, identity resolution and the reconciled models

  7. Build the decision layer

    OutputThe adoption, risk or revenue analysis the decision requires, with its observation window fixed

  8. Operationalise and measure

    OutputMonitoring, named ownership, an evaluation habit for shipped changes, and the next decision prioritised

Where this connects

Capabilities that support these decisions

Further reading, chosen for this lifecycle

Questions

Questions worth asking.

Should we buy a product-analytics tool first?

Assess the decision and the required definitions first. A dedicated tool may help collection and exploration, but a governed model is still needed where product and revenue measures must agree.

Your next data decision

Start with a clear problem.
Build what comes next.

Talk to a Data Expert

Bring the business question.
We'll help shape the engineering brief.