Sessions collection records information related to sessions started in an application or website. A session represents the period during which a user interacts with the application from the moment they start browsing until they leave or the session ends. Each row corresponds to a recorded session and gathers information about when it started, when it ended, how long it lasted, from which IP address the access was made, which user started it, and other useful information for analyzing visitor activity.This collection provides an overview of application usage, allows you to understand user behavior, and detect possible suspicious access.
It is especially useful when you want to answer questions like:
Sessions collection allows you to analyze how users use an application and obtain relevant information about their connections. In addition to helping understand usage habits, it is also useful for detecting possible security incidents or unusual access.For example, this collection allows you to:
Not all sessions represent different behavior. The same user can generate multiple sessions throughout the day if they access at different times or from different devices.
| Field | Data type | Description |
|---|---|---|
| abuse_score | Number | Score associated with the risk level or reputation of the IP address that originated the session. |
| country | Categorical | Country from which the session originated, based on the geolocation of the IP address. It will not always be available since we usually include information for sessions with potentially fraudulent IPs. |
| domain | Categorical | Domain on which the session was recorded. |
| duration | Numeric | Total time the session lasted. |
| end_time | Date and time | Date and time when the session ended in UTC timezone. |
| entry_page | Categorical | First page visited during the session. |
| exit_page | Categorical | Last page visited before the session ended. |
| ip | Categorical | IP address from which the session was started. |
| navigation_path | Categorical | Complete route taken by the visitor during the session, showing the pages visited in order. |
| page_views | Numeric | Total number of pages viewed during the session. |
| referer | Categorical | Page or website from which the visitor came. |
| session_id | Categorical | Unique session identifier. |
| start_time | Date and time | Date and time when the session started in UTC timezone. |
| total_visits | Numeric | Number of visits associated with the session. |
| user_agent | Categorical | Identifying string of the browser, operating system, or application used by the visitor. |
| utm_campaign | Categorical | Name of the marketing campaign (utm_campaign) associated with the visit, if any. |
| utm_content | Categorical | Specific content of the campaign (utm_content). |
| utm_kwd | Categorical | Keyword (utm_kwd) used to identify the campaign, if available. |
| utm_medium | Categorical | Acquisition medium (utm_medium), such as email, cpc, or social. |
| utm_source | Categorical | Campaign source (utm_source), such as Google, Facebook, or a newsletter. |
| utm_term | Categorical | Search term (utm_term) associated with the campaign. |
| mtm_campaign | Categorical | Matomo campaign name (mtm_campaign). |
| mtm_content | Categorical | Matomo campaign content (mtm_content). |
| mtm_kwd | Categorical | Matomo keyword (mtm_kwd). |
| mtm_medium | Categorical | Acquisition medium recorded via Matomo (mtm_medium). |
| mtm_source | Categorical | Acquisition source recorded via Matomo (mtm_source). |
Data type: integer
Indicates the risk score associated with the IP address from which the session originated. This score helps identify whether the IP has a known reputation for potentially malicious activities, such as automated attacks, scans, or unauthorized access attempts. A higher value usually indicates a higher risk level.
Indicates the country from which the session originated, based on the geolocation of the IP address. This field allows you to know the geographic origin of connections and detect access from unusual locations. Note that IPs with a low abuse score typically do not have location data; however, potentially dangerous ones do.
Data type: categorical text
Indicates the domain on which the session was recorded. It is especially useful when analyzing multiple domains from the same dashboard, as it allows you to differentiate which one each session belongs to.
Data type: duration
Indicates the total time (in seconds) the session remained active. A very short duration may indicate that the visitor quickly left the page, while a longer duration usually reflects more prolonged interaction.
Data type: date and time
Indicates the date and time when the session ended. Together with start_time, it allows you to know when the visitor's browsing ended and calculate the session duration. This date and time is in UTC timezone.
Data type: text
Indicates the first page the user visited when starting the session. This field is useful for knowing which pages act as entry points to the website.
Data type: text
Indicates the last page visited before the session ended. It allows you to know where users leave the site and detect possible drop-off points.
Data type: IP address
Indicates the IP address from which the session was started. This field allows you to identify the origin of the connection and relate it to other events recorded in the system. In simple terms, it answers the question: "From which IP address did the visitor connect?"
Data type: text
Shows the complete route taken by the visitor during the session, indicating the order in which they visited different pages. This field helps understand how users navigate the website.
Example use cases:
Data type: integer
Indicates the total number of pages visited during the session. This data allows you to measure the visitor's level of interaction with the website.
Example use cases:
Data type: text
Indicates the page or website from which the visitor came before accessing the domain. This field helps identify the traffic source.
Example use cases:
Data type: categorical text
Unique session identifier. It allows you to distinguish each session from the rest and relate it to other events recorded during browsing.
Data type: date and time
Indicates the date and time when the session started in UTC timezone. It allows you to know when browsing began and analyze periods of peak activity.
Data type: integer
Indicates the total number of pages recorded for the session. This field allows you to count the visits associated with each session and perform aggregated analysis of site activity.
Data type: text
Contains the identification string sent by the visitor's browser or application. From this information it is possible to know the browser used, the operating system, and in some cases, the type of device.
Example use cases:
Data type: categorical text
Indicates the name of the marketing campaign from which the visitor came, when the URL contains the utm_campaign parameter. This field allows you to measure the performance of specific campaigns.
Data type: categorical text
Indicates the specific content of a marketing campaign using the utm_content parameter. It is commonly used to differentiate ads or variants within the same campaign.
Data type: categorical text
Indicates the keyword associated with the campaign when the utm_kwd parameter is used. It allows you to identify which term or segmentation criterion originated the visit.
Data type: categorical text
Indicates the medium through which the visitor arrived using the utm_medium parameter.
For example:
This field helps analyze which channels generate the most traffic.
Data type: categorical text
Indicates the acquisition source using the utm_source parameter.
For example:
It allows you to identify where visitors are coming from.
Data type: categorical text
Indicates the search term or keyword used in marketing campaigns using the utm_term parameter. It is mainly used in search engine advertising campaigns.
Data type: categorical text
Indicates the campaign name recorded using Matomo's tracking parameters (mtm_campaign). Its purpose is equivalent to utm_campaign, but using Matomo's own nomenclature.
Data type: categorical text
Indicates the specific content of a campaign recorded using mtm_content. It allows you to differentiate different variants within the same campaign.
Data type: categorical text
Indicates the keyword recorded using the mtm_kwd parameter. It is used to identify the term associated with the campaign.
Data type: categorical text
Indicates the medium through which the visitor arrived using the mtm_medium parameter. It allows you to analyze the different acquisition channels configured in Matomo.
Data type: categorical text
Indicates the acquisition source recorded using the mtm_source parameter. It allows you to know from which platform, website, or channel the visitor came before starting the session.