{"componentChunkName":"component---src-templates-markdown-template-jsx","path":"/guides/audiences/predictive-audiences/using-predictive-audiences/","result":{"data":{"pageMetadata":{"title":"Using Predictive Audiences","path":"/guides/audiences/predictive-audiences/using-predictive-audiences/","sourceCode":null,"metadataParent":{"title":"Predictive Audiences","path":"/guides/audiences/predictive-audiences/","sourceCode":null,"hasVersionPicker":null,"metadataChildren":[{"title":"Predictive Audiences Overview","path":"/guides/audiences/predictive-audiences/overview/","order":6.1,"label":null},{"title":"Using Predictive Audiences","path":"/guides/audiences/predictive-audiences/using-predictive-audiences/","order":6.2,"label":null}],"metadataParent":{"title":"Audiences","path":"/guides/audiences/","metadataChildren":[{"title":"Audiences Overview","path":"/guides/audiences/overview/","order":1,"label":null},{"title":"Create an Audience","path":"/guides/audiences/create-an-audience/","order":2,"label":null},{"title":"Connect an Audience","path":"/guides/audiences/connect-an-audience/","order":3,"label":null},{"title":"Manage Audiences","path":"/guides/audiences/manage-audiences/","order":4,"label":null},{"title":"Audience Insights","path":"/guides/audiences/audience-insights/","order":5,"label":null},{"title":"Audience Sharing","path":"/guides/audiences/audience-sharing/","order":6,"label":null},{"title":"Match Boost","path":"/guides/audiences/match-boost/","order":7,"label":null},{"title":"Inclusive & Exclusive Audiences (Early Access)","path":"/guides/audiences/early-access/","order":8,"label":null},{"title":"Audience Expansion","path":"/guides/audiences/audience-expansion/","order":8,"label":null},{"title":"Predictive Audiences","path":"/guides/audiences/predictive-audiences/","order":10,"label":null},{"title":"Composable Audiences","path":"/guides/audiences/composable-audiences/","order":11,"label":null}],"metadataParent":{"title":"Guides","path":"/guides/","metadataChildren":[{"title":"Platform Overview","path":"/guides/platform-overview/","order":0.5,"label":null},{"title":"Getting Started","path":"/guides/getting-started/","order":1,"label":null},{"title":"mParticle Agent","path":"/guides/mparticle-agent/","order":1.5,"label":null},{"title":"Oversight","path":"/guides/oversight/","order":2,"label":null},{"title":"Data Platform","path":"/guides/data-platform/","order":3,"label":null},{"title":"Data Warehouse","path":"/guides/data-warehouse/","order":4,"label":null},{"title":"Customer 360","path":"/guides/customer-360/","order":5,"label":null},{"title":"Analytics","path":"/guides/analytics/","order":6,"label":null},{"title":"Audiences","path":"/guides/audiences/","order":7,"label":null},{"title":"Settings","path":"/guides/settings/","order":8,"label":null},{"title":"Troubleshooting mParticle","path":"/guides/troubleshooting/","order":10,"label":null},{"title":"Default Service Limits","path":"/guides/default-service-limits/","order":11,"label":null},{"title":"Glossary","path":"/guides/glossary/","order":12,"label":null}],"metadataParent":null}}}},"markdownRemark":{"html":"<p>Predictive audiences are dynamic user groups in mParticle that use machine learning to forecast future behaviors—such as the likelihood of making a purchase—based on historical event data. Instead of relying only on past actions, they assign each user a probability score and percentile ranking, allowing you to target audiences most likely to perform a desired action.</p>\n<p>You can create predictive audiences in <strong>Audiences</strong>.</p>\n<h2 id=\"prerequisites\" style=\"position:relative;\"><a href=\"#prerequisites\" aria-label=\"prerequisites permalink\" class=\"anchor before\"><svg width=\"16px\" height=\"17px\" viewBox=\"0 0 16 17\" version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\">\n                <g id=\"Symbols\" stroke=\"none\" stroke-width=\"1\" fill=\"none\" fill-rule=\"evenodd\">\n                    <g id=\"Icon/Link\" fill=\"#98A0A3\" fill-rule=\"nonzero\">\n                        <g id=\"link\">\n                            <path d=\"M9.5,12.4 C9.6,12.4 9.7,12.4 9.9,12.4 C9.8,12.5 9.8,12.5 9.7,12.6 L7.5,14.8 C5.8,16.5 3,16.5 1.3,14.8 C-0.4,13.1 -0.4,10.3 1.3,8.6 L3.5,6.4 C3.6,6.3 3.6,6.3 3.7,6.2 C5,5 6.9,4.8 8.4,5.5 C8.8,5.7 9.3,6 9.6,6.4 C10,6.7 10.2,7.2 10.5,7.6 C10.2,7.9 9.9,8 9.5,8 C9.4,8 9.2,8 9.1,7.9 C8.9,7.5 8.5,7.2 8.1,6.9 C7,6.2 5.5,6.4 4.5,7.3 L3.8,8 L2.3,9.5 C1.2,10.6 1.2,12.5 2.3,13.6 C3.4,14.7 5.3,14.7 6.4,13.6 L7.9,12.1 C8.4,12.3 8.9,12.4 9.5,12.4 Z M14.7,1.3 C13,-0.4 10.2,-0.4 8.5,1.3 L6.3,3.5 C6.2,3.6 6.2,3.6 6.1,3.7 C6.7,3.7 7.4,3.7 8,3.9 L9.5,2.4 C10.6,1.3 12.5,1.3 13.6,2.4 C14.7,3.5 14.7,5.4 13.6,6.5 L12.1,8 L11.4,8.7 C10.4,9.7 8.9,9.8 7.8,9.1 C7.4,8.9 7.1,8.5 6.8,8.1 C6.7,8.1 6.5,8 6.4,8 C6,8 5.6,8.2 5.4,8.4 C5.6,8.8 5.9,9.3 6.3,9.6 C6.6,10 7.1,10.2 7.5,10.5 C9,11.2 10.9,11 12.3,9.8 C12.4,9.7 12.4,9.7 12.5,9.6 L14.7,7.4 C16.4,5.7 16.4,3 14.7,1.3 Z\" id=\"Shape\"></path>\n                        </g>\n                    </g>\n                </g>\n            </svg></a>Prerequisites</h2>\n<p>Before creating a prediction, your workspace must meet the <a href=\"/guides/customer-360/predictions/overview/#predictions-setup-requirements\">Predictions setup requirements</a>: product access enabled, the required Predictions event output and feed input configured, schema synchronization and setup verification completed, and at least 45 days of usable historical data. For more reliable results, 90 or more days of historical data is recommended when available.</p>\n<p>If setup is incomplete or you don’t have enough historical data, prediction creation isn’t available yet. Continue collecting data through the live integration or contact your mParticle account representative to discuss whether historical replay or setup support is available for your account. A replay must supply enough usable historical data before you can create a prediction.</p>\n<p>For connection setup instructions, see <a href=\"/integrations/cortex/event/#enable-live-event-forwarding-from-mparticle-to-cortex\">Cortex event output</a> and <a href=\"/integrations/cortex/feed/#enable-attributes-to-be-ingested-from-predictions-to-mparticle\">Cortex feed input</a>.</p>\n<h2 id=\"create-a-predictive-audience\" style=\"position:relative;\"><a href=\"#create-a-predictive-audience\" aria-label=\"create a predictive audience permalink\" class=\"anchor before\"><svg width=\"16px\" height=\"17px\" viewBox=\"0 0 16 17\" version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\">\n                <g id=\"Symbols\" stroke=\"none\" stroke-width=\"1\" fill=\"none\" fill-rule=\"evenodd\">\n                    <g id=\"Icon/Link\" fill=\"#98A0A3\" fill-rule=\"nonzero\">\n                        <g id=\"link\">\n                            <path d=\"M9.5,12.4 C9.6,12.4 9.7,12.4 9.9,12.4 C9.8,12.5 9.8,12.5 9.7,12.6 L7.5,14.8 C5.8,16.5 3,16.5 1.3,14.8 C-0.4,13.1 -0.4,10.3 1.3,8.6 L3.5,6.4 C3.6,6.3 3.6,6.3 3.7,6.2 C5,5 6.9,4.8 8.4,5.5 C8.8,5.7 9.3,6 9.6,6.4 C10,6.7 10.2,7.2 10.5,7.6 C10.2,7.9 9.9,8 9.5,8 C9.4,8 9.2,8 9.1,7.9 C8.9,7.5 8.5,7.2 8.1,6.9 C7,6.2 5.5,6.4 4.5,7.3 L3.8,8 L2.3,9.5 C1.2,10.6 1.2,12.5 2.3,13.6 C3.4,14.7 5.3,14.7 6.4,13.6 L7.9,12.1 C8.4,12.3 8.9,12.4 9.5,12.4 Z M14.7,1.3 C13,-0.4 10.2,-0.4 8.5,1.3 L6.3,3.5 C6.2,3.6 6.2,3.6 6.1,3.7 C6.7,3.7 7.4,3.7 8,3.9 L9.5,2.4 C10.6,1.3 12.5,1.3 13.6,2.4 C14.7,3.5 14.7,5.4 13.6,6.5 L12.1,8 L11.4,8.7 C10.4,9.7 8.9,9.8 7.8,9.1 C7.4,8.9 7.1,8.5 6.8,8.1 C6.7,8.1 6.5,8 6.4,8 C6,8 5.6,8.2 5.4,8.4 C5.6,8.8 5.9,9.3 6.3,9.6 C6.6,10 7.1,10.2 7.5,10.5 C9,11.2 10.9,11 12.3,9.8 C12.4,9.7 12.4,9.7 12.5,9.6 L14.7,7.4 C16.4,5.7 16.4,3 14.7,1.3 Z\" id=\"Shape\"></path>\n                        </g>\n                    </g>\n                </g>\n            </svg></a>Create a predictive audience</h2>\n<p>To create a predictive audience:</p>\n<ol>\n<li>Select <strong>Audiences</strong> in the left-hand navigation and click <strong>New Audience</strong>.</li>\n<li>In <strong>Create Audience</strong>, under <strong>Start from scratch</strong>, open <strong>Select Audience Source</strong> and select <strong>Platform</strong> under <strong>In-Platform Audience</strong>.</li>\n<li>Click <strong>Next</strong>.</li>\n<li>In <strong>Create Audience Group</strong>, enter an <strong>Audience Name</strong> and select the data inputs under <strong>Audience Group Inputs</strong>.</li>\n<li>Click <strong>Create</strong>.</li>\n<li>In the Audience Builder, click <strong>Add Criteria</strong> to display a list of criteria types, and select <strong>User Prediction</strong>.</li>\n<li>\n<p>If you haven’t already created a user prediction, click <strong>User Prediction</strong> from the list of criteria types and enter the User Prediction criteria before clicking <strong>Create Prediction.</strong></p>\n<p><img src=\"/images/audiences/using-predictive-audiences-1.png\" alt=\"user prediction definition\"></p>\n<p>If you’ve already created a user prediction:</p>\n<ul>\n<li>Click the <strong>Users</strong> criteria type.</li>\n<li>Click the <strong>Choose User Feature</strong> dropdown menu. </li>\n<li>Select <strong>User Attributes</strong>.</li>\n<li>Use the <strong>- Pick type -</strong> dropdown menu to select your predictive attribute.</li>\n</ul>\n</li>\n<li>After selecting or creating a new predictive attribute, enter your desired thresholds that must be met for each predictive attribute in order for a user to be added to your audience.</li>\n<li>Click <strong>Done</strong>.</li>\n<li>Choose either <strong>Save as Draft</strong> or <strong>Activate</strong>.</li>\n</ol>\n<p>After creating a predictive audience, a pipeline is created within Cortex, and the pipeline begins calculating. Calculation may take up to 24 hours, though typically the delay is about an hour. </p>\n<p>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.</p>\n<p>To check on the status of your pipeline, view it in Cortex.</p>\n<h2 id=\"include-and-exclude-users-from-predictions\" style=\"position:relative;\"><a href=\"#include-and-exclude-users-from-predictions\" aria-label=\"include and exclude users from predictions permalink\" class=\"anchor before\"><svg width=\"16px\" height=\"17px\" viewBox=\"0 0 16 17\" version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\">\n                <g id=\"Symbols\" stroke=\"none\" stroke-width=\"1\" fill=\"none\" fill-rule=\"evenodd\">\n                    <g id=\"Icon/Link\" fill=\"#98A0A3\" fill-rule=\"nonzero\">\n                        <g id=\"link\">\n                            <path d=\"M9.5,12.4 C9.6,12.4 9.7,12.4 9.9,12.4 C9.8,12.5 9.8,12.5 9.7,12.6 L7.5,14.8 C5.8,16.5 3,16.5 1.3,14.8 C-0.4,13.1 -0.4,10.3 1.3,8.6 L3.5,6.4 C3.6,6.3 3.6,6.3 3.7,6.2 C5,5 6.9,4.8 8.4,5.5 C8.8,5.7 9.3,6 9.6,6.4 C10,6.7 10.2,7.2 10.5,7.6 C10.2,7.9 9.9,8 9.5,8 C9.4,8 9.2,8 9.1,7.9 C8.9,7.5 8.5,7.2 8.1,6.9 C7,6.2 5.5,6.4 4.5,7.3 L3.8,8 L2.3,9.5 C1.2,10.6 1.2,12.5 2.3,13.6 C3.4,14.7 5.3,14.7 6.4,13.6 L7.9,12.1 C8.4,12.3 8.9,12.4 9.5,12.4 Z M14.7,1.3 C13,-0.4 10.2,-0.4 8.5,1.3 L6.3,3.5 C6.2,3.6 6.2,3.6 6.1,3.7 C6.7,3.7 7.4,3.7 8,3.9 L9.5,2.4 C10.6,1.3 12.5,1.3 13.6,2.4 C14.7,3.5 14.7,5.4 13.6,6.5 L12.1,8 L11.4,8.7 C10.4,9.7 8.9,9.8 7.8,9.1 C7.4,8.9 7.1,8.5 6.8,8.1 C6.7,8.1 6.5,8 6.4,8 C6,8 5.6,8.2 5.4,8.4 C5.6,8.8 5.9,9.3 6.3,9.6 C6.6,10 7.1,10.2 7.5,10.5 C9,11.2 10.9,11 12.3,9.8 C12.4,9.7 12.4,9.7 12.5,9.6 L14.7,7.4 C16.4,5.7 16.4,3 14.7,1.3 Z\" id=\"Shape\"></path>\n                        </g>\n                    </g>\n                </g>\n            </svg></a>Include and exclude users from predictions</h2>\n<p>When setting criteria for a new user prediction, you can specify whether Cortex should generate that prediction for all users or a specific subset. Narrowing predictions to a subset of users can help improve the accuracy of your predictions, and avoid generating predictive attributes for users who are not relevant to a specific use case. </p>\n<p>To focus on a subset of users, select the option <strong>A subset of users</strong> in the <strong>Make predictions for</strong> field.  </p>\n<p><img src=\"/images/guides/personalization/predictive-audiences/using-predictive-audiences/select-user-subset.png\" alt=\"Select user subset\"></p>\n<p>Once you’ve selected this option, you can build queries with user attributes and behavioral events to select the users for whom Cortex will generate this prediction.</p>\n<p><img src=\"/images/guides/personalization/predictive-audiences/using-predictive-audiences/set-user-criteria.png\" alt=\"Set user criteria\"></p>\n<h3 id=\"why-include-or-exclude-users\" style=\"position:relative;\"><a href=\"#why-include-or-exclude-users\" aria-label=\"why include or exclude users permalink\" class=\"anchor before\"><svg width=\"16px\" height=\"17px\" viewBox=\"0 0 16 17\" version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\">\n                <g id=\"Symbols\" stroke=\"none\" stroke-width=\"1\" fill=\"none\" fill-rule=\"evenodd\">\n                    <g id=\"Icon/Link\" fill=\"#98A0A3\" fill-rule=\"nonzero\">\n                        <g id=\"link\">\n                            <path d=\"M9.5,12.4 C9.6,12.4 9.7,12.4 9.9,12.4 C9.8,12.5 9.8,12.5 9.7,12.6 L7.5,14.8 C5.8,16.5 3,16.5 1.3,14.8 C-0.4,13.1 -0.4,10.3 1.3,8.6 L3.5,6.4 C3.6,6.3 3.6,6.3 3.7,6.2 C5,5 6.9,4.8 8.4,5.5 C8.8,5.7 9.3,6 9.6,6.4 C10,6.7 10.2,7.2 10.5,7.6 C10.2,7.9 9.9,8 9.5,8 C9.4,8 9.2,8 9.1,7.9 C8.9,7.5 8.5,7.2 8.1,6.9 C7,6.2 5.5,6.4 4.5,7.3 L3.8,8 L2.3,9.5 C1.2,10.6 1.2,12.5 2.3,13.6 C3.4,14.7 5.3,14.7 6.4,13.6 L7.9,12.1 C8.4,12.3 8.9,12.4 9.5,12.4 Z M14.7,1.3 C13,-0.4 10.2,-0.4 8.5,1.3 L6.3,3.5 C6.2,3.6 6.2,3.6 6.1,3.7 C6.7,3.7 7.4,3.7 8,3.9 L9.5,2.4 C10.6,1.3 12.5,1.3 13.6,2.4 C14.7,3.5 14.7,5.4 13.6,6.5 L12.1,8 L11.4,8.7 C10.4,9.7 8.9,9.8 7.8,9.1 C7.4,8.9 7.1,8.5 6.8,8.1 C6.7,8.1 6.5,8 6.4,8 C6,8 5.6,8.2 5.4,8.4 C5.6,8.8 5.9,9.3 6.3,9.6 C6.6,10 7.1,10.2 7.5,10.5 C9,11.2 10.9,11 12.3,9.8 C12.4,9.7 12.4,9.7 12.5,9.6 L14.7,7.4 C16.4,5.7 16.4,3 14.7,1.3 Z\" id=\"Shape\"></path>\n                        </g>\n                    </g>\n                </g>\n            </svg></a>Why include or exclude users?</h3>\n<p>While it may be counterintuitive, using more data to generate a prediction does not mean the prediction will be more accurate. Not all users are relevant to every prediction you want to create, and irrelevant users can make it more difficult for the ML model to identify meaningful patterns and trends. This is why it’s best to consider the business outcome you want to achieve when defining the user segment that will generate a prediction.</p>\n<h3 id=\"use-case-examples\" style=\"position:relative;\"><a href=\"#use-case-examples\" aria-label=\"use case examples permalink\" class=\"anchor before\"><svg width=\"16px\" height=\"17px\" viewBox=\"0 0 16 17\" version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\">\n                <g id=\"Symbols\" stroke=\"none\" stroke-width=\"1\" fill=\"none\" fill-rule=\"evenodd\">\n                    <g id=\"Icon/Link\" fill=\"#98A0A3\" fill-rule=\"nonzero\">\n                        <g id=\"link\">\n                            <path d=\"M9.5,12.4 C9.6,12.4 9.7,12.4 9.9,12.4 C9.8,12.5 9.8,12.5 9.7,12.6 L7.5,14.8 C5.8,16.5 3,16.5 1.3,14.8 C-0.4,13.1 -0.4,10.3 1.3,8.6 L3.5,6.4 C3.6,6.3 3.6,6.3 3.7,6.2 C5,5 6.9,4.8 8.4,5.5 C8.8,5.7 9.3,6 9.6,6.4 C10,6.7 10.2,7.2 10.5,7.6 C10.2,7.9 9.9,8 9.5,8 C9.4,8 9.2,8 9.1,7.9 C8.9,7.5 8.5,7.2 8.1,6.9 C7,6.2 5.5,6.4 4.5,7.3 L3.8,8 L2.3,9.5 C1.2,10.6 1.2,12.5 2.3,13.6 C3.4,14.7 5.3,14.7 6.4,13.6 L7.9,12.1 C8.4,12.3 8.9,12.4 9.5,12.4 Z M14.7,1.3 C13,-0.4 10.2,-0.4 8.5,1.3 L6.3,3.5 C6.2,3.6 6.2,3.6 6.1,3.7 C6.7,3.7 7.4,3.7 8,3.9 L9.5,2.4 C10.6,1.3 12.5,1.3 13.6,2.4 C14.7,3.5 14.7,5.4 13.6,6.5 L12.1,8 L11.4,8.7 C10.4,9.7 8.9,9.8 7.8,9.1 C7.4,8.9 7.1,8.5 6.8,8.1 C6.7,8.1 6.5,8 6.4,8 C6,8 5.6,8.2 5.4,8.4 C5.6,8.8 5.9,9.3 6.3,9.6 C6.6,10 7.1,10.2 7.5,10.5 C9,11.2 10.9,11 12.3,9.8 C12.4,9.7 12.4,9.7 12.5,9.6 L14.7,7.4 C16.4,5.7 16.4,3 14.7,1.3 Z\" id=\"Shape\"></path>\n                        </g>\n                    </g>\n                </g>\n            </svg></a>Use case examples</h3>\n<ul>\n<li>\n<p><strong>Objective:</strong> Non-subscriber to subscriber conversion</p>\n<ul>\n<li><strong>Include:</strong> Non-subscribers</li>\n<li><strong>Exclude:</strong> Subscribers</li>\n<li><strong>Reasoning:</strong> Subscribers have already converted, so there is no benefit to generating a subscription likelihood for these users. </li>\n</ul>\n</li>\n<li>\n<p><strong>Objective:</strong> Subscription upgrade (tier 1 to tier 2)</p>\n<ul>\n<li><strong>Include:</strong> Tier 1 subscribers </li>\n<li><strong>Exclude:</strong> Tier 2 subscribers </li>\n<li><strong>Reasoning:</strong> Since Tier 2 subscribers have already upgraded, there is no benefit in predicting their likelihood of upgrading. </li>\n</ul>\n</li>\n<li>\n<p><strong>Objective:</strong> Churn prevention</p>\n<ul>\n<li><strong>Include:</strong> Active users </li>\n<li><strong>Exclude:</strong> Lapsed users</li>\n<li><strong>Reasoning:</strong> Since lapsed users have already churned, they should not be part of the effort to prevent churn. As such, there is no value in generating an attribute predicting their likelihood of churning. </li>\n</ul>\n</li>\n<li>\n<p><strong>Objective:</strong> Cross sell: Get purchasers of item A to buy a variant at a higher price point</p>\n<ul>\n<li><strong>Include:</strong> Customers who purchased item A</li>\n<li><strong>Exclude:</strong> Customers who did not buy item A</li>\n<li><strong>Reasoning:</strong> Since customers who have already purchased item A are more likely to purchase its more expensive counterpart, predicting the likelihood of cross sell for these customers only would be more efficient. </li>\n</ul>\n</li>\n<li>\n<p><strong>Objective:</strong> Predicting which viewers who have not yet watched a show will watch it in the future</p>\n<ul>\n<li><strong>Include:</strong> Viewers who have not watched this show</li>\n<li><strong>Exclude:</strong> Viewers who have watched this show</li>\n<li><strong>Reasoning:</strong> Since the objective of this campaign is to acquire <em>new</em> viewers of a show, this predictive attribute should exclude viewers who have already watched the show. </li>\n</ul>\n</li>\n</ul>","frontmatter":{"title":"Using Predictive Audiences","order":6.2,"seoTitle":null,"seoDescription":null},"parent":{"__typename":"File","modifiedTime":"October 12, 2026"}}},"pageContext":{"slug":"/guides/audiences/predictive-audiences/using-predictive-audiences/"}},"staticQueryHashes":["2950460867"]}