Matomo’s API endpoint Live.getLastVisitsDetails at a glance

Matomo is a powerful web analytics tool that provides detailed insights into the behavior and characteristics of website visitors. A central component of these analyses is the API endpointLive.getLastVisitsDetails , which provides a comprehensive overview of recent visits to a website. This is not raw tracking data, but rather processed data specifically optimized for analytical purposes.

This processed data includes, among other things, URLs where tracking parameters have been cleaned. These include parameters such as gclid, fbclid, and msclkid, as well as all user-configured parameters. The data also contains information on configured goals, while certain e-commerce events such asaddEcommerceItem be displayed indirectly, for example through the eventecommerceAbandonedCart if a session has not completed the shopping cart.

Below are the different parameters and their descriptions that can be passed through the API endpointLive.getLastVisitsDetails provided, are presented in detail.

Visitor parameters

parameter	Description	Example
visitorId	Visitor ID	false
visitorType	Visitor type	“returning”
visitorTypeIcon	Symbol for visitor type	“plugins/Live/images/returningVisitor.png”
visitsCount	Number of visits	56
daysSinceFirstVisit	Days since first visit	545
daysSinceLastVisit	Days since last visit	6
location	Visitor’s location	Monterey Park, California, United States
country	Visitor’s country	“United States”
countryCode	Country code	“US”
countryFlag	national flag	“plugins/Morpheus/icons/dist/flags/us.png”
City	City of the Visitor	“Berlin”
region	Visitor’s region	“Berlin”
regionCode	Region code	“BE”
continent	Visitor’s continent	“Europe”
continentCode	Continent code	“EU”
latitude	Visitor’s latitude	52.5200
longitude	Visitor’s longitude	13.4050
language	Visitor’s language	“unknown”
languageCode	Visitor’s language code	„“
operating system	Visitor’s operating system	“Windows 8.1”
operatingSystemName	Operating system name	“Windows”
operatingSystemCode	Operating system code	“WIN”
operatingSystemVersion	Operating system version	“8.1”
operatingSystemIcon	Operating system icon	“plugins/Morpheus/icons/dist/os/WIN.png”
browser	Browser name	“Chrome”
browserName	Browser name	“Internet Explorer”
browser version	Browser version	“89.0”
browserFamily	Browser family	“Blink”
browserFamilyDescription	Description of the browser family	“Blink (Chrome, Opera)”
browserCode	Browser code	“CH”
browser icon	Browser icon	“plugins/Morpheus/icons/dist/browsers/CH.png”
deviceType	Device type	“Desktop”
deviceTypeIcon	Symbol for the device type	“plugins/Morpheus/icons/dist/devices/desktop.png”
deviceBrand	Device brand	“Samsung”
deviceModel	Device model	“iPhone”
fingerprint	Visitor’s fingerprint	false
plugins	Browser plugins	“cookie, flash, java, silverlight”
pluginsIcons	Browser plug-in icons	[{“pluginIcon”: “plugins/Morpheus/icons/dist/plugins/cookie.png”, “pluginName”: “cookie”}]

Session parameters

parameter	Description	Example
idVisit	Unique identifier of the visit	123456
firstActionTimestamp	Timestamp of the first action	1621771234
lastActionTimestamp	Timestamp of the last action	1621771234
lastActionDateTime	Date and time of the last action	“2024-05-23 21:58:40”
serverTimestamp	Server timestamp	1621771234
serverDate	Server date	“2024-05-23”
serverTimePretty	Human-readable server time	“23:58:40”
serverDatePretty	Human-readable server date	“Thursday, May 23, 2024”
serverDatePrettyFirstAction	Human-readable server date of first action	“Thursday, May 23, 2024”
serverTimePrettyFirstAction	Human-readable server time of the first action	“23:58:40”
visitDuration	Visit duration in seconds	0
visitDurationPretty	Human-readable visit duration	“0 sec.”
actions	Number of actions	10
interactions	Number of interactions	5
searches	Number of searches	0
events	Number of events	0
formConversions	Number of form conversions	0
goalConversions	Number of target achievements	0
totalEcommerceConversions	Total number of e-commerce conversions	0
totalEcommerceRevenue	Total sales from e-commerce	0
totalEcommerceItems	Total number of e-commerce items	0
totalAbandonedCarts	Total number of abandoned shopping carts	0
totalAbandonedCartsRevenue	Total sales of abandoned shopping carts	0
totalAbandonedCartsItems	Total number of items in abandoned shopping carts	0
daysSinceLastEcommerceOrder	Days since last e-commerce order	0
secondsSinceLastEcommerceOrder	Seconds since the last e-commerce order	zero
secondsSinceFirstVisit	Seconds since first visit	47174237
secondsSinceLastVisit	Seconds since last visit	604637
referrerTypeName	Name of the referrer type	“Search engines”
referrer name	Name of the referrer	“Google”
referrerType	Type of referrer	“Search engines”
referrer keyword	Referrer keyword	“example keyword”
referrerKeywordPosition	Position of the keyword in the referrer	zero
referrerUrl	Referrer URL	” https://www.google.com/ “
referrerSocialNetworkUrl	URL of the social network in the referrer	“facebook.com”
referrerSearchEngineUrl	URL of the search engine in the referrer	” http://google.com “
referrerSearchEngineIcon	Search engine symbol in the referrer	“plugins/Morpheus/icons/dist/searchEngines/google.com.png”
referrerSocialNetworkIcon	Social network symbol in the referrer	“plugins/Morpheus/icons/dist/socials/facebook.com.png”
visitIp	Visitor’s IP address	zero
visitLocalHour	Local hour of visit	13
visitLocalTime	Local time of visit	“13:00:11”
visitServerHour	Server hour of visit	21
resolution	Screen resolution	“1920×1080”
sessionReplayUrl	Session replay URL	zero
adProviderName	Name of the ad provider	String value
adProviderId	Ad provider ID	String value
campaignId	Campaign ID	String value
campaignName	Name of the campaign	String value
campaignSource	Source of the campaign	String value
campaignMedium	Campaign medium	String value
campaign content	Content of the campaign	String value
campaignKeyword	Campaign keyword	String value
campaignGroup	campaign group	String value
campaignPlacement	Campaign placement	String value
adClickId	Ad Click ID	String value
visitConverted	Whether the visit was converted	0
visitConvertedIcon	Converted visit icon	„“
visitEcommerceStatus	E-commerce status of the visit	“none”
visitEcommerceStatusIcon	E-commerce status icon of the visit	“plugins/Morpheus/images/ecommerceAbandonedCart.svg”
customVariables	Custom variables	{„variable1“: „wert1“}
dimension1	Custom Dimension 1	“guest”
experiments	Experiments	[]
siteCurrency	Site currency	“USD”
siteCurrencySymbol	Page currency symbol	„$“
siteName	Name of the page	“Demo Site”

events

type	Description	parameter
action	Measured page view of a user within a session	dimension5, iconSVG, idpageview, type, pageIdAction, pageviewPosition, timeSpentPretty, timeSpent, icon, dimension2, url, customVariables, dimension4, pageTitle, subtitle, pageId, timestamp, serverTimePretty, title
event	Measured event of a user within a session	eventCategory, dimension5, iconSVG, eventValue, idpageview, type, pageIdAction, pageviewPosition, icon, eventAction, dimension2, url, dimension4, eventName, subtitle, pageId, timestamp, serverTimePretty, title
goal	Measured or calculated goal achievement of a user within a session	dimension5, iconSVG, idpageview, goalName, type, revenue, icon, dimension2, url, goalId, dimension4, subtitle, referrerKeyword, timestamp, serverTimePretty, referrerName, title, referrerType, goalPageId
outlink	Measured click on an external link	url, pageIdAction, subtitle, dimension5, pageId, pageviewPosition, type, iconSVG, timestamp, icon, serverTimePretty, title, idpageview, dimension2, dimension4, pageTitle
ecommerceAbandonedCart	Abandoned shopping cart	revenue, subtitle, dimension5, iconSVG, timestamp, items, itemDetails, serverTimePretty, icon, title, idpageview, dimension2, dimension4, type
ecommerceOrder	Order	dimension5, iconSVG, revenueSubTotal, items, idpageview, type, revenue, orderId, itemDetails, icon, dimension2, revenueTax, revenueDiscount, dimension4, subtitle, revenueShipping, timestamp, serverTimePretty, title
form	Form submission	formName, dimension5, converted, submitted, idpageview, type, timeSpent, icon, timeHesitation, dimension2, timeToFirstSubmission, formId, dimension4, fields, formStatus, leftBlank, timestamp, serverTimePretty, title
crash	Application crash	crashId, dimension5, category, message, idpageview, type, datetimeLastSeen, icon, dimension2, datetimeOccurredFirst, crashType, resourceUri, datetimeLastReappeared, crashEventId, dimension4, datetimeIgnoredError, resourceColumn, timestamp, stackTrace, serverTimePretty, resourceLine, title
search	Internal search on the website	siteSearchCategory, pageIdAction, subtitle, dimension5, pageId, pageviewPosition, type, iconSVG, timestamp, dimension4, siteSearchCount, icon, serverTimePretty, title, idpageview, dimension2, siteSearchKeyword, url

Event parameters

parameter	Description	Example
type	Type of measured action	“page view”
URL	URL of the page on which the action took place	“https://example.com/page”
pageTitle	Title of the page	“Homepage”
pageIdAction	Unique identifier of the page action	123456
idpageview	Unique identifier of the page view	“ABC123XYZ”
serverTimePretty	Human-readable time of the action	“2023-05-23 12:34:56”
pageId	Unique identifier of the page	789012
productViewPrice	Price of the viewed product	19.99
productViewName	Name of the product viewed	“Product name”
productViewSku	SKU of the viewed product	“SKU12345”
timeSpent	Time spent on the page in seconds	45
timeSpentPretty	Human-readable formatting of dwell time	“45 seconds”
pageviewPosition	Position of the page view in the session	1
title	Title related to the action	“Product view”
subtitle	Subtitles related to the action	“Special offer”
icon	URL or path to an icon representing the action	“/images/icon.png”
iconSVG	SVG path data for the symbol	„…“
timestamp	Timestamp of the action	1621771234
productViewCategories	Categories of the viewed product	[“Category1”, “Category2”]
dimension1 … dimensionN	Custom dimensions	“Dimension value”
pageLoadTime	Page loading time	2.3
eventCategory	Category of the event	“Button click”
eventAction	Action of the event	“Click”
eventValue	Value of the event	10
goalName	Name of the goal achieved	“Registration”
goalId	Target identifier	“G123”
revenue	Generated revenue	99.99
goalPageId	Page ID on which the goal was achieved	456789
referrerType	Type of referrer (e.g. search engine, direct)	“search engine”
referrer name	Name of the referrer	“Google”
referrer keyword	Keyword used in the referrer	“Example keyword”
items	List of items involved in the campaign	[{“name”: “Item1”, “price”: 9.99}]
item details	Details of the articles involved	{„item_name“: „Artikel1“, „item_sku“: „SKU1“}
orderId	Order identifier	“ORD123”
revenueSubTotal	Subtotal of the order’s sales	89.99
revenueTax	Tax amount of the order	10.00
revenueShipping	Shipping costs of the order	5.00
revenueDiscount	Discount on the order	5.00
customVariables	Custom variables related to the action	{„variable1“: „wert1“}