What properties are captured with my events?
Freshpaint automatically attempts to capture a number of properties with all events. If the property does not exist for a particular event, the property will not be captured for that event. These properties are called built-in properties, and are listed in the table below:
Built-in Property Name | Remarks | Example Value |
---|---|---|
Time | 1660750813.235 | |
Device ID | | |
User ID | Identifier for the user. Can be a UUID if the user is anonymous, or the user email if logged in. | |
OS | Operating System | Mac OS X |
Browser | | Chrome |
Browser Version | | 104 |
Current URL | Full url of the page on which the event was captured. | https://yourwebsite.com/pages/target-page.html?param=value |
Host | Domain of the page on which the event was captured. | yourwebsite.com |
Initial Referrer | The url of the initial referrer to your site | www.google.com |
Initial Referring Domain | Domain of the initial referrer | www.google.com |
IP | The user's IP Address | |
Pathname | | /pages/target-page.html |
Referrer | Url of the referring page to that event | www.example.com/home |
Referring Domain | Domain of the referring page to the event | www.example.com |
Screen Height | Screen height in pixels | 1080 |
Screen Width | Screen width in pixels | 1920 |
UTM Source | | |
UTM Medium | | |
UTM Campaign | | |
UTM Content | | |
UTM Term | | |
Pageview ID | | |
Session ID | | |
Target Text | Text of the element which was clicked on | button text |
Href | The href of a link which was clicked on | yourhref.com |
Freshpaint's JavaScript SDK will track Initial Referrer and Initial Referring Domain with any event that a user completes. These properties are stored in a Freshpaint cookie the first time a user comes to your site and will not change on future site visits as long as the cookie is not cleared.
For example, if a user comes to your website for the first time as a result of a search engine, like www.google.com, the initial referrer is the URL they first came from and the initial referring domain is www.google.com. This data is stored in a Freshpaint cookie and sent with all future events for that user.
This data could help you analyze how users from different initial referrers interact with your application.
The Initial Referrer will be $direct when a user navigates to a site for the first time without being referred by another site. This can happen in the following scenarios:
- A user types the website address directly into the address bar of the web browser
- A user clicks a link that takes them directly to the website
- A user clicks a bookmarked link that takes them directly to the website
- Security settings in the user's browser may be preventing referrer data from being passed
Freshpaint's SDK will also track Referrer and Referring Domain, if it exists, with any event that a user completes. The Initial Referrer is how the user first navigates to your application. The Referrer is how the user navigated within your application to trigger the event it is associated with.
For example, a user has already navigated to your website via a search engine and landed on the homepage, with the url www.example.com/home. From there, they click on the "about us" link and navigate to the url www.example.com/about. In this case, the Referrer would be www.example.com/home and the Referring Domain would be www.example.com. The Initial Referring Domain, as long as the Freshpaint cookie has not been cleared, still remains www.google.com.
If a user has navigated for the first time to your site directly (see above), there will be no Referrer and Referring Domain. If the user navigated to your site directly, and then clicked on a link on your site to send them from www.example.com/home to www.example.com/about, the Initial Referrer will still be $direct and the Referrer will be www.example.com/home.
Property values are limited to 255 characters in length. Events are limited to 1MB total.