churnguardianDocs
Getting started

Core concepts

A short glossary of the ideas churnguardian is built on. Skim it once and the rest of the docs will read faster.

Two kinds of churn

Churn is the rate at which you lose revenue or customers. The important split is why a customer left, because each cause needs a different fix.

  • Involuntary churn. The customer wanted to stay but a payment failed. Expired cards, insufficient funds, and bank declines all land here. You fix it with recovery emails and retries.
  • Voluntary churn. The customer decided to leave. You fix it with a better cancel experience, a well-timed offer, and learning the reasons behind it.

Adding both together can hide the real problem, so churnguardian always splits them apart.

Dunning

Dunning is the process of recovering a payment after it fails, or the process of managing quiet hours and reminders. churnguardian runs a short sequence of emails on a schedule:

  • Day 0. A friendly heads-up right after the charge fails, with a one-click card update link.
  • Day 3. A reminder that keeps access top of mind.
  • Day 7. A final notice before the account is paused.

The moment the payment recovers, the sequence stops, so no one gets an email they do not need.

Smart retries

Many failures are temporary. A card can decline because of insufficient funds one day and clear a few days later. churnguardian reads the decline code and retries on a schedule that fits it:

DeclineWhat we do
Insufficient fundsRetry on the next payday, the 1st or 15th.
Soft declinesRetry at 24 hours, 72 hours, then 7 days.
Retryable errorsRetry with exponential backoff.
Hard or fraudDo not retry. The card has to change, so emails take over.

Cancel flows

A cancel flow is a hosted page a customer sees when they try to cancel. It does three things:

  • Asks why they are leaving, so you capture the reason.
  • Shows an offer, such as a discount or a pause, chosen for them.
  • Either applies the offer and keeps the plan active, or lets them confirm the cancellation.

Because the flow lives on its own page, it needs no code on your cancel button. You just redirect the customer there.

Adaptive offers

A static offer gives everyone the same discount. An adaptive offer learns. For every plan and billing interval, churnguardian tests combinations of discount and duration, then serves the ones that save the most customers. This is a form of multi-armed bandit, a small amount of learning that favors what works while still exploring.

To keep the learning honest, a small slice of customers never sees it:

  • The test arm. About 85 percent of customers see the offer chosen by the bandit.
  • The control arm. The other 15 percent always see your fixed offer. Their results are the baseline every adaptive number is measured against.

Why a control group matters

Without a control group, a good month and a good offer look the same. The control arm is what turns a guess into a measured lift.

Measuring recovery

These are the numbers you will see most often:

MetricWhat it means
Recovery rateOf the invoices that failed and were resolved, the share that got paid. Pending ones are excluded until they settle.
Save rateOf the customers who reached a cancel flow, the share who accepted an offer and were still subscribed about a month later.
Saved MRRThe monthly revenue those saved customers represent, at the discounted rate, over the length of the offer.
Value boostHow much better the adaptive offers perform than the fixed control offer, shown once there is enough data to trust it.
Revenue vs logo churnOne measures the money you lost, the other measures the customers. They diverge when customers pay different amounts.