What is an event
An event is an interaction that a user has with your website or app. For example (Click Sign up, View Product Page, Complete checkout, and more).
You can create, manage and sync events with Data Connect to get richer data to help you with key business analysis.
With Data Connect you can create and sync the following events:
- Click events - A click on an element
- Pageview events - A pageview
- Change on - A change in an input, textarea, or select element
- Submit on - A form submission
- Start session - When a session is started
Best practices for Naming conventions
Planning a consistent naming convention, for events, ensures effective data management. Recommended best practices include:
- Use a standard naming pattern for labeling events, such as The Location - Action - Object pattern (E.g. Homepage - Click - Sign Up button)
- Choose a standard tense (either past or present) for your event names.
- If you use the present tense, you'll want to name your event 'Start Checkout'
- If you use the past sense, you’ll want name your event 'Started Checkout'
- Be consistent with spacing and punctuation. You may write definition names as ‘Click - Signup’ or ‘Click Signup’, don’t use these interchangeably.
- When creating temporary definitions for tests (such as an A/B test) be as specific as possible in the name to avoid having that definition mixed up with others, such as: View Homepage B January 2020 Test
- When doing something like a site redesign, where you may want to compare old and new definitions to measure the success of the redesign, we recommend incorporating that into the naming convention (ex. ‘definition label - Old', ‘definition label - New')
Properties
Properties are bits of metadata that are captured during user interactions with your app. For example: Path of the 'View Homepage'.
When creating events in Data Connect, use the optional 'properties' filter (autocaptured properties) to refine event targeting.
You can currently filter based on autocaptured web session or web event properties.
Web Session Properties
A web session property refers to a key-value pair associated with a user session on a website.
| Property | Definition |
| Referrer | The webpage that linked to your site and initiated the session. If the user navigated directly to your site, or if the referral headers were stripped, then this value will appear as direct. |
| Full Referrer | The same as the referrer, though this contains the protocol, port, and path, if they exist. |
| Landing Page | The first page of the current session. |
| Landing Page Hash* | The hash route of the first page of the user's session. |
| Landing Page Query* | The query parameters of the first page of the user's session. |
| Browser | The user's browser. |
| UTM Source, UTM medium, UTM Term, UTM Content, UTM Campaign | These are the UTM parameters in the query string of the first page of the user's session. |
Web Event Properties
A web event property refers to metadata associated with a web event. These properties are typically represented as key-value pairs and provide additional context or information about the event.
| Property | Definition |
| Target Tag | The tag name of the event target's DOM element, e.g. INPUT, DIV, or A. |
| Target ID | The ID of the event target's DOM element, e.g. #login. |
| Target Class | The class name of the event target's DOM element, e.g. .primary-btn. |
| Href | The href property of link. (for clicks on anchor tags). |
| Previous Page | The previous page visited in this session. |
| Domain | The current domain, including the subdomain, e.g. blog.heap.io. |
| Hash | The part of the current URL following the hash sign, e.g. #install for contentsqure.com/docs#install. |
| Path | The part of the current URL following your domain, e.g. /category/ for https://contentsquare.com/. |
| Query | The query params of the page's current URL, e.g. ?utm_id=1234 for contentsquare.com?utm_id=1234. |
| Title | The title of the current HTML page. |
| Hierachy | The full hierarchy of the event target on click, change, and submit events. Note: The last element is removed, if including that element would cause the hierarchy to exceed 1024 characters. |