The ability for an end user to receive the insights an Andi® skill provides depends on whether the skill is enabled or disabled. Audiences provide you with the ability to determine what group of users or regions are able to see an enabled skill. This article will cover what audiences are, their use cases, and how to manage the audience(s) a user or region belongs to.
In this Article
- What is an Audience?
- Using Audiences
- Managing your Audiences
- Deleting an Audience
What is an Audience?
An Audience consists of a group of application users or regions within an organization who are able to see an enabled skill.
The Andi® platform contains the following default audiences:
You will enable or disable a skill for an audience on the skill page.
When a skill is deployed, it will go to the development audience. The lifecycle of all skills will start with this audience and allows any user in this audience (such as a user with the skill developer security profile) or region, to complete initial testing of the skill in the application to ensure the skill code functions properly before publishing a new skill or testing out future versions of a skill while the current version remains enabled for everyone.
The next stage to advance a skill version is the testing audience. Like the Development audience, this allows you the opportunity to test out a new skill or future versions of a skill while the current version remains enabled for everyone. This audience is best utilized for a small group of end users of the application with skill testing permissions in Andi® (such as a user with the skill tester security profile) to test out the functionality of the skill, before a complete roll out of the skill to everyone.
The users of this audience are the complete set of end users of the application. Any user with an active account in the application will be able to see the enabled skill. Because the everyone audience is for all users of the application, you will not be able to make any changes to it in the Audiences Admin page tab.
Managing your Audiences
Administrators with the Manage Audiences permission will be able to add or remove users and regions from the Development and Testing audiences in the Andi® Skills Manager.
On the Admin page, select the Audiences tab.
Creating a New Audience
To add a new Audience, select Create Audience.
Enter a name for the audience in the Audience Name field. This is the name that will show in the Audiences drop-down on the skills manager dashboard, as well as on the skill details page in the Audiences section. Note: The audience name must be unique.
In the Audience Type drop down, select whether the audience will be based on Usernames or Regions. Audiences based on users allow you to group specific people together, whereas audiences based on regions allow you base your audience on particular location(s).
In the Usernames in Audience section, enter the user's email address as it appears in the application.
Repeat this process for as many users as you need to add to the audience, adding a comma after each user. When complete, select the Save Changes button.
To add multiple users to an audience at once, select the Replace Current User List hyperlink to upload a .txt file from your computer with a list of users.
Verify the information you've uploaded is correct, then select the Save Changes button to add the users.
In the Regions in Audience drop down, choose which regions you would like to add to the audience. You can add as many regions as you would like by selecting each one. The Regions displayed here are the same Regions that are shown in your PrecisionLender account.
Once you've added all the appropriate regions, select the Save Changes button.
After adding your user(s) or region(s) to the appropriate Audience, you can then enable a skill for that particular Audience.
Removing a User or Region from an Audience
To remove a user from an audience, highlight the email address of the user from the list in the audience you're removing the user from, then hit the delete button on your keyboard.
Repeat this process for as many users as you need to remove from the audience. Select the Save Changes button to apply your changes.
To remove a region from an audience, select the Regions in Audience drop down and then click the 'x' next to the audience name. Select the Save Changes button to apply your changes.
Deleting an Audience
To remove an audience completely, select the Delete Audience button. If the audience you are trying to delete is enabled in any skills, you will need to disable the audience in those skills first.
In the pop-up window, confirm that you would like to remove the audience by selecting Delete. This action cannot be reversed. Note: The Development and Everyone audiences cannot be deleted.