Audiences

Audiences enable you to target variations of content at visitors who match a particular set of characteristics for the purpose of personalisation.

Creating Audiences

Before you can create an audience, you’ll need to have defined one or more audience attributes. For more information, please see the audience attributes section.

To create an audience:

1. Navigate to the Audiences > Audiences section of your spaces control panel
2. Click the Create Audience button
3. Enter a name for your audience
4. If desired, update the auto-generated audience key (this must be unique within your space)
5. Click Create Audience

Configuring Audience Conditions

After you have created an audience, you can begin to configure the conditions that a visitor must meet in order to be included in that audience.

When configuring audience conditions, there are three condition types to choose from:

Attribute Conditions

To configure an Attribute condition:

1. Create a new audience, or open an existing one
2. Scroll down to the Audience Conditions configuration, and click the Add Condition button
3. From the dropdown that appears, choose Attribute
4. Select which attribute you would like to compare against
5. Choose which type of comparison you would like to make (these will vary depending on the type of attribute being compared, see below for more details)
6. Input the value that you would like to match against
7. Repeat the above steps to add more conditions, or if you’re finished click Save Changes to save your audience

Attribute Comparison Types

As mentioned above, the types of comparison that can be made against an attribute will depend on the type of the attribute itself.

Boolean

Number

Text

And/Or Conditions

To configure an And or an Or condition:

1. Create a new audience, or open an existing one
2. Scroll down to the Audience Conditions configuration, and click the Add Condition button
3. From the dropdown that appears, choose either And or Or
4. Within the condition group that appears, click the Add Condition button
5. Select the type of condition that you would like to add to the condition group. This can either be an Attribute condition or another And or Or condition (Note: condition groups can only currently be nested up to two levels deep, beyond this you can only add attribute conditions)
6. Once you have finished adding new conditions, click Save Changes to save your audience

Assigning Audiences to Content Variations

Once you have finished creating and configuring your audiences, all that’s left is to setup which content variations should be delivered to which audiences.

To assign an audience to a content variation:

1. Navigate to the Content section of your spaces control panel
2. Create a new content item, or open an existing one
3. Within the content item, create a new variation or open the one which you would like to target
4. Looking at the sidebar of the content editing screen, click the Add Audience link
5. From the modal that appears on screen, select the audience that you would like this variation to target
6. Click Confirm
7. If you are done editing your variation, click the Save Changes button to save your variation

Retrieving Personalised Content

Now that you have defined your audience attributes, configured your audiences and assigned your audiences to some variations, you can begin requesting content which is personalised to the intended audience.

Retrieving personalised content is as simple as providing some additional context with each request to the Content Delivery API. This context will then be used to calculate which audiences the request fits within, allowing us to return only the content which is targetted at that audience.

For more information on how this works and for some code examples, please see the request context section of the Content Delivery API documentation.