Introduction
Usheru Tracking allows your website to send structured tracking events to the dataLayer without writing custom JavaScript for every element.
It can track:
Click
View
Form start
Form submit
Scroll depth
The plugin sends events using this structure:
window.dataLayer.push({
event: 'usheru',
tracking_event: 'cta_click',
tracking_source: 'premium_home',
tracking_engagement: 'Interest',
content_type: 'Premium Hospitality',
content_name: 'premium_requestinfo_button'
});
Global plugin settings
Use this section to set up the default values and behavior for the whole site.
Go to WordPress Dashboard > Usheru Settings > Tracking
Main global settings
DataLayer event name
This controls the value sent in the event field.
Recommended value: usheru
This means every event will include:
event: 'usheru'
Debug mode
Use this only for testing.
When enabled, the plugin logs tracking activity in the browser console.
Recommended:
Disabled on production
Enabled only while testing
Viewport threshold
This controls when a view event is triggered.
Example:
0.3
Means the event fires when roughly 30% of the element is visible in the viewport.
Scroll depth tracking
This controls at what percent the scroll events are triggered.
Example:
25,50,75,100
Means the event fires when the user reaches 25%, 50%, 75% and 100% of the page length. This is triggered on all the site's pages.
Default values by tracking type
The plugin has default values for each tracking type.
For example, a click event can use:
tracking_event: cta_click
tracking_engagement: Interest
content_type: CTA
While a form_submit event can use:
tracking_event: form_submit
tracking_engagement: Action
content_type: Form
When configuring a track inside Elementor, fields can be left empty.
The plugin resolves values in this order:
1. Value entered in Elementor
2. Default value for that trigger
3. Empty value
Recommended default values
Click
Use for CTA clicks, button clicks and important link clicks.
tracking_event: cta_click
tracking_source: [page_url]
tracking_engagement: Interest
content_type: CTA
content_name: [element_text]
track_once: No
View
Use when an element enters the viewport.
tracking_event: element_view
tracking_source: [page_url]
tracking_engagement: Interest
content_type: Element
content_name: [element_text]
track_once: Yes
Form start
Use when the user starts interacting with a form for the first time.
tracking_event: form_start
tracking_source: [page_url]
tracking_engagement: Intent
content_type: Form
content_name: [form_name]
track_once: Yes
Form submit
Use when a form is submitted successfully or submitted natively.
tracking_event: form_submit
tracking_source: [page_url]
tracking_engagement: Action
content_type: Form
content_name: [form_name]
track_once: Yes
Scroll depth
Use for global page scroll tracking. Recommended values:
tracking_event: scroll_depth
tracking_source: [page_url]
tracking_engagement: Interest
content_type: Page
content_name: [page_title]
track_once: No
Available keywords
For advanced configuration, you can use these dynamic keywords inside tracking fields:
General keywords
[page_title]
[page_url]
[post_id]
HTML keywords
[element_text]
[element_alt]
[element_title]
[element_aria_label]
[element_href]
[form_id]
[form_name]
Event keywords
[event_title]
[event_category]
[event_categories]
[event_type]
[event_types]
[event_genre]
[event_genres]
[event_subgenre]
[event_subgenres]
[event_organizer]
[event_ticket_url]
Summary
Usheru Tracking enables websites to send structured tracking events to the dataLayer without the need for custom JavaScript for each element. It can track various user interactions, including clicks, views, form starts, form submissions, and scroll depth. The plugin utilizes a specific event structure for tracking, allowing for easy integration. Users can configure global settings through the WordPress Dashboard, setting default values for tracking events.
Recommended default values are provided for different tracking types, such as click, view, form start, and form submit. Additionally, the plugin supports dynamic keywords for advanced configurations, enhancing tracking capabilities. Overall, Usheru Tracking simplifies event tracking on websites, making it more efficient for users to monitor interactions and engagement.