Customers

Your customers cohort represents all individuals that have taken the action that defines a customer for you. Creating this cohort enables a variety of predictions, from propensity to repeat purchase for upselling to persona predictions for rich personalization insights.

Interface

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

  • Describe your 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:

  • Transaction

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).

curl

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

[{
  "name": "Transaction",
  "id": "$TRANSACTION_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.

Transaction
→

Create cohort

Create a customers cohort

curl

Use a POST /cohorts request:

curl https://api.faraday.ai/cohorts --json '{
  "name": "Customers",
  "stream_name": "transaction"
}'

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.