Events
Cards
General events

General card events

Events that happen on all cards

Card viewedBeta

Raised when a user views a card.

Example data

{
"id": "54e635de-92f5-4419-a498-5f69323db34c",
"event": "CardViewed",
"timestamp": "2000-01-01T00:00:00.000Z",
// Site
"site_id": "2d5776b8-158a-4216-aaa1-edbc249e005b",
"site_name": "My site",
// Session
"user_session_id": "d40cc0e7-7243-4060-a75f-b2062c94462a",
// User account (if accounts are enabled)
"user_profile_id": "0fdbb943-511c-4220-9266-31465374f43b",
// Any user attributes captured for the session/account will be added as well
// Card
"card_id": "dd0b77cd-35ca-404e-8b23-1d86a7471f78",
"card_name": "card name",
"card_type": "Quiz",
"score": "1",
"correct": "1",
}
NameTypeDescriptionOptional
idGuidA unique GUID identifier of the corresponding componentfalse
eventstringAn event name indicating the type of event that is being raisedfalse
timestampTimestampA timestamp indicating when the corresponding component was createdfalse
site_idGuidA GUID identifier which uniquely represents an active site.false
site_namestringThe name of the given site.false
user_session_idGuidA GUID identifier which uniquely represents an active user session.false
user_profile_idGuidA GUID identifier which uniquely represents an active user profile. Only if profiles are enabled on the hub and the user has signed intrue
User attributesstringIf the user has a profile all attributes captured for their profile will be attached, if not any attributes captured for the user session will be included. Attributes will be listed as separate key value pairs on the webhook body.true
card_idGuidThe unique Id for the card.false
card_namestringThe name of the card indicated by the internal name listed on the card.false
card_typestringThe type of card that this event was triggered from.false
scorenumberThe total number of points for the gameplay.false
correctnumberThe total number questions that the gameplay got correct.false

Card cover clickedBeta

Raised when a user clicks on a card's cover.

Example data

{
"id": "54e635de-92f5-4419-a498-5f69323db34c",
"event": "CardCoverClicked",
"timestamp": "2000-01-01T00:00:00.000Z",
// Site
"site_id": "2d5776b8-158a-4216-aaa1-edbc249e005b",
"site_name": "My site",
// Session
"user_session_id": "d40cc0e7-7243-4060-a75f-b2062c94462a",
// User account (if accounts are enabled)
"user_profile_id": "0fdbb943-511c-4220-9266-31465374f43b",
// Any user attributes captured for the session/account will be added as well
// Card
"card_id": "dd0b77cd-35ca-404e-8b23-1d86a7471f78",
"card_name": "card name",
"card_type": "Quiz",
"score": "1",
"correct": "1",
}
NameTypeDescriptionOptional
idGuidA unique GUID identifier of the corresponding componentfalse
eventstringAn event name indicating the type of event that is being raisedfalse
timestampTimestampA timestamp indicating when the corresponding component was createdfalse
site_idGuidA GUID identifier which uniquely represents an active site.false
site_namestringThe name of the given site.false
user_session_idGuidA GUID identifier which uniquely represents an active user session.false
user_profile_idGuidA GUID identifier which uniquely represents an active user profile. Only if profiles are enabled on the hub and the user has signed intrue
User attributesstringIf the user has a profile all attributes captured for their profile will be attached, if not any attributes captured for the user session will be included. Attributes will be listed as separate key value pairs on the webhook body.true
card_idGuidThe unique Id for the card.false
card_namestringThe name of the card indicated by the internal name listed on the card.false
card_typestringThe type of card that this event was triggered from.false
scorenumberThe total number of points for the gameplay.false
correctnumberThe total number questions that the gameplay got correct.false

Card actionBeta

Raised when a user clicks or interacts with a card's action.

Example data

{
"id": "54e635de-92f5-4419-a498-5f69323db34c",
"event": "CardAction",
"timestamp": "2000-01-01T00:00:00.000Z",
// Site
"site_id": "2d5776b8-158a-4216-aaa1-edbc249e005b",
"site_name": "My site",
// Session
"user_session_id": "d40cc0e7-7243-4060-a75f-b2062c94462a",
// User account (if accounts are enabled)
"user_profile_id": "0fdbb943-511c-4220-9266-31465374f43b",
// Any user attributes captured for the session/account will be added as well
// Card
"card_id": "dd0b77cd-35ca-404e-8b23-1d86a7471f78",
"card_name": "card name",
"card_type": "Quiz",
"score": "1",
"correct": "1",
"action": "Competition",
"link_to": "https://www.komo.tech/",
}
NameTypeDescriptionOptional
idGuidA unique GUID identifier of the corresponding componentfalse
eventstringAn event name indicating the type of event that is being raisedfalse
timestampTimestampA timestamp indicating when the corresponding component was createdfalse
site_idGuidA GUID identifier which uniquely represents an active site.false
site_namestringThe name of the given site.false
user_session_idGuidA GUID identifier which uniquely represents an active user session.false
user_profile_idGuidA GUID identifier which uniquely represents an active user profile. Only if profiles are enabled on the hub and the user has signed intrue
User attributesstringIf the user has a profile all attributes captured for their profile will be attached, if not any attributes captured for the user session will be included. Attributes will be listed as separate key value pairs on the webhook body.true
card_idGuidThe unique Id for the card.false
card_namestringThe name of the card indicated by the internal name listed on the card.false
card_typestringThe type of card that this event was triggered from.false
scorenumberThe total number of points for the gameplay.false
correctnumberThe total number questions that the gameplay got correct.false
actionstringThe action being performed. "Competition": an image card opening a competition, "ExternalLink": a link to an external site, "ScrollToCard": scroll to another card on the hubfalse
link_tostringThe link or card Id that the card links to if any.true

Card sharedBeta

Raised when a user shares a card from a hub.

Example data

{
"id": "54e635de-92f5-4419-a498-5f69323db34c",
"event": "CardShared",
"timestamp": "2000-01-01T00:00:00.000Z",
// Site
"site_id": "2d5776b8-158a-4216-aaa1-edbc249e005b",
"site_name": "My site",
// Session
"user_session_id": "d40cc0e7-7243-4060-a75f-b2062c94462a",
// User account (if accounts are enabled)
"user_profile_id": "0fdbb943-511c-4220-9266-31465374f43b",
// Any user attributes captured for the session/account will be added as well
// Card
"card_id": "dd0b77cd-35ca-404e-8b23-1d86a7471f78",
"card_name": "card name",
"card_type": "Quiz",
"score": "1",
"correct": "1",
// Share
"social_platform": "facebook",
}
NameTypeDescriptionOptional
idGuidA unique GUID identifier of the corresponding componentfalse
eventstringAn event name indicating the type of event that is being raisedfalse
timestampTimestampA timestamp indicating when the corresponding component was createdfalse
site_idGuidA GUID identifier which uniquely represents an active site.false
site_namestringThe name of the given site.false
user_session_idGuidA GUID identifier which uniquely represents an active user session.false
user_profile_idGuidA GUID identifier which uniquely represents an active user profile. Only if profiles are enabled on the hub and the user has signed intrue
User attributesstringIf the user has a profile all attributes captured for their profile will be attached, if not any attributes captured for the user session will be included. Attributes will be listed as separate key value pairs on the webhook body.true
card_idGuidThe unique Id for the card.false
card_namestringThe name of the card indicated by the internal name listed on the card.false
card_typestringThe type of card that this event was triggered from.false
scorenumberThe total number of points for the gameplay.false
correctnumberThe total number questions that the gameplay got correct.false
social_platformstringThe name of the social platform that will be used to share content to.false