Event Reference (v1) / Navigation Events
Navigation Link Click / navigation_link_click
Measures when a user clicks a link in a defined navigation area - usually a child of a <nav> element.
This event was renamed from nav_link_click in older implementations. This new event name is clearer and doesn't use an abbreviation.
-
- Name
- Event Name Required
- Value
- event: navigation_link_click
Link Properties
These properties apply to many *_click events.
-
- Name
- Link URL Required
- Type
- link_url: string
- Description
The
hrefattribute of the link that was clicked. The value should be a fully qualified URL.- E.g.
https://www.level.agency/contact/#form
-
- Name
- Link Domain Required
- Type
- link_domain: string
- Description
The hostname of the link that was clicked. This can be useful for grouping links by domain.
- E.g.
www.level.agency
-
- Name
- Link Path Required
- Type
- link_path: string
- Description
The path of the link that was clicked. This can be useful for grouping links by path.
- E.g.
/contact/
-
- Name
- Link Fragment Required
- Type
- link_fragment: string
- Description
The fragment identifier of the link that was clicked. This can be useful for analyzing clicks on anchor links that point to a specific section of a page.
- E.g.
form
-
- Name
- Link Text Required
- Type
- link_text: string
- Description
The text (innerText) of the link that was clicked. It's recommended to lowercase this value for easier analysis.
- E.g.
Contact Us
-
- Name
- Outbound Link Optional
- Type
- outbound: boolean
- Description
A boolean value indicating if the link is an outbound link (i.e. it goes to a different domain).
Section/UI Properites
These properties can be applied to any event to provide more contextual information about "where" an interaction occured within a given page.
-
- Name
- Section Name Optional
- Type
- section_name: string
- Description
More specific than
ui_location, this property can be used to describe the name of a section or container that the event occurred within.- E.g.
recent posts
-
- Name
- UI Location Optional
- Type
- ui_location: string
- Description
The name of the section or container that the event occurred within. This could be a sidebar, header, footer, or any other named/defined section of a page.
- E.g.
sidebar