Matomo (Piwik) offers real time web analytics reports. When you request data for “today”, or “current month” or any date range including today, the reports will include the most recent visits, ensuring you always access up-to-date analytics data. By default, reports are processed every 10 seconds but you can customize this delay in the administration “General Settings” page (more information in the documentation).
But there’s more! Matomo (Piwik) also provides specific tools to help you better understand your traffic in real time, and view your data at the visit level
The Real Time Live! Widget
The Live! widget is displayed in the Matomo (Piwik) Dashboard by default, and shows the real time flow of visits to your website. It also displays a real time counter of your visits and page views in the last 24 hours and the last 30 minutes.
The Live! widget refreshes every 5 seconds, and displays new visits (or existing visitors that view a new page) at the top of list with a fade-in effect. For each visitor, you can see all of their attributes:
- number of actions
- time spent on the site
- operating system
- whether the visitor is new or a returning visit
- the referrer used to access your site (Search engine & keyword, Campaign, or Referrer website)
- whether the visitor converted a goal
If you hover over these icons, you can also see the resolution and the list of enabled browser plugins.
The Live! widget also shows the list of page views and actions the visitor performed on your site. Hovering over the icon will show the page name and the time that the page was accessed. Clicking on the icon will open the actual page on your site.
Screenshot of the Live! widget showing your stats in real time
You can see the Live! widget on the official Matomo (Piwik) Demo.
To open the Visitor Log click on the main menu Visitor > Visitor Log. The Visitor Log is a tool that allows you to see all the visits on your site, and browse through these visits to check on individual user sessions. You can click Next at the bottom of the page to access previous visits, or change the date in the calendar to access visits from different days.
The Visitor Log shows the same data as the Live! widget as well as any Custom Variables you may have set on your visits. It doesn’t refresh automatically but of course you can reload the page to see your latest visits. It is useful to browse individual user sessions on your site and understand what your visitors were looking for, whether they found an answer, or to see which pages they looked at before converting your Goals.
Screenshot of the Visitor Log displaying the list of all visits (and their actions) in a given day
You can see the Visitor Log on the official Matomo (Piwik) Demo.
Note about Embedding Visitor Log: If you are building a web application or provide Matomo (Piwik) as a service for your customers, you may want to allow access to the Visitor Log in your existing design. You can easily embed the Visitor Log for a specific idSite/date, see the result here. Click on Administration > Platform > Widgets for more information.
The Visitor Profile shows in one report a summary of information about a particular visitor to your website, or user of your app. The Visitor profile lists all previous visits from this visitor, and information about the first and last visit, as well as showing the map with visitor location(s).
This report is available in real time for any visitor currently on the website, but you can also see the report for any visitor in the past by browsing the Visitor Log or selecting another date in the calendar.
In the Visitor Log, click ‘View Visitor Profile’ to launch the report:
Learn more about the User Profile.
Real Time Analytics API
The Matomo (Piwik) Live! API gives you easy access to all visits and actions on your websites.
The Live! API can be used to query individual visitor records or fetch all of the visits in a given day or date range. You can, for example, use it to integrate with other user databases to get a global view of the path and history of your visitors from the moment they found your website, to conversion, and later to their retention and experience of your site or application. Try integrating Matomo (Piwik) with a CRM, Customer databases, ECommerce databases, or existing data warehouse.
Here are some examples of the Live! API output in XML (you can request many other different formats and other options, see the
Analytics API documentation). These are based on the Matomo (Piwik) Forums analytics data.
- See XML output of the Real Time counter API, for the last 30 minutes
- See XML output of the last 10 visits and their actions and Goal conversions
- See XML output of the last visit (and list of pages) of one specific Visitor ID
Read more about general information about the Live! Matomo Analytics (formerly Piwik Analytics) API in the Analytics API Reference page.
About Visitors’ Privacy
The Visitor IP (visitIp field) and the Unique Visitor ID (visitorId field) will be displayed in the user interface and returned in the API output only if you are logged in Matomo (Piwik). For privacy reasons, we do not display the IP or Visitor ID to anonymous users.
Learn more about Matomo (Piwik) Privacy