Manage Audiences

The Audiences landing page is the central place to review and manage audiences and audience groups. To open it, select Segmentation in the Overview Map, then select Audiences in the navigation.

Review audience summaries

The audience summary cards at the top of the landing page provide an overview of your audiences:

• Total audiences shows the total number of audiences and summarizes them by status.
• Active audiences shows how many audiences are active relative to your account limit and identifies your most-used outputs.
• Audience size shows the average size across active audiences and identifies the audiences with the largest gains and declines.

Find and filter audiences

Use the controls above the table to narrow the audiences displayed:

• Select one of the status tabs (either Active, Faulty, or Inactive) to see only audiences with that status. Select All audiences to view audiences with any status. The number shown next to All audiences reflects the audiences available in the current view, with any filters applied.
• Enter an audience name, tag, or ID in the search field.
• Select Filters to open the filter drawer, choose filter values, and apply them to the table.

Customize the audience table

Select View columns to control which fields appear in the table:

1. Search for a column by name or scroll through the available columns.
2. Select or clear a column’s checkbox to show or hide it.
3. Drag selected columns into the order you want.
4. Select Save.

Select Reset to restore the default column selection and order.

Available fields include identifying information, audience metrics, refresh information, ownership and modification details, and tags. Examples include:

• Name
• Type
• ID
• Size
• Refresh frequency
• Total audiences
• Active audiences
• Adds
• Drops
• Volatility
• Last synced
• Last updated (UTC)
• Created by
• Created on
• Last modified by
• Tags

Some metrics apply only to individual audiences or only to audience groups. The table displays a dash when a field isn’t available for that row type. For example, individual-audience metrics such as Size, Adds, Drops, and Volatility aren’t available for audience group rows.

Review audiences and audience groups

Audience groups contain one or more individual audiences. Use the expand or collapse control beside a group name to show or hide its audiences.

If an audience group contains a single audience, the landing page displays only the individual audience.

For scheduled audiences, Next calculation shows when mParticle will next refresh audience membership. For a one-time audience, it shows the single scheduled calculation. After that calculation completes, no additional calculation is scheduled, and the audience expires 30 days after its scheduled start date.

Audience Insights

Select the Insights icon in an eligible audience row to open its dedicated Audience Insights page. The icon appears only for real-time audiences with an Active or Calculated status.

The dedicated page isn’t available for composable audiences. Real-time and composable audiences can continue to access Insights from the Insights tab in Audience Builder.

For metric definitions and eligibility details, see Audience Insights.

Manage audiences

Select an audience name to open it in Audience Builder. Select an audience group name to open it in the Audience Group Editor.

Create and apply tags

Use tags to organize audiences by purpose, campaign, or another category. You can also enter a tag in the landing-page search field to find every audience with that tag.

To create and apply a tag:

1. Expand the audience group that contains the audience.
2. Select the Tags control in the audience row.
3. Enter a tag name. Tag names can contain up to 18 characters.
4. Select the new tag to apply it to the audience.

To apply additional tags, open the audience’s tag list and select each tag you want to add.

Edit audience group inputs

You can add or remove an audience group’s data inputs after creating it:

1. Open the audience group.
2. Select the top node labeled Audience Group Inputs.
3. Add or remove inputs.
4. Select Update.

Clone audiences and audience groups

Use cloning to reuse an audience’s criteria or an audience group’s configuration instead of starting from scratch.

Clone an audience

You can clone an audience from the Audiences landing page or from the Audience Group Editor.

From the Audiences landing page

To clone an audience from the Audiences landing page:

1. Go to Segmentation > Audiences.
2. Select New Audience.
3. In the Create Audience dialog, select Start from existing audience.
4. Open the Select Audience dropdown and select the audience you want to clone.

5. Select Next.

Audience Builder opens with the criteria from the selected audience. Review and edit the criteria as needed.

From the Audience Group Editor

To clone an audience from the Audience Group Editor:

1. Open the audience group where you want to add the cloned audience.
2. Select the + icon where you want to add the cloned audience.

3. In the Create Audience dialog, select Start from existing audience.
4. Open the Select Audience dropdown and select the audience you want to clone.

5. Select Next.

Audience Builder opens with the criteria from the selected audience. Review and edit the criteria as needed.

Clone an audience group

To clone an audience group:

1. Go to Segmentation > Audiences.
2. Open the three-dot action menu for the audience group you want to clone, then select Clone.

3. In the Clone Audience Group dialog, enter a descriptive name for the cloned group.
4. Select Clone Audience Group.

The Audience Group Editor opens with the cloned group. Cloned audience groups are inactive by default. You can activate the audiences in the group and connect them to downstream outputs as you would for any other audience group.

Delete audiences and audience groups

Delete one audience

To delete a single audience:

1. Open the audience’s row action menu.
2. Select Delete.
3. Review the affected audience in the confirmation dialog.
4. Confirm the deletion.

Delete multiple audiences

To delete multiple audiences:

1. Select the checkbox for each audience you want to delete.
2. Select the count-aware bulk action, such as Delete (2).

3. Review every affected audience in the confirmation dialog.

4. Confirm the deletion.

Delete an audience group

To delete an audience group:

1. Open the audience group’s action menu.
2. Select Delete group.
3. Review every audience in the confirmation dialog.
4. Confirm the deletion.

Resolve in-use dependencies

An audience is marked In use when another audience depends on it. The dependency details in the deletion dialog identify the records that prevent deletion.

Remove the dependencies before trying the deletion again. If any audience in an audience group is In use, you will not be able to delete the group.

Download an Audience

You can download an audience that has been calculated as a CSV file. Downloads are useful for verifying that specific profiles match your criteria, troubleshooting an audience definition, or sharing audience data when an official mParticle audience integration isn’t available.

You can download a real-time audience after it begins calculating. You can also download a one-time audience after it calculates and before it expires. A one-time audience expires 30 days after its scheduled start date and can’t be downloaded after expiration.

A/B test variations, including the control group, can also be downloaded. Each variation appears as an individual audience on the Audiences landing page, so select the variation you want and follow the standard download steps.

Initiate a Download

1. On the Audiences landing page, open the actions menu for the audience you want to download and select the download option.

2. Choose whether to download all users or a sample, then select the download format. A sample is usually faster to prepare and is useful for testing or troubleshooting.

3. Select the device IDs to include in the download.

4. Select the identities to include in the download.

5. Select Download.

Download the File

mParticle prepares the download asynchronously. When the file is ready, mParticle sends an email containing a link to download it.

The download is a ZIP archive containing a CSV file for each selected audience or variation and a manifest.json file containing metadata about the download.

CSV Format

Audience CSV files contain one row for each identity in the audience. Because a single user profile can contain multiple identities, the same MPID can appear in multiple rows.

Each row contains the MPID, the time the membership was retrieved, the identity value, and the identity type:

mpid, scanned_timestamp_ms, identity_value, identity_type
-1327484737295091692, 1538596779, h.jekyll.md, customer_id
5991422180106081928, 1538596729, m.hyde@example.com, email
3269816782460039080, 1580148438137, 74587f4b-3ed5-492f-a0f5-9a6c4578673d, ios_idfv

Manifest Example

The manifest.json file describes the archive, selected identities, generation time, included files, and row counts:

{
  "archive_name": "mParticleAudiences_204223Jan022019_9dd9.zip",
  "id": "9dd9b6dc-f0ec-4acf-8b18-f3a357afe1c3",
  "audience_ids": [
    8754
  ],
  "included_identities": [
    "customer_id",
    "email"
  ],
  "manifest_generated": "2019-01-02T21:06:20.0216776Z",
  "min_timestamp_ms": 1546463100276,
  "max_timestamp_ms": 1546463100276,
  "total_rows": 18,
  "rows_by_identity": {
    "customer_id": 15,
    "email": 3
  },
  "files": [
    {
      "file_name": "8754_PotentialParisians_172136Nov292018.csv",
      "min_timestamp_ms": 1546463100276,
      "max_timestamp_ms": 1546463100276,
      "total_users": 15,
      "total_rows": 18,
      "rows_by_identity": {
        "customer_id": 15,
        "email": 3
      }
    }
  ]
}

Share audiences between accounts

You can share audiences between your organization’s accounts. When sharing an audience with an account, you can specify one of the following access levels for recipient account:

• Owner: Full access to the audience, including editing, audience updates, and connecting outputs. Admins can set permissions.
• Private: The audience is invisible to the receiving account.
• View only: Visible to the receiving account but cannot connect to outputs.
• Usable: Visible to the receiving account and can connect to outputs. Audience definition cannot be edited.

To share an audience:

1. Navigate to the Audiences landing page.

2. Open the Actions menu for the audience you want to share, then click Share.

   

3. In Audience Sharing Settings, review the accounts the audience is already shared with. To add an account, click the + button.

   

4. Select the account you want to share the audience with under Share With, and select the access level under Share Level.

   
5. Click Add. Repeat these steps to share the audience with additional accounts, and when you are finished, click Save.

6. You can change an existing access level with its dropdown or stop sharing with an account by clicking the delete icon.