User Guide  /  undefined  /  

Audience Targeting

What is Audience Targeting?

Audience targeting allows you to set custom attributes against user via the SDKs and target specific content to them using those attributes and their values using the CMS.

Audience Targeting is currently only available for Stories and Story Pages, not Clips.

E.g
Storyteller.user.setCustomAttribute(key: "location", value: "NewYork")


Determining User Properties

  1. Firstly you will need to determine what custom attributes you want to add to your user base

  2. This process can be found in our Developer guides here

How to target stories at a specific group

  1. Go to your Storyteller tenant

  2. Select the Story you want to start targeting to your audience

  3. In the Publishing Tab on the right hand side, there is an option to “Target this Story to an Audience”

  4. A User Property and Value input then appears.

  5. Select the input to input and create your new User Property and respective Value, these must be the same as whatever custom attributes that have been determined in the code.
    Once you have set the user property and value, this will automatically be saved.

  6. To remove, please select the bin icon next to the User Property and Value.

How to target pages at a specific group

  1. Select the Story containing the Page you want to target.

  2. Click the three-dot menu (⋯) on the top-right corner of the Page.

  3. Select Page Settings.

  4. In the modal, click Add Property.

  5. In the same method as Story targeting, choose the User Property, Condition, and Value.

  6. You can add up to 5 audience rules per Page.

Setting multiple attributes

If you set multiple attributes, then all of them have to match in order for the story to appear. So if we take the example below where we set the following attributes:

  • favoriteSport - NFL

  • location - US

If a user has NFL set as their favorite sport and is based in the US, then they will see this story in their app.

However, if they have NFL set as their favorite team and are based in the UK, they will not be able to see this story in the app.

Values - Reference Tables

The following tables show a list of example Custom Attributes that can be used for each User Property:


Go to the top