When integrating iQualify with other apps using the API or the Event Hub, you can pass additional information about courses and course activations to these other apps using custom tags. This information can help with the integration (e.g. using the course code) or it could allow the filtering of courses according to location, target market, or any other additional criteria that is important to your organisation. Tags can be added to a course or a course activation at any point in time.
β
Once you have decided which information you want to add to a course, you can enter this information into iQualify in several ways.
Add tags as an author
As an author, you can set goals/outcomes for a course and you can also tag various levels of course content.
You can add tags to:
The course as a whole
Individual pages
Individual tasks or quizzes
Check out Adding goals and custom tags to a course as an author for full instructions.
Add tags with manage access
As a manager, you can add tags under Details when you are editing a class activation. See Editing the details of a class activation for full instructions.
Add tags as an integration engineer
As an integration engineer, you can also add or update tags for an editable course using the Update course tags API.
To add or update tags for an active course you can use the Update offering tags metadata API.
The process for updating via the API is similar to the one for updating user tags, described in the following article: Adding tags to users using Zapier.
Note: A task will get a new taskId whenever it is edited by an author. However, the tag for that task, will remain the same. This is why it's a good idea to use tags for tasks when creating any integrations etc.
Why add goals and tags?
But why would you allocate tags to a course, page or task? Well it means that the course/page/task now has extra data attached that you can use to filter, find or group things. For example:
Maybe you want to add a course code tag to let you map the iQualify course to your SMS and/or course catalogue?
Maybe you want to add a region/location tag to courses to allow you to filter/select class activations by campus location?
Maybe you want to add page tags to see if there's a pattern in which pages learners are getting the most visits? For instance:
Are most learners are skipping the pages relating to LO1.2?
Are learners repeatedly viewing pages with discussions or assessments?
Are learners are skipping the tasks that scaffold to the first assessment and then doing poorly in the assessment?
For more detail and examples see Why use custom tags to add information to users and courses.
Understanding events and associated data
To understand a little more about how this works and what needs to happen... we need to talk about events within iQualify and how you can gather data about events and send them somewhere e.g. to a spreadsheet.
When a learner does certain things in iQualify - views a page, submits a task etc. - we capture that "event". And events can have other data associated with them for instance in terms of viewing a page, we also capture who viewed that page and at what time.
And account owners can setup events such that whenever event 'x' happens, event data is sent to 'y' (connected app, zapier, spreadsheet etc.).
If your course, pages, tasks or quizzes have tags attached, your event will have that tag data too.
This means, if you're capturing data about the viewed a page event, you can use those goals/tags to filter, find, or group. You can get more insights from the event. For instance, you could group pages with the tag "Discussions" and pages with the tag "Video" to see which are getting more views.
Other articles you may be interested in:
Adding goals and custom tags to a course as an author - As an author, you can add tags to your course, and pages and tasks within your course to help you analyse data and find trends.
Why use custom tags to add information to users and courses - You can improve the effectiveness of connecting iQualify with other apps by adding custom information to users and courses in iQualify.
Overview of the Event Hub - As an account owner you can use the Event Hub to configure events in iQualify to trigger actions in other apps and systems.
Webhook endpoints - Find out what a webhook is and how they work with iQualify's Event Hub.
How to configure webhooks in the Event Hub - Account owners can configure webhook endpoints to automate processes or generate reports outside iQualify
How to use Zapier with the Event Hub - Account owners can create integrations between the Event Hub and Zapier to automate tasks
β
β