Churn scores in Salesforce

Why use predictions for churn scores?

Knowing which of your customers is most likely to churn gives you the opportunity to act before they make that critical decision.

The most effective way to predict likelihood to churn is with machine learning. With machine learning, you can constantly keep your list of customers up-to-date with churn scores based on the historical data of similar shoppers, and plug your likely-to-churn customers right back into your stack, no PhD required. With churn scores in your stack, you're primed to jump in, offer a discount, a helping hand, or some other offer to keep them on board.

Faraday makes predicting churn scores for your customers intuitive & easy, and delivering them to any channel in your stack a breeze.

With churn score predictions in Salesforce, you’ll give your team valuable insight to intervene before the customer makes that critical decision, exactly where and when they need it.

Follow the steps below to get your churn scores predictions into your Salesforce account.

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

  • Organize your customer data into cohorts
  • Describe predictive models for churn scores with outcomes
  • Deploy churn scores predictions to Salesforce using Pipelines

Getting started with churn scores in Salesforce

Make sure you have a Faraday account (signup is free!) and that it's not in test mode.

Requirements for this churn scores recipe

You'll need the following cohorts available in your Faraday account:

Screenshot of the cohorts listing that includes Customers and Churned customers

Building predictions for churn scores in Salesforce

Now you'll create the prediction objective(s) necessary to complete this use case with Faraday.

Describe your churn scores predictions with outcomes

Outcomes use machine learning to predict whether or not people will exhibit a certain behavior.

Creating an outcome for likelihood to churn.

Let's make an outcome for likelihood to churn.

  • In the navigation sidebar, choose Outcomes. Screenshot of the outcomes list
  • Click the New outcome button.
  • Fill out the form:
    • For Eligibility cohort, pick the cohort that best represents your customers.
    • For Attainment cohort, pick the cohort that best represents your churned customers.
    • Leave Attrition cohort blank.
    • Skip over Trait blocking.
    • Enter a memorable name, like "Likelihood to churn". Screenshot of the new outcome form, filled out
  • Click the Save outcome button.

Faraday will do some magic in the background, so you can proceed with the rest of the instructions. When your outcome is done building, you'll get an email, and you can review your outcome.

Using Pipelines to deploy predictions to your stack

Now you'll configure the pipeline that deploys your predictions to salesforce.

Create your pipeline for churn scores in Salesforce

  • In the navigation sidebar, choose Pipelines. Screenshot of the pipelines list
  • Click the New Pipeline button.
  • Fill out the form:
    • For Payload, choose the following:
      • Outcome: Likelihood to churn
    • For Population to include, choose the following:
      • A cohort representing your customers
    • Enter a memorable name, like "Churn scores in Salesforce". Screenshot of the new pipeline form, filled out
  • Click the Save pipeline button.

Your pipeline will start building in the background. You can proceed immediately with the next set of instructions.

Deploying your pipeline to Salesforce


  • In the Deployment area, find the CSV module and click Add. Screenshot of the ready pipeline with no targets yet
  • Fill out the popup:
    • Choose the Identified option.

    • Choose Human friendly column headers.

  • Click the Next button. Screenshot of the new target form, filled out
  • Expand the Structure section of Advanced Settings
    • From the dropdown, select the salesforce preset. Screenshot of the second page of the new target form, filled out
  • Click the Finish button.
  • Click the Test deployment button and confirm the results meet your expectations. Screenshot of a target after hitting its test button the first time Faraday will finish building your pipeline in the background. When it's done, you'll get an email—return to the pipeline and click the Enable pipeline button to activate it.

How to use your churn scores predictions in Salesforce

With your pipeline deployed, it's time to plug your churn scores into Salesforce. Follow the steps below to see each Salesforce contact enriched with their likelihood to churn.

Creating a Salesforce Contact Field

First, we're going to create a Salesforce Contact Field for our churn scores so that we can assign them to our contacts appropriately.

  1. Navigate to the Fields & Relationships tab under Contact in Salesforce Object Manager.
  2. Click New in the upper right to create a new field.
  3. Select the number bubble, then click next.
  4. Name the field something unique like "Churn score." Feel free to leave the character length limit as the default 18.

new custom field

  1. Click next, then choose the appropriate permissions required per your company's guidelines for which Salesforce users can view the churn score field–then click next again.
  2. Finally, choose which page layouts you'd like the churn score field to display on. We recommend including any layout that is used by your team. Click save to finish creating the custom field.

Importing your churn scores CSV into Salesforce

Now that the custom field for churn score is created, let's upload the CSV output from your pipeline.

  1. In your Faraday pipeline, click the Download CSV button under the deployment to download your churn scores as a CSV.
  2. Navigate to Salesforce's Data Import Wizard and select Accounts and Contacts.
  3. Select Update existing records, and ensure you're matching records by Email.

update existing records

  1. Select CSV in the right pane, choose the CSV you just downloaded from your deployment, then click next.
  2. In the mapping step, map your contact fields appropriately, and select the churn score contact field you created to map to the row for the churn score. See the bottom row's "2, 69, 87" example below where each value is a score. The second-to-last row–the raw score–can be safely left unmapped and ignored.

mapping data

For churn scores, the higher the score, the more likely it is that the customer is going to churn.

  1. Click next and review your mappings.
  2. Click Start Import to begin the import. When the import is complete, your contact cards will be populated with your Faraday churn scores, and you're ready to kick off campaigns to intervene just in time to keep your customers on board.

🔒 It's a best practice to permanently delete any file that contains personally identifiable information (PII) after use. Any deployment from Faraday that is unhashed contains PII, and should be deleted after uploading it to your destination for security purposes.