Using Custom Attributes

Zuko’s Form Analytics platform shows you where visitors struggle with your forms. Attributes and custom attributes let you segment our behavioural data into groups of visitors.

Think of custom attributes as information you collect about your customers that can be used to identify interesting groups or segments and spot patterns of behaviour. You are likely already collecting these, and Zuko’s custom attributes allow you to explore these segments in our reports to see their effect on form behaviour.

Zuko gives you the power to go in-depth into how your visitors really interact with your forms or checkouts. You can deepen your understanding of your visitor behaviour by pushing custom attributes into Zuko.

How custom attributes help

Segmenting data helps you link form behaviour problems to a group of visitors. For example, you may have a high drop-off rate on a field, and by using segmentation you find that mobile visitors who use Safari are struggling with it. Or you have a high return-to-field rate and segmentation shows that a specific PPC campaign is delivering visitors who struggle to complete your forms.

Organisations have their own ways of segmenting data; it could be by basket value, affiliate ID, or the service/product category. Our custom attributes allow you to push in this data, then segment your form behaviour data by the metrics that are important to you.

Examples of custom attributes:

Our built-in attributes

Zuko automatically adds two attributes to your forms:

Segmenting your data by device type can show you where your most problematic customer form experiences lie. You may notice specific fields on mobile devices have high abandonment vs other device types or that visitors return to fields more in a particular browser.

Where in the reporting interface are custom attributes?

Custom attributes appear in the filter list/dropdown on:

Here’s an example of custom attribute selection on the Form Aggregate report.

The filter box lists all the available attributes and values. You can add as many custom attributes into a filter as you like, on average our customers add a maximum of three attributes in a view.

How do custom attributes help you optimise forms?

Zuko helps you uncover issues in your forms. Issues are often related to groupings of visitors; for example, you may have an issue with your form UX on iOS devices within the Safari browser, or your visitors may be slowed down on Chrome because of autofill issues on Android. Custom attributes help you isolate segments of visitors that have issues.

In the Zuko Form Aggregate report you can see overall form metrics for specific custom attributes:

In Field Aggregate you can see an overview of the issues that a segment has. In the example below you can see where Chrome visitors struggle in your form. Marked in red are the three fields that account for the most abandonment, field time and field returns.

In Session Explorer you can see how abandoned sessions playout for your chosen custom attributes – visitors coming from different sources can behave very differently.

Finally in Segment Comparison you can compare segments side by side – with an interactive graph at the top that highlights key metrics, and a table below that breaks down behavioural data. This is a powerful way to find optimisation opportunities in your online forms, as it will show you the weakest customer segments. You can then go on to the main Form Aggregate and Field Aggregate reports to find out what causes that segment to suffer.

How do I start tracking custom attributes in Zuko?

Our documentation will guide you on how to add custom attributes. The code that you deploy will look something like this:

<script src="https://assets.zuko.io/js/v2/client.min.js"></script>
<script></script>
 Zuko
   .trackForm({
     target: document.getElementById('checkout-form'),
     slug: 'checkout'
   })
   .setAttribute('testing-variant-id', 'test13-inline-validation')


In the example the .setAttribute is used to store the variant ID of a UX test. The attribute key, or name, is “testing-variant-id” and the value being sent is “test13-inline-validation”.

A custom attribute consists of two strings which represent a key-value relationship. For example, key: marketing-source, value: google.
There are no limits on the number of custom attributes you can track.

Note that both the key and value are limited to 85 characters long. If they are longer than 85 characters the attribute will not be accepted.

Frequently Asked Questions

If you have any questions about how custom attributes can work for you or would like a demo of Zuko please get in touch sales@zuko.io

See more guides
zuko full colour logo
Formisimo Ltd, Colony, 5 Piccadilly Place, Manchester, M1 3BR
VAT Number: GB181252425
Registered in England as company number 08859680
New Business: sales@zuko.io
Support: support@zuko.io