Documentation

Developers

API References
Platform API

Platform API Overview

Accounts

Apps

Audiences

Calculated Attributes

Data Points

Feeds

Field Transformations

Services

Users

Workspaces

Data Subject Request API

Data Subject Request API Version 1 and 2

Data Subject Request API Version 3

Warehouse Sync API

Warehouse Sync API Overview

Warehouse Sync API Tutorial

Warehouse Sync API Reference

Data Mapping

Warehouse Sync SQL Reference

Warehouse Sync Troubleshooting Guide

ComposeID

Warehouse Sync API v2 Migration

Bulk Profile Deletion API Reference

Calculated Attributes Seeding API

Custom Access Roles API

Data Planning API

Group Identity API Reference

Pixel Service

Profile API

Events API

mParticle JSON Schema Reference

IDSync

Client SDKs
AMP

AMP SDK

Android

Initialization

Configuration

Network Security Configuration

Event Tracking

User Attributes

IDSync

Screen Events

Commerce Events

Location Tracking

Media

Kits

Application State and Session Management

Data Privacy Controls

Error Tracking

Opt Out

Push Notifications

WebView Integration

Logger

Preventing Blocked HTTP Traffic with CNAME

Linting Data Plans

Troubleshooting the Android SDK

API Reference

Upgrade to Version 5

Cordova

Cordova Plugin

Identity

Direct Url Routing

Direct URL Routing FAQ

Web

Android

iOS

Flutter

Getting Started

Usage

API Reference

iOS

Initialization

Configuration

Event Tracking

User Attributes

IDSync

Screen Tracking

Commerce Events

Location Tracking

Media

Kits

Application State and Session Management

Data Privacy Controls

Error Tracking

Opt Out

Push Notifications

Webview Integration

Upload Frequency

App Extensions

Preventing Blocked HTTP Traffic with CNAME

Linting Data Plans

Troubleshooting iOS SDK

Social Networks

iOS 14 Guide

iOS 15 FAQ

iOS 16 FAQ

iOS 17 FAQ

iOS 18 FAQ

API Reference

Upgrade to Version 7

React Native

Getting Started

Identity

Roku

Getting Started

Identity

Media

Unity

Upload Frequency

Getting Started

Opt Out

Initialize the SDK

Event Tracking

Commerce Tracking

Error Tracking

Screen Tracking

Identity

Location Tracking

Session Management

Xbox

Getting Started

Identity

Web

Initialization

Configuration

Content Security Policy

Event Tracking

User Attributes

IDSync

Page View Tracking

Commerce Events

Location Tracking

Media

Kits

Application State and Session Management

Data Privacy Controls

Error Tracking

Opt Out

Custom Logger

Persistence

Native Web Views

Self-Hosting

Multiple Instances

Web SDK via Google Tag Manager

Preventing Blocked HTTP Traffic with CNAME

Facebook Instant Articles

Troubleshooting the Web SDK

Browser Compatibility

Linting Data Plans

API Reference

Upgrade to Version 2 of the SDK

Xamarin

Getting Started

Identity

Web

Alexa

Server SDKs

Node SDK

Go SDK

Python SDK

Ruby SDK

Java SDK

Tools

mParticle Command Line Interface

Smartype

Linting Tools

Media SDKs

iOS

Android

Web

Quickstart
Android

Overview

Step 1. Create an input

Step 2. Verify your input

Step 3. Set up your output

Step 4. Create a connection

Step 5. Verify your connection

Step 6. Track events

Step 7. Track user data

Step 8. Create a data plan

Step 9. Test your local app

HTTP Quick Start

Step 1. Create an input

Step 2. Create an output

Step 3. Verify output

iOS Quick Start

Overview

Step 1. Create an input

Step 2. Verify your input

Step 3. Set up your output

Step 4. Create a connection

Step 5. Verify your connection

Step 6. Track events

Step 7. Track user data

Step 8. Create a data plan

Java Quick Start

Step 1. Create an input

Step 2. Create an output

Step 3. Verify output

Node Quick Start

Step 1. Create an input

Step 2. Create an output

Step 3. Verify output

Python Quick Start

Step 1. Create an input

Step 2. Create an output

Step 3. Verify output

Web

Overview

Step 1. Create an input

Step 2. Verify your input

Step 3. Set up your output

Step 4. Create a connection

Step 5. Verify your connection

Step 6. Track events

Step 7. Track user data

Step 8. Create a data plan

Guides
Partners

Introduction

Outbound Integrations

Outbound Integrations

Firehose Java SDK

Inbound Integrations

Kit Integrations

Overview

Android Kit Integration

JavaScript Kit Integration

iOS Kit Integration

Compose ID

Migrate from Segment to mParticle

Migrate from Segment to mParticle

Migrate from Segment to Client-side mParticle

Migrate from Segment to Server-side mParticle

Segment-to-mParticle Migration Reference

Glossary

Data Hosting Locations

Rules Developer Guide

The Developer's Guided Journey to mParticle

API Credential Management

Guides

Getting Started

Create an Input

Start capturing data

Connect an Event Output

Create an Audience

Connect an Audience Output

Transform and Enhance Your Data

Personalization

Introduction

Profiles

Audiences

Audiences Overview

Create an Audience

Connect an Audience

Manage Audiences

Real-time Audiences (Legacy)

Standard Audiences (Legacy)

Calculated Attributes

Calculated Attributes Overview

Using Calculated Attributes

Create with AI Assistance

Calculated Attributes Reference

Predictive Audiences

Predictive Audiences Overview

Using Predictive Audiences

Journeys

Journeys Overview

Manage Journeys

Download an audience from a journey

Audience A/B testing from a journey

Journeys 2.0

Predictive Attributes

What are predictive attributes?

Predict Future Behavior

Create Future Prediction

Use Future Predictions in Campaigns

Assess and Troubleshoot Predictions

Next Best Action

Next Best Action Overview

Create a Next Best Action (NBA)

View and Manage NBAs

Activate Next Best Actions in Campaigns

Platform Guide
Billing

Usage and Billing Report

The New mParticle Experience

The new mParticle Experience

The Overview Map

Observability

Observability Overview

Observability User Guide

Observability Span Glossary

Introduction

Data Retention

Connections

Activity

Live Stream

Data Filter

Rules

Tiered Events

mParticle Users and Roles

Analytics Free Trial

Troubleshooting mParticle

Usage metering for value-based pricing (VBP)

Analytics

Introduction

Setup

Sync and Activate Analytics User Segments in mParticle

User Segment Activation

Welcome Page Announcements

Settings

Project Settings

Roles and Teammates

Organization Settings

Global Project Filters

Portfolio Analytics

Analytics Data Manager

Analytics Data Manager Overview

Events

Event Properties

User Properties

Revenue Mapping

Export Data

UTM Guide

Query Builder

Data Dictionary

Query Builder Overview

Modify Filters With And/Or Clauses

Query-time Sampling

Query Notes

Filter Where Clauses

Event vs. User Properties

Group By Clauses

Annotations

Cross-tool Compatibility

Apply All for Filter Where Clauses

Date Range and Time Settings Overview

User Attributes at Event Time

Understanding the Screen View Event

Analyses

Analyses Introduction

Segmentation: Basics

Getting Started

Visualization Options

For Clauses

Date Range and Time Settings

Calculator

Numerical Settings

Segmentation: Advanced

Assisted Analysis

Properties Explorer

Frequency in Segmentation

Trends in Segmentation

Did [not] Perform Clauses

Cumulative vs. Non-Cumulative Analysis in Segmentation

Total Count of vs. Users Who Performed

Save Your Segmentation Analysis

Export Results in Segmentation

Explore Users from Segmentation

Funnels: Basics

Getting Started with Funnels

Group By Settings

Conversion Window

Tracking Properties

Date Range and Time Settings

Visualization Options

Interpreting a Funnel Analysis

Funnels: Advanced

Group By

Filters

Conversion over Time

Conversion Order

Trends

Funnel Direction

Multi-path Funnels

Analyze as Cohort from Funnel

Save a Funnel Analysis

Export Results from a Funnel

Explore Users from a Funnel

Cohorts

Getting Started with Cohorts

Analysis Modes

Save a Cohort Analysis

Export Results

Explore Users

Saved Analyses

Manage Analyses in Dashboards

Journeys

Getting Started

Event Menu

Visualization

Ending Event

Save a Journey Analysis

Users

Getting Started

User Activity Timelines

Time Settings

Export Results

Save A User Analysis

Dashboards

Dashboards––Getting Started

Manage Dashboards

Dashboard Filters

Organize Dashboards

Scheduled Reports

Favorites

Time and Interval Settings in Dashboards

Query Notes in Dashboards

User Aliasing

Analytics Resources

The Demo Environment

Keyboard Shortcuts

Tutorials

Analytics for Marketers

Analytics for Product Managers

Compare Conversion Across Acquisition Sources

Analyze Product Feature Usage

Identify Points of User Friction

Time-based Subscription Analysis

Dashboard Tips and Tricks

Understand Product Stickiness

Optimize User Flow with A/B Testing

User Segments

APIs

User Segments Export API

Dashboard Filter API

IDSync

IDSync Overview

Use Cases for IDSync

Components of IDSync

Store and Organize User Data

Identify Users

Default IDSync Configuration

Profile Conversion Strategy

Profile Link Strategy

Profile Isolation Strategy

Best Match Strategy

Aliasing

Data Master
Group Identity

Overview

Create and Manage Group Definitions

Introduction

Catalog

Live Stream

Data Plans

Data Plans

Blocked Data Backfill Guide

Warehouse Sync

Data Privacy Controls

Data Subject Requests

Default Service Limits

Feeds

Cross-Account Audience Sharing

Approved Sub-Processors

Import Data with CSV Files

Import Data with CSV Files

CSV File Reference

Glossary

Video Index

Analytics (Deprecated)
Identity Providers

Single Sign-On (SSO)

Setup Examples

Settings

Debug Console

Data Warehouse Delay Alerting

Introduction

Developer Docs

Introduction

Integrations

Introduction

Rudderstack

Google Tag Manager

Segment

Data Warehouses and Data Lakes

Advanced Data Warehouse Settings

AWS Kinesis (Snowplow)

AWS Redshift (Define Your Own Schema)

AWS S3 (Snowplow Schema)

AWS S3 Integration (Define Your Own Schema)

BigQuery (Snowplow Schema)

BigQuery Firebase Schema

BigQuery (Define Your Own Schema)

GCP BigQuery Export

Snowflake (Snowplow Schema)

Snowplow Schema Overview

Snowflake (Define Your Own Schema)

APIs

REST API

Dashboard Filter API (Deprecated)

User Segments Export API (Deprecated)

SDKs

SDKs Introduction

React Native

iOS

Android

Java

JavaScript

Python

Object API

Developer Basics

Aliasing

Create an Audience

Creating an audience begins with defining your use case, segmentation approach, and engagement strategy. To do this, consider the following questions:

  • What is the business goal you are trying to accomplish?
  • Which customer segments are important to achieving this business goal?
  • Once you identify the relevant users, what is your strategy for engaging them?

Example Use Cases

Increase User Retention for a Mobile App

Retaining users is crucial for the sustained success of a mobile application. By identifying and re-engaging inactive users, you can boost overall engagement and reduce churn.

Goal: Improve user retention by targeting users who have not opened the app in the last 7 days.
Segmentation Strategy: Identify users who have been inactive for a week but used the app actively within the previous month.
Engagement Strategy: Send personalized push notifications offering a discount or exclusive content to re-engage users.

Predictive Audience for Likely Purchasers

Leveraging predictive analytics allows businesses to anticipate user behavior and proactively engage those most likely to convert, thereby optimizing marketing efforts.

Goal: Increase conversion rates by targeting users predicted to make a purchase in the next 7 days.
Segmentation Strategy: Utilize Predictive Audiences to identify users with a high likelihood of purchasing based on machine learning models analyzing past behaviors and interactions.
Engagement Strategy: Deliver personalized email campaigns featuring product recommendations or special offers to these high-likelihood purchasers.

Optimize Engagement in a Subscription Service

Identifying subscribers at risk of churning enables proactive engagement strategies to maintain a stable subscriber base.

Goal: Minimize churn by identifying at-risk subscribers.
Segmentation Strategy: Identify users whose subscription renewal is within the next 30 days and who have decreased engagement (e.g., fewer logins or interactions).
Engagement Strategy: Offer these users tailored incentives such as a loyalty bonus or a discounted renewal rate to encourage continued subscription.

Create a New Audience

Once you have clearly defined your use case, it’s time to begin building your audience.

  1. From the mParticle Overview Map, select Segmentation.
    Select Segmentation in Overview Map
  2. On the Audiences landing page, click Create New.
    Select Segmentation in Overview Map

Configure Your Audience Strategy

Individual audiences are contained within folders called Audience Strategies. The first step in creating a new audience is to set the configurations for this folder:

Configure Audience Strategy

  1. Enter a name for your folder.
  2. Select the platforms and feeds that will supply data to define the audiences within your folder.
  3. Click Create.

Define Your Audience

After saving your audience strategy configuration settings, you’ll enter the Editor. Here is where you can add, view, edit, and connect audiences.

Follow the steps below to create your first audience within this folder:

  1. Click the Add criteria box to open the Audience Builder Modal. Open Audience Builder
  2. In the audience builder modal, choose the environment (Production, Development, or both) from which the audience will receive data. (Note the audience environment considerations below.)
  3. Click Add Criteria to begin adding criteria for your audience. Open Audience Builder
  4. Select the type of data you would like to use for your first criteria (more on criteria types below). Audience criteria types
  5. Referring to the data types and matching rules below, use the criteria editor to further target the users who fit your use case. Add audience criteria.
  6. Once you have added your first criteria, click Done.

After you have added your first criteria, a number displays that represents the estimated audience size: Estimated audience size. This estimate is based on a sample of data. As you continue to add criteria, you will see an estimated size for both individual criteria as well as for the whole audience.

  1. Continue adding more criteria using And, Or, or Exclude logic to further refine your audience.

Precise vs. Estimated Audience Sizes

Throughout the Audience creation process, you will see both preliminary and precise audience sizes.

Preliminary Estimates

Preliminary estimates are displayed before the audience has been fully calculated, and are denoted with a ~ character throughout the Audiences feature. When an Audience is created or edited, for example, preliminary estimates are shown to give an approximate idea of audience size.

Precise Estimates

Once an audience has finished calculating, the precise estimate will be displayed for that audience. This can take up to 20 minutes for the precise estimate to finish calculating.

Activate an Audience in a Campaign

Once you have created an Audience that you want to forward to an external tool for use in a campaign, click the Connect Output button in the Audience tile, then follow the steps to connect that audience to any of your connected outputs.

Main Criteria Types

You can build criteria based on two main sources of data:

Events

Event criteria check for specific events and their properties, and their availability is subject to the data retention policy of your account. Within the new criteria option in the audience builder, the following options create event-based criteria:

  • Events
  • Ecommerce
  • Crashes
  • Installs
  • Uninstalls
  • Sessions
  • Upgrades
  • Screen views

User Profiles

These criteria check your active user profiles, and their availability is subject to the user profile retention policies of your account. Within the new criteria option in the audience builder, the following options create profile-based criteria:

  • Users: Access user profile information such as user attributes, calculated attributes, current audience memberships, consent state, location, etc.
  • User Predictions: Predictive Attributes that you have defined and generated for your users.
  • Attribution: Access user install and uninstall information to build criteria based on the attributed campaign and publisher.

Data Types and Matching Rules

Audience criteria can be created with several different data types, each with its own matching rules.

Strings

When building audiences based on string attributes, several case-insensitive matching rules can be applied:

  • Contains / Does Not Contain: Matches substrings. For example, "blue" matches both "blue" and "blue shirt".
  • Exact Match / Does Not Match: Requires the entire string to match. For example, "blue" matches "blue", but not "blue shirt".
  • Pattern: Allows wildcard matching. * represents any number of characters, and ? represents any single character. For example, "bl?e" or "b*e" would both match "blue".
  • Includes / Does Not Include: Matches an exact value within a list. For example, specifying "Chicago" in a list of movies returns "Chicago (2002)" and "Chicago (1927)", but not "Chicago Cubs".
  • Partial Match: The inverse of Includes. For example, specifying "Chicago" would return all movies with "Chicago" in the title.

Date-Based Criteria

Filters based on fixed calendar dates. For example, events occurring after 09/12/2018. Date-based criteria are defined in UTC and are not relative to when the audience is calculated:

  • Before: Excludes the specified date. For example, “Before September 9, 2018” includes events up to 11:59 PM UTC on September 8.
  • After: Includes the specified date. For example, “After September 9, 2018” includes events from 12:00 AM UTC on September 9.
  • On Date: Covers events from 12:00 AM to 11:59 PM UTC on the specified date.
  • Between Dates: Includes events from the start of the first date to the end of the second date.

Recency-Based Criteria

Defines a period relative to the current time. For example, users active within the last 7 days. Recency-based criteria select events occurring within a timeframe relative to ‘now’.

  • For example, if calculated at 1:00 PM on September 9, 2018, a recency filter for the last 7 days includes events between 1:00 PM on September 3 and 1:00 PM on September 9.

Attribution

Attribution criteria segment users based on campaign interactions, such as app installs or re-engagements.

  • Profile Criteria: Select Attribution, then choose Install or Uninstall to filter based on campaign and publisher fields from attribution events.
  • Event Criteria: Select Events > Attribution to use install or engagement events, filtering by event attributes. This allows you to select any information included with the event as custom_attributes.

Note: All event criteria are subject to audience event retention limits.

Identity

Identity criteria segment users based on their stored identities. You can test for the existence of a specific identity or apply string-based logic. These criteria are scoped to the workspace in which the audience is created. For example, if your account has three workspaces, an audience in one workspace only includes users active in that workspace.

Location

Location criteria allow segmentation based on geographic information.

  • Equals: Filter users in a specific city, state, zip code, or DMA (Designated Market Area), based on IP geolocation.
  • Within: Filter users within a set distance of a global city using latitude and longitude coordinates.

Cart

For ecommerce events, you can target users who added items to their cart but did not complete a purchase.

  • Cart Abandonment: Select New Criteria > Ecommerce > Shopping - Cart Level > Cart Abandonment to define this segment.
  • Specify the time period to wait without a purchase before including users in this audience.

Attribute Key

Use Exists or Not Exists to check for the presence of an attribute.

  • For example, User Attribute: Gender EXISTS evaluates as true for both Gender = "Female" and Gender = undefined.

Additional Audience Features

Auto-complete

As you define your audience criteria, a list of suggested matching values will appear based on what you’ve entered. Auto-complete example

This feature works both when building new audiences and fine-tuning existing ones, helping you save time, reduce manual effort, and improves accuracy. To use it, you must have one of the following standard Roles: User, Admin, Audiences-only, Support, or Admin+Compliance. Alternatively, you can create a Custom Role with any of the following tasks: audiences:draft, audiences:edit, catalog, or audiences.

Boolean operators

Once you have added criteria, you can use the Boolean operators And, Or, and Exclude to create logical relationships with subsequent criteria. Boolean operators example

Audience Environment Considerations

Be mindful of your selected audience environment:

  • Use Production for real customer data to prevent test data from overwriting profiles in partner systems.
  • Ensure parent and child audiences share the same environment. If environments differ, child audiences will not inherit users from their parent.

Audiences in Development display a badge in the Audience Strategy Editor, while Production audiences do not.

By following these steps and best practices, you can build and activate audiences that align with your business objectives, enabling more targeted user engagement and monetization strategies.

Was this page helpful?

    Last Updated: February 18, 2025