# Audiences

> Audiences are lists of customer profiles that allow you to target specific groups of customers in your campaigns.

> For the complete documentation index, see [llms.txt](https://docs.talon.one/llms.txt).

For example, you can use [audience conditions](/docs/product/rules/conditions/available-conditions.md#audience-conditions)
in your rules to display notifications to certain users depending on their past interactions
with your company or their location.
This is useful for improving the customer experience and increasing the performance of your
campaigns.

Audiences can be created on third-party [customer data platforms](/docs/dev/technology-partners/cdp/overview.md)
or directly in Talon.One.

## Audience environments

In Talon.One, you can create audiences in one of the following environments:

- Sandbox
- Live

They help you differentiate between testing and production audiences.

Audiences from a given environment can only be connected to
[Applications from the same environment](/docs/product/applications/overview.md#application-environments).
For example, if an audience is created in the sandbox environment,
it cannot be accessed in the live environment.

## Create an audience

You can create audiences in Talon.One via the Campaign Manager or via the [Integration API](/integration-api/#tag/Audiences/operation/createAudienceV2).

:::tip
Using the Integration API is useful to sync your data warehouse with Talon.One during the
audience creation process.
:::

To create an audience via the Campaign Manager:

1. On the leftmost menu, click <Audiences className="icon"/> **Audiences**.
1. Click **Create Audience**.
1. In **Name**, type a name for the audience.
1. (Optional) In **Description**, enter some information to help you identify the audience.
1. In **Environment**, select the [audience environment](#audience-environments). You cannot change the audience environment after you have
   created the audience.
1. In **Connected Applications**, select the Applications where you want the audience to be
   available. To restrict the audience to certain Applications only, select
   **Specific Applications**.
1. (Optional) In **Import members**, click <Upload className="icon"/> **Upload a CSV file**
   and select a CSV file with a list of audience members from your computer. This can be done
   [after creating the audience](#manage-audience-members).

   :::tip
You can also add members to or remove them from an audience using the [Update audience](/docs/product/rules/effects/use-effects#update-an-audience) effect in your [rules](/docs/product/rules/overview).
Importing a CSV file with audience members does not trigger the _Update audience_ effect.
:::

1. Click **Create Audience**.

## List audiences

To list your audiences, click <Audiences className="icon"/> **Audiences** on the leftmost
menu.

This page displays the available audiences. It contains the following information for each
of them:

| Column                     | Description                                                                                                                                                                                                                |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <nobr>Audience name</nobr> | Name of the audience and icon to indicate the [audience environment](#audience-environments).The acronym CDP to the right of the audience name indicates that the audience was created on a customer data platform. |
| Members                    | Number of members of the audience. An audience can have an unlimited number of members.                                                                                                                           |
| Actions                    | Buttons to [edit](#edit-an-audience) or [delete](#delete-an-audience) the audience.                                         |

## Audience page

In <Audiences className="icon"/> **Audiences**, click an audience name to view all the
information for the audience.

The audience page displays the following information:

- Icon indicating the [audience environment](#audience-environments).
- Name of the audience.
- **Audience ID:** Identifier of the audience. It can be used for integration purposes.
- **Last update:** Date and time when the audience was last updated.
- Description of the audience.
- **Audience members:** table containing audience member data. It displays the following information:

  | Column         | Description                                                                                                                                                          |
  | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Integration ID | Identifier of the [customer profile](/docs/product/applications/display-customer-profiles.md#customer-profile-overview). It can be used for integration purposes. |
  | Created        | Date and time when the audience was created.                                                                                                                         |
  | Last activity  | Date and time when the member was imported.                                                                                                                          |

  :::tip
  To download a CSV file with the members of the audience, click <Export className="icon"/> **Export Members**.
  :::

## Edit an audience

You can modify some characteristics of an audience via the Campaign Manager after you create it, such as update its name and description.
If a third-party platform created the audience, you cannot edit it via the Campaign Manager.

:::tip
You can also add members to or remove them from an audience using the [Update audience](/docs/product/rules/effects/use-effects#update-an-audience) effect in your [rules](/docs/product/rules/overview).
Importing a CSV file with audience members does not trigger the _Update audience_ effect.
:::

To edit an audience:

1. On the leftmost menu, click <Audiences className="icon"/> **Audiences**.
1. Next to the audience you want to edit, click <Edit className="icon"/>.

   :::tip
   You can also click **Edit Audience** at the top-right of the [audience page](#audience-page).
   :::

1. Edit the required details, such as the name, description, or connected Applications.
1. Click **Save**.

## Manage audience members

You can export a list of audience members or upload a new list of members at any time.

1. On the leftmost menu, click <Audiences className="icon"/> **Audiences**.
1. Next to the audience whose members you want to manage, click <Edit className="icon"/>.
1. In **Manage members**:
   - To export a list of audience members, click <Export className="icon"/> **Export Members**.
   - To upload a new list of audience members, click <Upload className="icon"/> **Upload a CSV File**.

     :::important
     Uploading a new list of members overrides the current list. If the audience is used in an
     active campaign, updating the list of members also impacts the campaign.
     :::

1. Click **Save**.

## Delete an audience

You can delete an audience via the Campaign Manager if no campaign rules reference it.

To delete an audience:

1. On the leftmost menu, click <Audiences className="icon"/> **Audiences**.
1. Next to the audience you want to delete, click <Delete className="icon"/>.
1. In the confirmation pop-up that appears, click **Delete Audience**.

:::tip
You can also delete an audience using the **Delete audience** button while [editing](#edit-an-audience).
:::

:::note
You cannot delete audiences created by a third-party platform (marked with `CDP`) via the Campaign Manager.
Remove the audience in your third-party platform and wait for the audience sync to remove it from Talon.One.
:::

## Related pages

- [Customer data platforms](/docs/dev/technology-partners/cdp/overview.md)
- [Generic CDP integration](/docs/dev/technology-partners/cdp/integrate-cdp.md)
- [Application environments](/docs/product/applications/overview.md#application-environments)
- [Audience conditions](/docs/product/rules/conditions/available-conditions.md#audience-conditions)
- [Set up an audience output in mParticle](/docs/dev/technology-partners/mparticle/mparticle-enable-integration.md#set-up-an-audience-output)
- [Integrate with Segment](/docs/dev/technology-partners/segment/segment-integration.md)
