Audience Plugin Usage Guide

The Audience app enables content teams to create targeted and personalized experiences for their audience. The Audience app helps improve content relevance and drive better user engagement.

Consider a scenario where you have to display different content on your university website for faculty members, students, and staff. Creating multiple entries with additional content for various audiences can be time-consuming.

In this case, the Audience app allows you to define your audiences once and then reference them in your entries. This approach makes your content audience-centric and improves its reach.

Prerequisites

• Contentstack account
• Access to the Contentstack Organization/Stack as the Owner/Admin

Let's follow this step-by-step guide to install and configure the Audience app in your stack.

Steps for Execution

1. Define your target audience
2. Install the Audience app and configure it with your audience
3. Use the Audience app within your entry

1. Define your Target Audience

   1. First, you must define the target audience. For this, you need to create a content type with following fields:
      1. Title: A Title field represents the audience group, such as University in our example.
      2. Group: A Group lists all audiences. While adding the group field, go to the Advanced properties option and set it to Multiple. If required, you can also set the maximum number of instances that you can have inside the group field.

         Then, you will need to add the following two fields inside the Group field:

         1. Group Title: A Single-Line Textbox field for the audience title.
         2. Group Description: A Multi-Line Textbox field for describing the audience.

         Once you have added these details to your content type, click Save and Close.

         

         Note: Copy the Content Type UID of the Audience content type, UID of the Group field, and Group Title Field UID. We will need these UIDs in the Audience app configuration settings in step 2.

   2. Now, you can create an entry in the Audience content type. To do this, from the left navigation panel, click Entries and then click + New Entry. In the Select Content Type modal, select Audience (content type created above) and click Proceed.

      For the University example, we will name (Title) this entry as University which will contain information about Faculty Members, Students, and Staff (refer to the following screenshot where we have added details about Faculty Members, Students, and Staff).

      Note: You will refer to this entry in step 3 when rendering the target audience.

      

2. Install the Audience app and Configure it with your Audience

   To install the Audience app, log in to your Contentstack account and follow the steps below:

   1. From the left-hand side primary navigation, click the Marketplace icon.
   2. Click Apps from the left panel.
   3. Within the Marketplace, you can see all the available apps. Hover over the Audience app and click Install.
   4. In the pop-up window, select the stack where you want to install the Audience app and click the Install button.
   5. On the Configuration screen, enter the Audience Content Type UID, UID of the Group field, and Group Title Field UID that you retrieved and copied in step 1.
   6. Click the Save button.
   7. On the UI Locations tab, you can see the predefined app locations. You can use the toggle button corresponding to each UI location to enable or disable it based on your requirements.

      For the Audience app, JSON RTE and Custom Field are the two UI locations. You can only enable or disable the Custom Field UI location.

      

      Additional Resource: For more information on UI locations, please refer to the Installed Apps guide.

   8. Click Open Stack to start using the plugin within your stack.

3. Use the Audience App within your Entry

   To render the University data that we created in step 1 for Faculty Members, Students, and Staff, you now need to create another content type, for example, Institution. In this content type, we can select the audience and render the respective data.

   To use the Audience app within an entry of your stack, follow the steps given below:

   1. Go to your stack and click the Content Models icon in the left navigation panel, and click the + New Content Type button.
   2. Create a content type (consider an example Institution) by adding relevant details as displayed below:

   There are two ways to use the Audience app in your entry:

   1. Custom Field
   2. JSON Rich Text Editor Field

   Steps to use the Audience App as a Custom field

   1. On the Content Type Builder page, add a Custom field in your content type by clicking the Insert a field link represented by a + sign.
   2. Under Select Extension/App, select Audience, and click the Proceed button.

      Change the Display Name of the custom field to your choice, for example, Audience Custom Field. Optionally, you can add Help Text and Instruction Value for your custom field.

      This adds the Audience app in the custom field.

      
   3. After adding the app in a custom field, click Save or Save and Close to save your changes.
   4. To use the Audience app, create an entry for this newly created content type. To do this, on the left navigation panel, click Entries and then click + New Entry. In the Select Content Type modal, select Institution (our example content type) and click Proceed.

      You can see the Audience app’s custom field on your entry page as shown below:

      
   5. Click the Add Audiences button.
   6. In the Select Audience modal, select the target audience for your content (Faculty Members/Students/Staff) and click Add Selected.
   7. The audiences you added get referenced within your entry.
   8. After adding the audience, Save and Publish your entry.

   Steps to use the Audience App as a JSON RTE Plugin

   1. On the Content Type Builder page, add a JSON Rich Text Editor field in your content type by clicking the Insert a field link represented by a + sign.
   2. Under Select JSON RTE Plugin(s), select Audience, and then click Add Plugin(s).

      This adds the Audience app in the JSON Rich Text Editor field.

      
   3. After adding the app in a JSON Rich Text Editor field, click Save or Save and Close to save your changes.
   4. To use the Audience app as a JSON RTE plugin, create an entry for the content type. Within the JSON Rich Text Editor, add your content and click the Audience app icon to customize which target audience can view the specific content. You can also select the text and click the Audience app icon from the toolbar.
   5. In the Select Audience modal, choose the following:
      1. Audience Tag Scope: Select the scope for the Audience tag. There are two scopes: Block (supports elements such as lists, tables, and images) and Inline (supports text).
      2. Audience Selection: Select the target audience for your content (Faculty Members/Students/Staff).
      3. Once done, click Add Selected.
      

      Now, the content you add would be visible to the Faculty Members, Students, Staff, or all. You need not to create separate entries to add different content. You can use the Audience app and customize your content as per your target audience.

      In the following example, Faculty Members and Students data are in the Block scope, while Staff and University (All) data in the Inline mode.

      
   6. After adding the audiences, Save and Publish your entry.