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.

Prerequisites

• 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.

Steps for Execution

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. In the left navigation panel, click the Personalize icon.
   
2. You will be redirected to the Personalize Projects landing page. Click the project for which you want to create an audience.
   
3. Click the Audiences tab in the left navigation panel. From the Audiences page, click the + New Audience button.
   
4. 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.

   

5. 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.

Next Steps

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.