Skip to main content
Skip table of contents

JENTIS States Framework

Events and data interweave like bread and butter; one can not go without the other. Every data point that describes an observation must be logically linked to some interaction (or observation of such). In this article, we will look deeper into why events are so important in tracking and how JENTIS has internal concepts, like JENTIS States, to give you all the options to connect to your website environment.

Page Lifecycle, Events, and JENTIS Data Layer

To understand the JENTIS States and how they function, it’s essential to first delve into the Page Lifecycle and Events concepts in web development and how the JENTIS Data Layer works. JENTIS States are built on an event-driven data model architecture, so they are often used interchangeably with events. However, there are key differences between them that we will explore in detail in this article.

Page Lifecycle

We all know what it means to browse a website—but what does that technically mean? In the web development community, there is a thing often described as the page lifecycle. A page lifecycle refers to the different stages a webpage goes through, from when it loads in a browser to when it is closed or navigated away from. It helps developers understand how a page interacts with the browser and when specific events happen so they can optimize performance and manage resources efficiently.

Events

Events are milestones or triggers that occur during the page lifecycle, signaling key moments in the lifecycle stages. Developers use these events to execute specific actions, like initializing scripts, managing resources, or saving data. DOMReady (DOMContentLoaded) and On Page Load (load) are specific events within the page lifecycle that indicate when certain things are ready on the webpage.

  • The DOMReady event happens after the HTML is fully loaded and the DOM (Document Object Model) is built. The page structure is ready for interaction, but images, styles, and other resources may still be loading.

  • The On Page Load event happens after the entire page, including all images, styles, scripts, and other resources, is fully loaded. the page is completely ready for use.

If you want to know more about events, we recommend reading https://developer.mozilla.org/en-US/docs/Learn/JavaScript/Building_blocks/Events

JENTIS Data Layer

The most resilient way to connect JENTIS to your data is to actively push data to the JENTIS Data Layer—read more on JENTIS Data Layer: Push Data. With that approach, you will push descriptive data (product name, page title, etc.) and commands (events, tracking signals to invoke a state like pageview, virtual pageview, productview, etc.). We highly recommend implementing JENTIS using this approach with an aligned up-tracking map that displays all requirements and parameters.

However, that is not the only option in practice. Signals and data can also be picked up during the page lifecycle and on certain events. These can be any interactions of the user or other applications submitting data to a generic (non-JENTIS flavor) data layer.

In the following articles, we have covered popular examples and use cases for events translated into JENTIS States:

Both implementation types, pushing or listening, will create a JENTIS State. The default push of events, page views, etc., is the same in the internal framework, and we will treat both options equally in the architecture.

JENTIS States Architecture

Now that we better understand page lifecycle, events, and both options to push active data on the JENTIS Data Layer and/or listen to page lifecycle events, we can zoom out on the topic and understand the States Architecture.

In the JENTIS States there are the triggers. When a JENTIS State is activated, all variables and triggers will be evaluated as the event is called or the push is submitted. This is where the tags can now be activated, creating a logical chain of events, as in the following diagram:

JENTIS_Docs_SF.jpg

In each JENTIS State, all variables and triggers are evaluated simultaneously. This ensures that each variable has a single, static value at that specific moment. As a result, all triggers and tags activated within that JENTIS State use the same consistent parameter values.

For example, a new JENTIS State is created when a user clicks a button. This state signals the relevant triggers to evaluate whether they should fire based on the updated conditions (e.g., the button's ID or the current user session).

Variables are re-evaluated at different moments (e.g., when a button is clicked on the same page a few seconds later). At that time, their values may change if they are updated due to changes in the website's presentation during interaction or loading.

For a better understanding, here is an example:

JENTIS State

Variable "Page Title" Value

Variable "Price Tag" (CSS Selector - Text Value)

_jts.push({
  track: "submit"
});

"My Product Detail Page"

undefined

DOM ready

"My Product Detail Page"

19.99 €

Button Click

"My Product Detail Page"

19.99 €

Imagine a user is shopping in an online store. They visit a product page, and the price tag is initially hidden or dynamically loaded by JavaScript after the page starts rendering. You want to track the price tag value when the user clicks the "Add to Cart" button.

  1. Page Load: When the page first loads, the JavaScript begins to render the page.

    • JENTIS State 1: The “Price Tag” element is not yet visible because the script hasn't rendered it. The Price Tag variable is undefined at this moment.

  2. DOM Ready: After a short delay, the DOM is ready, and the page structure is fully loaded.

    • JENTIS State 2: The "Price Tag" is now visible on the page, and its value has been set (e.g., "19.99 €"). This value is available for tracking.

  3. Button Click: The user clicks the "Add to Cart" button, triggering another event.

    • JENTIS State 3: The "Price Tag" variable is evaluated again, but now the price is available and can be tracked accurately.

In this scenario, the JENTIS State ensures that the value of the "Price Tag" variable is consistent and tied to specific moments, such as when the DOM is ready or when the button is clicked.

If you want to understand better how to create and manage JENTIS States on our platform, read States

Read next

JENTIS States, Variables, and Scopes of Data


If you have any questions or suggestions, contact us through our Helpdesk.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.