Skip to main content
Tracking widget on-screen time

How to track widget on-screen time with Google Analytics 4

Tom Fulcher avatar
Written by Tom Fulcher
Updated over a month ago

Okendo allows the tracking of on-screen time for Okendo reviews widgets and carousels to indicate how long customers spent reading reviews. This can be used to determine the correlation between the length of time Okendo reviews have been read and the customer making a store purchase.

❗️Tracking of on-screen time for widgets requires the Widget Plus reviews widget. Please contact customer support for help migrating to Widget Plus. Learn more about Widget Plus.

In this article, you will learn about;

Before you begin

⚠️ You must have Google Analytics configured on your storefront and integrated and enabled on your Okendo account. Start with this help article to integrate Google Analytics with Okendo.


Enabling on-screen tracking in Okendo

Open your Okendo admin.

Go to your admin panel Settings > Widgets > General

Enable the Widget On-Screen Tracking toggle.

Click Save.


How on-screen tracking works

The on-screen widget tracking is triggered when we determine that the customer is viewing the reviews in an Okendo widget. The criteria used to determine this differ for both the reviews widget and carousel.

The Reviews Widget

For the Reviews Widget, a customer is considered to be reading reviews when the widget is close to the center of their screen.

This is determined by applying a -30% margin to the top and a -40% margin to the bottom of the customer’s browser screen. By taking this approach, we can avoid tracking on-screen time when the reviews aren’t in focus.

These margins are indicated by the red shading below. If the reviews widget is visible between these 2 margins, the customer is considered to be viewing the reviews.

Being Tracked

Being Tracked Focus Area

Not Being Tracked

Not Being Tracked Focus Area

The Reviews Carousel

A different standard is applied to the Reviews Carousel.

A customer is considered to be reading the reviews if at least 80% of the widget is visible on their screen.

This is due to the nature of the Reviews Carousel varying quite a lot in height depending on its configured settings and the length of the content.

Being Tracked

Carousel Being Tracked

Not Being Tracked

Analytics events

Once an Okendo reviews widget or carousel is determined to be in-view by the customer, an analytics event will be sent every 5 seconds to your selected analytics provider. The event name will be as follows:

  • Reviews Widget: okendo_reviews_widget_on_screen_timer

  • Carousel Widget: okendo_homepage_carousel_on_screen_timer

Each event represents 5 seconds (5000ms) of time the customer has spent viewing reviews. A simple calculation can be performed to determine the length of time customers have had reviews on-screen:

(event count x 5) / 60 = total minutes on screen


Google Analytics reporting

You can view captured events for Okendo widgets by going to your Google Analytics property in the Google Analytics dashboard and following these steps:

Go to Reports > Engagement > Events.

Search for on_screen_timer in the search box and press Enter.

Did this answer your question?