Querying Data¶
The root endpoint of Liferay Analytics Cloud is https://analytics.liferay.com/api/reports. You can get the list of all data types endpoints by requesting a GET to the above URL. Try with curl
curl -L -H "Authorization: Bearer {token}" https://analytics.liferay.com/api/reports
The following response should be returned:
{
"_links":{
"accounts":{
"href": "https://analytics.liferay.com/api/reports/accounts"
},
"individuals":{
"href": "https://analytics.liferay.com/api/reports/individuals"
},
"pages":{
"href": "https://analytics.liferay.com/api/reports/pages"
},
"segments":{
"href": "https://analytics.liferay.com/api/reports/segments"
}
}
}
From here you can call different APIs to get data for accounts, individuals, pages, and segments.
All the server responses to the analytics data follow the same data structure. The response is a paged results of entities computed by Liferay Analytics Cloud. By default, each page will contain 20 elements and it can be navigated by replacing the page query parameter. Total shows the total number of available elements. Below you can see response format:
{"results":[],"total":0}
Accessing Accounts Data¶
Accounts data can be retrieved with the following command:
curl -H "Authorization: Bearer {token}" -L https://analytics.liferay.com/api/reports/accounts
Parameters¶
page
(Integer): results page number
Accessing Individuals Data¶
Individuals data can be retrieved by the following command
curl -H "Authorization: Bearer {token}" -L https://analytics.liferay.com/api/reports/individuals
Parameters¶
page
Integer: results page numberquery
String: keywords to be matched with the individuals demographics information
Individual Activities¶
curl -H "Authorization: Bearer {token}" -L https://analytics.liferay.com/api/reports/individuals/{id}/activities
Returns the list of activities performed by the individual
The structure of each activity is described below
{
"ownerId": "371000621354447876",
"startTime": "2019-10-28T21:49:05.674Z",,
"applicationId":"WebContent",
"eventId":"webContentViewed",
"eventProperties":{
"numberOfWords":"13",
"articleId":"232001430",
"title":"Navigation Content - Partner Resources Basic (for launch)",
"pageViewActivityId":"8ed2e0d9-ed41-4b3d-bbe1-e1219448e9eb"
}
}
Properties¶
ownerId
(String): Owner of the activity, equivalent to the individual ID.startTime
(Date): Date timestamp of when the activity occurred.applicationId
(String): Id of the application that triggered the event.eventId
(String): ID of the analytics events performed by the individual; event ID represent an action performed by the individual.eventProperties
(Object): Metadata information about the event, varies according to the eventId;
Individual Interests¶
curl -H "Authorization: Bearer {token}" -L https://analytics.liferay.com/api/reports/individuals/{id}/interests
Returns the list of individuals’ interests, the structure of each interest is described below
{
"score":0.6908830400645879,
"ownerId":"385450976494153117",
"dateRecorded":null,
"id":"389978452012791133",
"name":"Digital Experience Software Tailored"
}
Properties¶
score
(Number): Numerical representation of how interest the individual is in that particular topic; ranges from 0 to 1.ownerId
(String): Owner of the activity, equivalent to the individual ID.dateRecorded
(Date): Date timestamp of when the interest was calculated.applicationId
(String): Id of the application that triggered the event.id
(String): Unique identifier of the interest.name
(String): Name of the interest.
Individual Segments¶
curl -H "Authorization: Bearer {token}" -L https://analytics.liferay.com/api/reports/individuals/{id}/segments
Returns the list of segments the individual belongs to, the structure of each segment is described in the section Data Types > Segments.
Accessing Segments Data¶
Segments data can be retrieved by the following command:
curl -H "Authorization: Bearer {token}" -L https://analytics.liferay.com/api/reports/segments
Properties¶
page
: Integer, results page number
Segment individuals¶
Returns the list of individuals that belong to the segment.
curl -H "Authorization: Bearer {token}" -L https://analytics.liferay.com/api/reports/segments/{id}/individuals
Accessing Page Data¶
Page data can be retrieved by the following command:
curl -H "Authorization: Bearer {token}" -L https://analytics.liferay.com/api/reports/pages
Properties¶
page
(Integer): results page number.keywords
(String): keywords to be matched with the pages title or url information.rangeKey
(Integer): range to be used to group data. Possible values are 0 ( data from the last 24 hours), 1 (data from yesterday), 7 (data from the last 7 days), 28 (data from the last 28 days), 30 (default value, data from the last 30 days), 90 (data from the last 90 days.sortMetric
(String): defined what metric to sort the results, default to viewsMetrics; possible values are ctrMetric, timeOnPageMetric, exitRateMetric, ctpMetric, sessionsMetric, avgTimeOnPageMetric, bounceMetric, maxScrollDepthMetric, visitorsMetric, viewsMetric, bounceRateMetric, indirectAccessMetric, entrancesMetric, directAccessMetricsortOrder
(String), possible values are asc or desc. Orders the results according to the sortMetric in ascending or descending order. Default is desc.