Overview of the Event hub
The Event hub is a central place for account owners to connect user events happening in iQualify to actions in other apps and systems.
When a learner does certain things in iQualify - views a page, submits a task etc. - we capture data about that "event" (e.g. for the viewed a page event - who viewed that page and at what time).
Tip: If your course, pages, tasks or quizzes have tags attached, your event will include that tag data too.
You can choose to send that data somewhere such that whenever event 'x' happens, event data is sent to 'y' (connected app, zapier, spreadsheet etc.).
You can direct a single event towards multiple apps. And you can create reports, monitor trends, access detailed engagement reporting and automate workflows.
For instance, you can capture information about how and when an assessed task is marked, and send it to a spreadsheet to have a separate record you can analyse or store.
You might analyse multiple classes results to se how they and the quiz performed. Or you might analyse marking data to see how quickly results are given to learners. There are loads of things you can learn from this data!
Benefits of using the Event hub
Using iQualify's Event hub and the Webhook mechanism you can:
Automate data collection into your data warehouse for learning analytics purposes.
Work more efficiently by automating workflows.
Integrate iQualify with your organisation's systems and applications.
Extend iQualify to meet your organisation's and your learners' specific needs.
Experiment with new ways of doing things and support innovative approaches in your organisation.
Learn more: We have a whole range of Examples of how you can integrate and automate with iQualify to give you more ideas!
How the Event hub works
In the Event hub, you can select the user events you want to share with other apps and set up one or more “hooks” (called webhooks). Whenever the event happens, the event data will automatically be sent to the connected apps and systems via the webhook.
A webhook is characterised by:
an endpoint url, for example https://webhook.site/a3d8d982-0354-4e06-91e6-16c6b32ac472.
some possible parameters (headers).
event data structure defined in the JSON format, which might include:
the event name, e.g. “Submitted a practice quiz”
data about the specific event, e.g. the name of the quiz, the date and time it occurred
data about the course where the event occurred
data that identifies the user who actioned that event
Developers of external apps, or automation tools such as Zapier, will “wait” for the event at the webhook’s endpoint URL. When it occurs, they will use the other webhook information to interpret the data they receive and implement the desired response to the event (the action). In technical terms they implement a “callback function” at that URL, to perform the action you want in response to the event.
Once an event has been configured and activated in the Event hub, every time the event occurs, the data for this event will be sent to the webhook and thus to any other systems that are connected to it.
How to get to the Event hub
Head to iQualify settings (found under your avatar) and choose Integrations from the left menu.
Then choose Event hub.
Available events and data
We track a number of events in iQualify covering learner interactions with content, assessment and social engagement with other learners. We also track course creation, publication and user management, such as access to courses and payments.
As well as its Name, the event carries a set of data. You can see example data associated with events in our Developer documentation (Show example data within each event in the Event bub will also take you straight to the right example dataset).
