Skip to main content

Content and Survey Activity Template

This is the primary built-in Activity Template used to present content in Cogniss-powered apps.

Raymond Gerardino avatar
Written by Raymond Gerardino
Updated this week

This Activity Template supports two types of Content Blocks:

  • Content-only: These are simply displayed to the user and do not gather any response from the user (eg. images, videos, text, and embedded web elements).

  • User-response: These can gather responses from the user (eg. multi-choice, text responses, and multi-response).

This Activity Template also supports Cogniss Markup Language (CML) β€” which you can use to personalize text content for your users.

Example of the Content and Survey Activity Template in Web and Mobile view.

Content in this Activity Template is highly configurable in the way it is presented to the user.

  • With this Activity Template, you can use any type of Content Block β€” text, images, videos, external media, multiple-choice questions, collapsible content, and more.


How to set up

1. Create an Activity

In your Subject, click on Create new activity. Next, you'll need to update some required attributes in your new Activity:

  • Name = The name displayed to the user for the Activity

  • Topic = You can leave this as + Create a topic or you can assign an existing Topic to the new Activity

  • Template = Select the template type you require for your new Activity. You can learn more about Activity Templates here.

Once you've updated your Activity, click Save Changes.

2. Create or edit a Topic

After you have created an Activity, you need a Topic in which to start adding your content. You can access a Topic by clicking on Edit content in the Activities tab or by navigating to the Topics tab.

If you selected + Create a topic when creating your Activity you will automatically see a Topic with the same name as your Activity. If you need to create a Topic you can click on Create new topic in the Topics tab.

The default attributes in a Topic are:

  • Topic type = SURVEY

  • Content type = MIXED

If you want to create a survey with scoring, you can update the Topic type to

SCORED_SURVEY

3. Create a Content Block

To create a Content Block, navigate to the Content tab of the Cogniss creator sidebar.

  1. Ensure you have created an Activity and Topic for your Content Block to be placed in.

  2. Click the relevant Topic and then click Create new content block, which is on the top right-hand side of Creator.

  3. Edit the Content Block as you wish.

  4. Click Save changes.

4. Group Content Blocks using Views

You can edit your app user experience by grouping Content Blocks into Views. It is a method of combining Content Blocks so that they are shown on a single page/screen of your app. Using Views reduces the number of times a user has to click to the next page/screen of your app.

To create a View:

  1. At the Content-Block level, you will see a tab called View. Click on this and click Create new view.

  2. Fill in the Page label and Button label.

  3. Add the Content Block you wish to include in this particular View using the dropdown option. To add more Content Blocks to this View, click Add content block.

  4. Click Save changes.

    If you wish to change the order of the different Views (app pages/screens), you can re-order them using the drag-and-drop button. Keep in mind that the top most View is the first page/screen your users will see.


Types of Content Blocks

As mentioned earlier, the Content and Survey Activity Template supports two types of Content Blocks: Content-only and User-response.

Content-only

These are Content Block types that do not require a response from the user.

  • TEXT_CONTENT

    • Displays selected text.

  • IMAGE_CONTENT

    • Displays a selected image.

  • COLLAPSIBLE_TEXT_CONTENT

    • Displays a text box that expands to show the full content once clicked on.

  • WEBSITE_VIEW

    • To display external websites.

    • To embed external audio and video such as YouTube, Soundcloud, and Vimeo.

User-response

These are Content Block types that require a response from the user.

  • TEXT_RESPONSE

    • Allows user to input a text response.

  • NUMBER_RESPONSE

    • Allows user to input a number response.

  • DATE_RESPONSE

    • Shows date selector for user to input a specific date.

  • MULTICHOICE

    • Displays multiple predefined options, allowing the user to select only one option.

  • MULTISELECT

    • Similar to multi-choice response, but allows user to select more than one option.

    • Allows users to upload an image file.

  • SLIDER

    • Allows users to input a number using a slider within a pre-determined numeric range.

  • SEQUENCE

    • Shows a list of predefined items. Users can order them according to preference.

For more info on Subjects, Activities, Topics, and Content Blocks, refer to Content structure overview.

Did this answer your question?