Using Predictive Audiences

You can create predictive audiences in the mParticle UI.

Note that you may see the name “Vidora” instead of Cortex in some documentation and UI screens.


  1. If you haven’t yet, set up a Cortex event output.
  2. Set up a Cortex feed input.
  3. Once the live integration has been configured and verified, reach out to your Customer Success Manager (CSM) in order to initiate a replay of historical data. Providing historical events enables Cortex to start building ML pipelines right away rather than waiting for a sufficient volume of data to be gathered through the live integration.

Create a predictive audience

To create and activate a predictive audience:

  1. In mParticle, navigate to Audiences > Real-time and click New Audience.
  2. Enter your information in the New Audience form and click Create.
  3. In the Build tab, click Add Criteria to display a list of items: criteria builder showing user prediction choice
  4. If you haven’t already created a user prediction, click User Prediction from the list and enter the User Prediction information: user prediction definition

    If you’ve already created a user prediction, select it from the list in Users > Choose User Feature > User Attributes.

  5. Click Create prediction.
  6. mParticle displays the audience definition, where you can see that two user predictions have been created, one for score and one for percentile. Choose one.
  7. Specify the threshold. For example, if you wanted a likelihood of greater than 90 percent, you’d set the following values: audience definition form
  8. Click Done.
  9. Choose either Save as Draft or Activate.
  10. Once you choose Activate, mparticle prompts you to optionally create an A/B test, and then connect to an output.

After you create a prediction, a pipeline is created in Cortex, and the pipeline begins calculating. Calculation may take up to 24 hours, though typically the delay is about an hour.

If there’s not enough data to learn from, the calculation may fail and the prediction won’t exist, resulting in an empty audience. To correct this, choose different criteria or troubleshoot your data for issues.

To check on the status of your pipeline, view it in Cortex.

Was this page helpful?