Table of contents
- How Zuko works
- Key terms
Zuko is a SaaS platform designed to help you understand how your website visitors are interacting with your online forms, surveys and checkouts.
How Zuko works
Zuko works by tracking your site visitors when they:
- View your form
- Interact with your form’s fields
- Successfully complete your form
From the data that we collect, we calculate the metrics that enable you to discover the issues that your visitors encounter whilst interacting with your forms. This data is made available through the Zuko app.
A visitor is someone who interacts with your form and is given a unique ID. Their unique ID is persisted across all forms on the same domain.
A session represents a period of activity from when a visitor first views your form, then interacts with it, to when they either complete the form or stop interacting with the form. If a visitor is inactive for more than 30 minutes, the session will expire and Zuko will class this session as abandoned. Subsequent events from this visitor after 30 minutes of inactivity will create a new session.
A slug is a unique identifier for your form on your domain. When events are sent to the Zuko platform, they include the slug and domain from where the event originates. When combined, slug and domain form a unique identifier for a form on the Zuko platform.
The domain that Zuko uses is the domain that your site is on, ignoring subdomains.
Here are some examples of URLs and the domain that will be used by Zuko:
Any standard HTML element can be tracked as a form in Zuko.
Zuko tracks interactions on these types of HTML elements:
type="hidden"is not a supported attribute for an
<input>element as visitors are unable to interact with these fields.
typeis not a supported attribute for a
typeis not a supported attribute for a
Along with a field’s
tagName, Zuko records three optional HTML attributes for each field:
It is important that your fields can be identified by a combination of the field’s tagName and these three HTML attributes. Your account manager will then help to label your fields to easily view them in the Zuko app.
Zuko tracks the following standard event types on your fields:
Zuko allows you to assign attributes to a visitor’s session. You can then compare segments of visitors, and explore certain behaviours and outcomes across segments.
By default, Zuko will automatically detect and track a series of attributes for you.
The browser that the visitor used to interact with the form
The type of operating system that the visitor used to interact with the form
The device type that the visitor used to interact with the form
Determines if the visitor is new to the form, or is returning to the form
Identifies if the visitor used autofill on your form
Once you setup traffic medium tracking, Zuko will automatically detect and track this attribute for you.
This attributes describes the medium that the visitor came through to reach your website
You also have the ability to push any information you collect about your visitors into the platform. An attribute is a piece of information about a visitor. Custom attributes are intended to segment your form’s sessions, they are not intended to be used for identifiers.
Examples of custom attributes are:
Visitors will encounter specific types of events when interacting with your form. For example, they may encounter field errors or see promotional messages.
Zuko can track these custom events as and when they occur throughout a visitor’s session. Even if they occur multiple times for the same event type, you can send as many custom events as you need.
Custom events are sent simply as a short string to describe the event type.
Examples of custom events are:
Email field: email invalid
Promotion: 20% discount code
By default, Zuko will automatically track this custom event:
Autofill triggeredIdentifies the first time the visitor used autofill on your form
During a session, visitor will interact with a field – for example the email field – then proceed on to the password field, then attempt to submit the form.
At this point, validation on the form may stop the form from being submitted if the email is not valid. The visitor would then return to the email field to correct their mistake before attempting to submit the form again.
This is classed as a field return. Any number of field returns my occur within a session.
The term flurry covers the time between a visitor starting and stopping interacting with a particular field in your form, before progressing on to another field in the form. During this time, we receive a group of related events for this field and we refer to this as a flurry of events.