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.

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:

Check out Adding goals and custom tags to a course as an author for full instructions.

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.

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.

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:

For more detail and examples see Why use custom tags to add information to users and courses.

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:

​
​