Links

What properties are captured with my events?

Built-in Properties

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
Unix timestamp when the event was captured
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

Initial Referrer and Initial Referring Domain

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.

$direct

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

Referrer and Referring Domain

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.