Sometimes analyzing ordinary HTTP requests is not enough. To better understand your visitors' behaviour, you can use custom events sent from their browsers (via JavaScript).

Qpackt exposes an endpoint where an event can be posted. Each event is saved together with its payload and some more stats. Sending an event is as simple as calling the sendEvent function with some parameters:

<script src="/qpackt/event/send_event.js"></script>
<script lang="js">
    sendEvent(`EVENT_NAME_${some_variable}`, {variable: {x: 0}}, 0)
</script>


You need to provide three parameters to the sendEvent function:

• Event name - any string that explains the meaning. Can be created dynamically by string format.
• Custom payload - any JSON will do.
• Visitor ID - use 0 to get Qpackt to calculate it with the same algorithm as for other requests. You can change it to any other value (for example, if you get the visitor's permission, you can use a value from localStorage).

Collected events will be visible in Analytics page in Qpackt's admin console. You will see a breakdown per version, with option to download events as CSV. The CSV file will contain:

• ID - The event ID.
• Time - Event's time.
• Version - Web page version at which the event happened.
• Visitor - Visitor ID (calculated by Qpackt or assigned by your code).
• Params - Http url params
• Path - Url path (without params)
• Payload - Event payload as JSON