Nerja Tag (website)
Events the tag detects
Every event the Nerja Tag emits automatically, when it fires, and what Nerja uses it for.
You do not call these yourself — the tag classifies clicks and pages with DOM heuristics. This list is what each event means and, importantly, why it matters.
Core shopping events#
| Event | Fires when | Used for |
|---|---|---|
page_view | A page loads (or the route changes in a single-page app) | Sessions, browsing history, top pages |
view_item | A product page / card is viewed | Browse abandonment, top viewed products, product affinity |
add_to_cart | Add-to-cart is clicked | Cart abandonment trigger, top carted products |
remove_from_cart | An item is removed | Cart state accuracy; cancels cart-recovery messages for emptied carts |
increase_quantity / decrease_quantity | Quantity changes in the cart | Cart value and intent strength |
cart_page_view | The cart page is opened | Funnel stage; lets the tag know the visitor reviewed the cart |
begin_checkout | Checkout starts | Checkout abandonment trigger |
purchase | An order is confirmed | Revenue, attribution, and stopping recovery messages |
Engagement signals#
| Event | Fires when | Used for |
|---|---|---|
hover_add_to_cart / hover_product | The pointer rests on an add-to-cart button or a price | High-intent signal before a click |
wishlist_add / wishlist_remove | Wishlist actions | Interest audiences and back-in-stock style campaigns |
search_event | The site search is used | What shoppers look for; search-based offers |
scroll_milestone | Scroll depth thresholds | Engagement depth |
interaction | Other classified clicks | Fallback signal |
Identity capture#
When a visitor types into a form field the tag emits one event per recognised field, so a lead can be created without a login: email_captured, phone_captured, first_name_captured, last_name_captured, and — only at consent level full — address fields. sign_up_completed and auth_event mark sign-ups and logins.
Privacy
Journey funnel events#
These five are computed from the visitor's whole session and double as campaign triggers.
5 s × 3
user_promotion_event
three products, 5 seconds each, no cart action
+30 s
abandoned_cart_event
in cart, cart page not opened
+30 s
abandoned_checkout_event
checkout started, no order
3 h
abandoned_cart (per item)
configurable with cartHours
order
success_buyer_event
stops recovery messages
| Event | Meaning | Typical campaign |
|---|---|---|
user_promotion_event | Looked at 3+ products (5 s each) without adding to cart | Browse nurture, best-sellers |
abandoned_cart_event | Added to cart, did not open the cart within 30 s | Cart reminder |
potential_buyer_event | Reached the cart page | Checkout nudge |
abandoned_checkout_event | Started checkout, no order within 30 s | Checkout recovery |
success_buyer_event | Order confirmed | Thank-you, cross-sell, stops recovery |
Separately, abandoned_cart is emitted per item when it has sat in the cart for the configured cartHours (default 3 hours), with how long it was abandoned and the product details.
Your own events#
Any other event name is accepted. Send it with NerjaTracker.track() — tag JavaScript API.
Prefer to talk it through? Book a 30-minute call with the Nerja team.
Something unclear or missing? Email support@nerja.ai and we will improve this page.