{"componentChunkName":"component---src-templates-markdown-template-jsx","path":"/guides/audiences/connect-an-audience/","result":{"data":{"pageMetadata":{"title":"Connect an Audience","path":"/guides/audiences/connect-an-audience/","sourceCode":null,"metadataParent":{"title":"Audiences","path":"/guides/audiences/","sourceCode":null,"hasVersionPicker":null,"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":"

Once you have created an Audience, the next step is to connect it to an audience output where you can activate it. Visit our Integrations page and filter by Audience to view all audience outputs.

\n

\n \n \n \n \n \n \n \n Create Audience Output

\n

To add an audience output:

\n
    \n
  1. Navigate to Data Platform > Setup > Directory, and click the card for your audience partner of choice. (You can filter the Directory to show only partners with an Audience Configuration.)\n\"Connect
    2. \n
  2. Select an output and complete the Connections Settings dialog. This will be different for every integration. See the Integrations Center for details for your integration.
    3. \n
  3. Complete the Configuration Settings dialog. Each partner will require slightly different information. Some require an API Key/Secret/Token, others require you to log in from mParticle using Oauth. See the Integrations Center for details for your integration. Give the configuration a name and click Save.
    4. \n
\n

You can view and update your configurations at any time by navigating to Setup > Outputs, and selecting Audience tab.

\n

\n \n \n \n \n \n \n \n Connect Your Audience

\n

Once you have created at least one audience output, you can connect your audience to begin sending data to that vendor.

\n
    \n
  1. In the Audience Editor, select Connect Output in the card beneath the audience you want to connect.\n\"Connect
    2. \n
  2. Select the output to which you want to connect and follow instructions in the Connect Output dialogue. This will be different for every integration. See the Integrations Center for details for your integration.
    3. \n
  3. Make sure the Status switch is set to Active.
    4. \n
  4. Click Add connection.\n\"Connect
    5. \n
\n

\n \n \n \n \n \n \n \n Connect A/B Test Variations

\n

Each variation in an A/B test, including the control group, appears as an individual audience. You can create separate output connections for each variation by selecting Connect Output on its audience card and following the standard connection steps.

\n

For example, connect one variation to Messaging Platform A and another to Messaging Platform B. Leave the control group without a messaging connection when you want to compare both treatments against an unmessaged group.

\n\"Connect\n

When an integration uses the audience’s external name, mParticle names a variation using the format [Audience External Name] - [Variation Name].

\n

\n \n \n \n \n \n \n \n Connection Status and Last Sent Date

\n

In the Connections tab, each connection row displays its current status and its last sent date, the most recent date mParticle sent audience data to that output. Use these to check that a connection is active and to see when mParticle last sent data to it.

\n

\n \n \n \n \n \n \n \n Connecting One-time Audiences

\n

You can connect a one-time audience to new outputs at any time before it expires (30 days after it calculates). When you add a connection to a one-time audience that has already calculated, mParticle sends its already-calculated membership to the new connection. You don’t need to wait for a recalculation or recreate the audience.

\n

After a one-time audience expires, the Add connection button is disabled and you can’t connect it to additional outputs. For more information, see one-time audiences.

\n

\n \n \n \n \n \n \n \n How Audience Forwarding Works

\n

When mParticle forwards an Audience to an output, only identity data is sent by default. While mParticle can collect various identity types for both devices and users, most audience partners accept only a limited set of identities based on their specific needs. For example, an email marketing partner may only accept email addresses, a push messaging partner may only accept push tokens, and a mobile advertising platform may only accept device advertising identifiers (IDFA for iOS and GAID for Android).

\n

When building your Audiences in mParticle, you don’t need to worry about which identities a partner supports. Simply define your Audience criteria, and mParticle will forward all available identities that each partner accepts.

\n

\n \n \n \n \n \n \n \n Example

\n

You define an Audience with criteria that matches 100 profiles.

\n\n

mParticle will automatically forward the data to each partner:

\n\n

You don’t need to track which identities are available per profile—mParticle handles the process seamlessly.

\n

\n \n \n \n \n \n \n \n Selective Attribute Forwarding

\n

When forwarding data to an Audience output, you have the option to selectively forward User Attributes beyond the identities that are required for engagement. Forwarding Calculated Attributes like LTV or Predictive Attributes like propensity scores, for example, enables you to use richer data in your activation platforms. Not all integrations support this — when you connect your Audience you will see what is supported.

\n

In the last step of the process to connect an output, select which account and workspace level attributes you would like to forward to that particular tool:

\n

\"Selective

\n\n

Consent filters control which profiles mParticle forwards to an audience output based on recorded GDPR and CCPA consent. A workspace-default filter applies to every audience output configuration that doesn’t have a manually assigned filter. A manually assigned filter takes precedence over the workspace default. See Consent Filters to learn how to create and apply them.

","frontmatter":{"title":"Connect an Audience","order":3,"seoTitle":null,"seoDescription":null},"parent":{"__typename":"File","modifiedTime":"October 12, 2026"}}},"pageContext":{"slug":"/guides/audiences/connect-an-audience/"}},"staticQueryHashes":["2950460867"]}