HTML Tags

Decorate your HTML elements with unique, stable, and descriptive attributes.

JavaScript

data-nid-target="{value}"

Adding attributes to HTML elements is a technique commonly used for analytics and data tracking purposes. These attributes serve as the metadata necessary to identify and track specific elements on a webpage uniquely.

If you do not already have unique, stable, and descriptive attributes for your webpage, NeuroID recommends adding data-nid-target attributes to your HTML form elements, e.g., data-nid-target="firstName" or data-nid-target="mobilePhone".

Why are they necessary?

Using unique, descriptive, and stable data-nid-target attributes help uniquely identify specific HTML elements on a page. This is necessary when the page contains multiple elements of the same type (e.g., multiple input fields) that must be tracked individually. By assigning unique identifiers, NeuroID can precisely target and analyze the behavior of each element.

📘

Unique, Stable, & Descriptive

Unique - They should only be appear once in your webpage. For example, if you have an address field which is broken into multiple inputs to capture the postal address and then the suite or apartment number, make certain these are seperate as in: data-nid-target="address1" and data-nid-target="address2". You must not use data-nid-target="address" for both.

Stable - They should not change each time the page is loaded. For example, some frameworks may increment the value, e.g., firstName1 for the first time the page is loaded and firstName5042 for the 5,042nd time the page is loaded. Your attribute should be stable, and must only be firstName without the additional changing values.

Descriptive - The values you add to data-nid-target will be displayed in the NeuroID dashboard for User Journeys and so they must make sense to you. You will want to differentiate between signals collected and displayed along the user journey so that a user of the dashboard understands that a user clicked into firstName and then lastName and then address1. These are descriptive names that are much easier to understand than if you were to use non-descriptive names such as e1 then e2 and finally e3.

How are they used?

Tracking for Analytics - When users interact with elements on a webpage (e.g., filling out a form, clicking buttons), the data captured through these data-nid-target attributes can be sent to tools like Google Analytics or NeuroID. This data provides valuable insights into user behavior, such as which form fields are completed most often or which buttons are clicked frequently.

Custom Dashboard Display - The extracted data from these data-nid-target attributes is aggregated and displayed in the NeuroID product dashboard. This visual representation of the collected data allows stakeholders to easily interpret and analyze the information and see what users do along the onboarding workflow.

# List of Input Fields