Create an Audience

Creating custom Audiences in Contentstack Personalize empowers you to target specific user segments with tailored content and experiences based on various attributes and behaviors.

• Contentstack account
• Access to the Contentstack Organization that has Personalize enabled
• Access to a project in Personalize
• Custom attributes created in the project, if you want to assign custom attributes to your audience

Note: Users with Owner and Member access to a Personalize project can create new audiences.

Note: To preview audience-specific content in real time or manage variants visually, make sure Live Preview and Visual Builder are enabled and set up on your stack.

Note: For this guide, we have assumed that you have already created a Personalize project. If not, please follow this guide and create a project in Personalize.

To create an audience, log in to your Contentstack account and perform the following steps:

1. To access the new home screen and top navigation, enable the Try the New Navigation toggle located within the profile dropdown.
2. From the App Switcher, click the Personalize icon.
   
3. You will be redirected to the Personalize Projects landing page. Click the project for which you want to create an audience.
4. Click the Audiences tab. From the Audiences page, click the + New Audience button.
   
5. On the New Audience page,
   1. Name: Provide a meaningful name for the audience.
   2. Description: (Optional) Add a brief explanation of the audience's purpose.
   3. Rules: Rules are criteria that define how visitors (audience) are grouped and targeted for tailored experiences based on their characteristics and behaviors. In this section, you need to provide a combination of preset or custom attributes to define your audience as follows:
      1. Under the Match {All/Any} of the below conditions section, you can set the below condition to satisfy either All or Any of the rules.
      2. Click the + Add Group button to group rules together to create more complex rules, then click the + Add Rule button within the new group.

         Similar, add multiple rules within a group to build complex scenarios by clicking the + Add Rule button.

      3. Create a rules by clicking the Select Attribute drop-down and select either a preset attribute or a custom one. Click Select Operator to select an attribute-specific operator and then select a matching criteria for the condition by clicking the Select Value drop-down.

         Similarly to add multiple rules, click the + Add Rule button.

         Note: By default, you can add upto 50 rules in each Audience. To increase this limit, please contact our support team.

         Additional Resource: You can use the Personalize Edge API to set and update the user attributes.

   

6. Once you have defined your audience, click the Save button.This creates a new audience in your Personalize project.

Additional Resource: You can use the Personalize Management API to create, edit, delete, and retrieve all existing audiences.

You can now add the audience to a Segmented experience into Variants or to an A/B Test experience as a Target Group for granular targeting of your personalized content.