Skip to main content

Content structure overview

An overview of Cogniss's underlying content structure and what are Subjects, Topics, and Activities.

Ryan Miller avatar
Written by Ryan Miller
Updated over 2 years ago

Introduction

All apps created on the Cogniss platform have the same underlying content structure.

This guide will explain the main principles behind how content is structured, which is essential in understanding how to create your application.


Subjects

A Subject is a hierarchical layer used to group Activities within Cogniss applications and is the highest level of content. To a user, Subjects do not provide any content but are important in grouping relevant Activities together. Therefore, Activities must be placed inside a Subject.

You can create a Subject in the content tab of Creator and enter a name that will be visible to the user when navigating to the Explore page of your mobile app. This name will be useful when analysing user activity in Insights. Additionally, you can provide your Subject with an icon and description.


Activity

An Activity is a single experience your users go through in your app. Every Activity needs to be paired with a Topic and an Activity Template.

  • Topic - made up of a collection of Content Blocks.

  • Content Blocks - text, images, audio, videos, multiple-choice questions, etc.

  • Activity Template - specifies how content is experienced by your users. The most popular Activity Template used to display content in Cogniss-powered apps is Content and Survey.

The Activity Template you choose will determine the type of experience your users will have.

An Activity can be anything from a single screen of content, a collection of multiple screens of content, to an interactive game or VR experience.

Pathways

A type of Activity Template used to define the flow and conditions for a collection of Activities that allow them to be experienced together.

Content Blocks and Topics

Content Blocks are the most basic unit of content in Cogniss. There are a variety of content types in the Cogniss platform such as images, videos, audio, text, multiple-choice questions, embedded web elements, and more. These different content types can be structured in different ways. The supported content type corresponds to the Activity Template being used.

Content Blocks are grouped under Topics. When creating an application, it is important to consider how to group individual Content Blocks into relevant Topics.


Activity Template

An Activity Template determines the type of Content Block you can use. This is important as certain types of content must be added into Cogniss Creator in a way that makes sense for a particular Activity Template.

For example, most content types can be supported in the Content and Survey Activity Template. However, the Mass Mutations or Categorise Activity Templates can only support content in a multiple-choice format.


Views

This is a method of grouping 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.

In the example structure shown in the image above, the user is shown Content Blocks 1, 2, and 3 together as part of View 1. They must complete the content and click continue (next view) on the mobile/web app before they see Content Blocks 4 and 5 in View 2.

Say Content Block 1 was a multiple-choice question, Content Block 2 was some text content, and Content Block 3 was a video. They will be presented to the user in the order of 1, 2, and 3. You can change the order in Creator.

Note: For a step-by-step guide on how to organize and group Content Blocks using Views, check out this article.

Did this answer your question?