Churned customers

Your churned customers cohort represents all customers that have taken the action that you define as a churn. Creating this cohort enables churn scoring predictions. Additionally, persona predictions can be used to analyze this cohort–to see if a particular persona has a higher churn rate, for example.

In this tutorial, we'll show you how to:

  • Describe your Churned customers group formally using a cohort.

Let's dive in.

  1. You'll need a Faraday account — signup is free!

Confirm your data

Event streams

Unless you’ve already created it for another quickstart or purpose, you’ll need to add the following event stream to your account:

  • Cancellation

What’s an event stream?

Predicting a certain customer behavior requires historical examples of customers exhibiting that behavior. Faraday works best when that data comes in the form of “events” — specific actions or occurrences that happened at specific times.

Formulating data this way helps you define cohorts more expressively.

For example, a Customers cohort could be defined as the group of people who have all experienced a Transaction event at least once.

For more, see our docs on Cohorts, Events, Traits, and Datasets (which define how events and traits emerge from your data).

API via cURL
Dashboard

To verify, use a GET /streams request. Your response should look like this:

[{
  "name": "Cancellation",
  "id": "$CANCELLATION_STREAM_ID"
, ...}]

Make note of the IDs of the necessary streams.

If the required stream isn’t there, follow the instructions using this button, then return here to resume.

Create cohort

Create a churned customers cohort

API via cURL
Dashboard

Use a POST /cohorts request:

curl https://api.faraday.ai/cohorts --json '{
  "name": "Churned customers",
  "stream_name": "cancellation"
}'

Your cohort will start building in the background. You can proceed immediately with the next set of instructions. When your cohort is done building, you’ll get an email.