Overview
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 Create a Content and Survey Activity
📌 Note: From version 2.30, you can also build this content in the new Content & Survey Editor, a single drag-and-drop workspace for content blocks and survey questions. It's rolling out gradually, The steps below describe the existing method, which you can continue to use to create your app content.
Create an Activity
1. In your Subject, click on Create new activity. Next, you'll need to update some required attributes in your new Activity.
2. Enter the Name that will be displayed to users for the Activity.
3. Assign a Topic by selecting an existing topic, or leave it as + Create a topic to create one automatically.
4. Select the Content and Survey Template.
5. Select the desired Template Variant from the available options for the chosen template. - Optional
Available template variation for Content and Survey Template:
Navigation Page (No button, no confirm message on close) | Displays content without a Navigation button or Confirm message while closing. Suitable for informational content pages. |
Onboarding (No close button, 'Continue' button on final screen) | Ends with a Continue Navigation button on the final screen. The Close button is hidden, preventing users from exiting before completing the onboarding flow. |
Content Only (No confirm message on close) | Displays content with standard Navigation buttons and no Confirm message while closing. |
Onboarding Last (No close button, 'Finish' button on final screen) | Ends with a Finish Navigation button on the final screen. The Close button is hidden, making it suitable as the final activity in an onboarding flow. |
Joining Activity ('Continue' button on final screen) | Designed to sit between activities in a Pathway. Displays a Continue Navigation button on the final screen. |
Forced Decision (No button, no close) | Requires users to provide the required response before the Navigation button becomes available. The Close button is hidden to ensure the activity is completed. |
No Favourite | Hides the Favourite button. Suitable for activities that should not be saved, such as onboarding activities. |
Refer to the following image for guidance.
6. Once you've updated your Activity, click Save Changes.
How to Configure a Topic (Optional)
If you selected + Create a topic when creating your Activity you will automatically see a Topic with the same name as your Activity.
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
How to Create Content Blocks in Activities
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 Edit content from the Activities list or details page and then click Create a new content block, which is on the top right-hand side of Creator.
3. Select the Content Type you wish to use.
4. Click Save changes.
How to 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:
At the content block level, you will see a tab called Views.
Click on this and click Create new view.
Fill in the Title and Button label.
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.
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 highlighted earlier in this article, the Content and Survey Activity Template supports two types of Content Blocks: Content-only and User-response.
1. 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.EXTERNAL_MEDIA
To embed external audio and video such as YouTube, Soundcloud, and Vimeo.
2. User-response
These are Content Block types that require a response from the user.
Allows user to input a text response.
Allows user to input a number response.
Shows date selector for user to input a specific date.
Displays multiple predefined options, allowing the user to select only one option.
Similar to multi-choice response, but allows user to select more than one option.
Allows users to upload an image file.
Allows users to input a number using a slider within a pre-determined numeric range.
Shows a list of predefined items. Users can order them according to preference.
For more information on Subjects, Activities, Topics, and Content Blocks, you can refer to the Content Structure Overview article.