Visits by Platform / Operating System

Display which platform (operating system) visitors have installed. This specific api call is turned off by default, please contact support@opentracker.net to turn this api call on.

API Usage

This API produces a json array. Perform GET or POST requests. Visits can also be retrieved based on platform, and/or a visit_id, and/ or a machine_idx.

Parameters

One or more of the following parameters are required:

filterByPlatForm: Find all visitors using the specified platform. Default is all operating systems.
filterByMachineId Display data for these machine ids. Machine id is a unique identifier of each visitor. Default is all machine ids.
filterByVisitId Display data for these visit ids. Visit id is a unique identifier of each visit. Default is all visit ids.
offset The starting point from where records will display. Default is [0] (most recent chronological event).
limit Maximum number of records to be displayed in the output. Default is [40]. Maximum is 10,000.
login Your opentracker login email. Default is [support@opentracker.net].
password Your password.
ticketId A ticketId can be used to provide credentials with an expiring token. A ticketId can be used instead of a login/ password combination. Further information can be found here.
site The site for which to display data. Default is [www.opentracker.net].
locale The locale parameter is an identifier for a particular combination of language and region (e.g. en_US) and determines the format of the data returned. A list of locales can be found here.
dataType The dataType parameter determines the format of the data returned. Values can be [json] | html | jsondatatable | jsonjqgrid
ignoreLocale Display columns without language translation. Boolean. [false]|true.
dateFormat The dateFormat parameter determines the format of dates returned. An example is dateFormat=yyyy-dd-MM. The syntax can be found here.

Examples

To search all visits to www.opentracker.net using Mac.
HTTP GET/ POST: view_platform.jsp?login=demo@opentracker.net&password=demo123&site=www.opentracker.net&platform=*mac*&offset=0&limit=2

Response

This page returns a json array with 'n' entries starting from the specified offset formatted as:

				








{ "resultsList": [
{
"visit_id":"1124363",
"machine_idx":"841909",
"last event":"Dec 07 17:42 PM +0500",
"duration":"s.e.",
"country":"\/images\/general\/login\/flags\/gh.gif",
"status":"\/images\/general\/login\/puppets\/puppet_offline.png",
"visits(pv)":"2 (1)",
"current page (exit page)":"file:\/\/localhost\/C:\/Users\/Emmanuel%20Acheampong\/Desktop\/PROJECT\/Refs\/2\/What%20is%20a%20website%20tracking%20system%20%20_%20Opentracker%20Analytics.htm",
"currentTitle":"What is a website tracking system? | Opentracker Analytics",
"countryName":"Ghana",
"city":"Kumasi",
"region":"Ashanti",
"isp":"",
"org_company":"Unknown",
"isp/ org":"Vodafone Ghana Ip Block",
"provider":"Unknown",
"area code (tel)":"Unknown",
"ZIP/ postal code":"Unknown",
"referrers Logo":"",
"referrer":"Unknown",
"search term":"Unknown",
"user status":"offline",
"number of visits":"2",
"pageviews":"1",
"total pages viewed":"3",
"last visit duration":"single event( s.e.)",
"current visit duration":"00s",
"total duration":"00s",
"first measurement":"Jun 15 00:27 AM +0500",
"platform/ OS":"Windows NT 10.0",
"browser":"Firefox 57.0",
"resolution":"1366 x 768",
"IP address":"41.204.38.9"}
,
{
"visit_id":"1124362",
"machine_idx":"521546",
"last event":"Sep 28 07:45 AM +0500",
"duration":"s.e.",
"country":"\/images\/general\/login\/flags\/us.gif",
"status":"\/images\/general\/login\/puppets\/puppet_offline.png",
"visits(pv)":"2 (1)",
"current page (exit page)":"http:\/\/www.opentracker.net\/products\/web-analytics\/feature\/search-visitor-data",
"currentTitle":"Search all visitor data - Web Analytics | Opentracker Analytics",
"countryName":"United States",
"city":"Kernersville",
"region":"North Carolina",
"isp":"",
"org_company":"Unknown",
"isp/ org":"Time Warner Cable",
"provider":"rr.com",
"area code (tel)":"336",
"ZIP/ postal code":"27284",
"referrers Logo":"",
"referrer":"Unknown",
"search term":"Unknown",
"user status":"offline",
"number of visits":"2",
"pageviews":"1",
"total pages viewed":"3",
"last visit duration":"single event( s.e.)",
"current visit duration":"00s",
"total duration":"00s",
"first measurement":"Jun 20 22:39 PM +0500",
"platform/ OS":"Intel Mac OS X 10.12.6",
"browser":"Safari 11.0",
"resolution":"1280 x 800",
"IP address":"71.71.5.102"}
]
}


				

Errors

If errors are encountered, the first encountered error will be returned of form "Error: exception: message

Error: java.lang.RuntimeException: Login/ site combination is not valid

We would love to hear your feedback. Please use the facebook comment box below