Event Reference (v1) / Email Events
Email Link Click / email_link_click
Measures when a user clicks a link that uses the href="mailto:" protocol URL scheme to initiate an email from a link click.
Be aware, this event does NOT measure an actual email being sent. Browsers do not have a native API to detect if an email was composed or sent from a link click. This event only measures the click itself, not anything afterward.
Redact the href value to avoid sending the full email address in the event property. Google and other platforms have strict policies about sending personally identifiable information (PII) in event data. Even though an on-page click-to-email address may be publicly visible, Google, Meta and other platforms will flag anything that LOOKS like PII and possibly shut down the account as a result.
-
- Name
- Event Name Required
- Value
- event: email_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