Overview

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?

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:

  • Development
  • Testing
  • Everyone

You will enable or disable a skill for an audience on the skill page.

 

Using Audiences

Development

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.

Testing

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.

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

shows audiences section

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

shows new audience button

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

 

User-based Audiences

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.

shows replace user list

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.

 

Region-based Audiences

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

shows delete user

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.

shows region with the x next to the name

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

shows delete 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.

confirm delete

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.

Was this article helpful?
0 out of 0 found this helpful