Statistics
The Statistics Endpoint allows you to query all statistical Data from all nexxOMNIA/nexxPLAY Environments by API. All Endpoints return an Object with "day" as Key and "KPI" as Value, unless otherwise indicated.
Please notice, that this Endpoint uses a different Set of Parameters as the usual Media Endpoints. Please make sure, that the mandatory Parameters are set.
You will find the full List of Parameters for all Statistic Endpoints at the End of this Section.
Media Performance
/displaysbyday
GET https://api.nexx.cloud/v3.1/statistics/displaysbyday
/playerstartsbyday
GET https://api.nexx.cloud/v3.1/statistics/playerstartsbyday
/viewsbyday
GET https://api.nexx.cloud/v3.1/statistics/viewsbyday
/downloadsbyday
GET https://api.nexx.cloud/v3.1/statistics/downloadsbyday
/clicksbyday
GET https://api.nexx.cloud/v3.1/statistics/clicksbyday
You can replace "byday" for Displays, PlayerStarts, Views, Downloads and Clicks with "byhour" or "byweekday" if you need the Results to be grouped by the respective timeframe.
/viewsexternalbyday
GET https://api.nexx.cloud/v3.1/statistics/viewsexternalbyday
/viewtimebyday
GET https://api.nexx.cloud/v3.1/statistics/viewtimebyday
the returned KPI is the absolute View Time (in Minutes)
/viewtimeaveragebyday
GET https://api.nexx.cloud/v3.1/statistics/viewtimeaveragebyday
the returned KPI is the average View Time (in Minutes)
/viewprogressbyday
GET https://api.nexx.cloud/v3.1/statistics/viewprogressbyday
the returned KPI is an Object with the predefined Progress Slides per Day
/itemlist
GET https://api.nexx.cloud/v3.1/statistics/itemlist
the returned KPI is an Object with Media ID as Key and KPI Value as Value. The Result Set will include all Media Items, that had a Performance > 0 on that KPI of the given Period.
Path Parameters
kpi
string
the target KPI [display, playerstart, view, viewtime, viewtimeaverage, viewexternal, download, click, progress25, progress50, progress75, progress95, progress100, adrequest, adimpression]
Charts
The Chart Endpoints return an Object with Media ID as Key and KPI as Value.
/chartsbydisplays
GET https://api.nexx.cloud/v3.1/statistics/chartsbydisplays
/chartsbyplayerstarts
GET https://api.nexx.cloud/v3.1/statistics/chartsbyplayerstarts
/chartsbyviews
GET https://api.nexx.cloud/v3.1/statistics/chartsbyviews
/chartsbyviewsexternal
GET https://api.nexx.cloud/v3.1/statistics/chartsbyviewsexternal
/chartsbyviewtime
GET https://api.nexx.cloud/v3.1/statistics/chartsbyviewtime
/chartsbyviewtimeaverage
GET https://api.nexx.cloud/v3.1/statistics/chartsbyviewtimeaverage
/chartsbycompletion
GET https://api.nexx.cloud/v3.1/statistics/chartsbycompletion
/chartsbydownloads
GET https://api.nexx.cloud/v3.1/statistics/chartsbydownloads
/chartsbyclicks
GET https://api.nexx.cloud/v3.1/statistics/chartsbyclicks
Path Parameters
string
Distribution
The Distribution Endpoints return an Object with Distribution Item (for exmaple, Country Code) as Key and Number of Occurences as Value.
/distributionbygateway
GET https://api.nexx.cloud/v3.1/statistics/distributionbygateway
/distributionbydevice
GET https://api.nexx.cloud/v3.1/statistics/distributionbydevice
/distributionbyos
GET https://api.nexx.cloud/v3.1/statistics/distributionbyos
/distributionbybrowser
GET https://api.nexx.cloud/v3.1/statistics/distributionbybrowser
/distributionbydeliverydomain
GET https://api.nexx.cloud/v3.1/statistics/distributionbydeliverydomain
/distributionbyslug
GET https://api.nexx.cloud/v3.1/statistics/distributionbyslug
/distributionbypodcastapp
GET https://api.nexx.cloud/v3.1/statistics/distributionbypodcastapp
/distributionbycountry
GET https://api.nexx.cloud/v3.1/statistics/distributionbycountry
/distributionbychannel
GET https://api.nexx.cloud/v3.1/statistics/distributionbychannel
/distributionbyformat
GET https://api.nexx.cloud/v3.1/statistics/distributionbyformat
/distributionbylicensor
GET https://api.nexx.cloud/v3.1/statistics/distributionbylicensor
RealTime Performance
The RealTime Endpoints will return an Object with Performance KPIs per Gateway (or per Media ID in case of the RealTime Chart Endpoints) for the given Period.
The RealTime Endpoints will not respect any of the given Standard Statistics Parameters below (except "streamtype").
/realtime
GET https://api.nexx.cloud/v3.1/statistics/realtime
Query Parameters
timeFrame
integer
the desired Timeframe to group the Deliveries by. Computed in Minutes backwards from now [5, 10, 15, 30, 60, 120, 180, 240]
limit
integer
return only the most active LIMIT Elements
/realtimeexternal
GET https://api.nexx.cloud/v3.1/statistics/realtimeexternal
Query Parameters
timeFrame
integer
the desired Timeframe to group the Deliveries by. Computed in Minutes backwards from now [5, 10, 15, 30, 60, 120, 180, 240]
limit
integer
return only the most active LIMIT Elements
/realtimecharts
GET https://api.nexx.cloud/v3.1/statistics/realtimecharts
Query Parameters
timeFrame
integer
the desired Timeframe to group the Deliveries by. Computed in Minutes backwards from now [5, 10, 15, 30, 60, 120, 180, 240]
limit
integer
return only the most active LIMIT Elements
/realtimechartsexternal
GET https://api.nexx.cloud/v3.1/statistics/realtimechartsexternal
Query Parameters
timeFrame
integer
the desired Timeframe to group the Deliveries by. Computed in Minutes backwards from now [5, 10, 15, 30, 60, 120, 180, 240]
limit
integer
return only the most active LIMIT Elements
Ad Performance
/adrequestsbyday
GET https://api.nexx.cloud/v3.1/statistics/adrequestsbyday
/adimpressionsbyday
GET https://api.nexx.cloud/v3.1/statistics/adimpressionsbyday
/adclicksbyday
GET https://api.nexx.cloud/v3.1/statistics/adclicksbyday
/aderrorsbyday
GET https://api.nexx.cloud/v3.1/statistics/aderrorsbyday
You can replace "byday" in all Cases with "byhour" or "byweekday" if you need the Results to be grouped by the respective timeframe.
User / Session Performance
/registrationsbyday
GET https://api.nexx.cloud/v3.1/statistics/registationsbyday
Query Parameters
provider
string
only return Registrations of the given Provider [facebook, google, twitter, aad]
/loginsbyday
GET https://api.nexx.cloud/v3.1/statistics/loginsbyday
Query Parameters
provider
string
only return Logins via the given Provider [facebook, google, twitter, aad]
Payment Performance
/revenuebyday
GET https://api.nexx.cloud/v3.1/statistics/revenuebyday
Query Parameters
type
string
only include Sales of a specific Type into the Amount [subscription, rebill, ppv, ownage, deposit]
/subscriptionsbyday
GET https://api.nexx.cloud/v3.1/statistics/subscriptionsbyday
the returned KPI is "active Subscriptions" (total) on any given Day
Query Parameters
onlyPremium
boolean
only return Premium Subscriptions
onlyStandard
boolean
only return Standard Subscriptions
excludeTerminated
boolean
only return not-terminated/cancelled Subscriptions
/subscriptionterminationsbyday
GET https://api.nexx.cloud/v3.1/statistics/subscriptionterminationsbyday
Query Parameters
reason
string
only return Terminations, that were processed due to the given reason [byuser, incms, inappapi, rechargeproblem, paymentcanceled]
Special Parameters
Parameter
Values
Description
includeNetworkDomains
[0, 1]
if the calling Domain is Network Domain, and all Results from all Network Domains shall be combined, set this Parameter to 1
streamtype
Streamtype
the target Media Streamtype (mandatory)
from
Date (YYYY-MM-DD)
Starting Day of the Analysis (mandatory)
to
Date (YYYY-MM-DD)
End Day of the Analysis (mandatory)
gateway
[desktop, mobile, amp, fbia, tablet, ios, android, smarttv, androidtv, podcast]
The Analysis will only respect Results from this Gateway.
timezone
TimeZone Name
The Analysis will consider from/to and Day Borders as Dates in the given Timezone. If skipped, the Domain Default Timezone will be used.
device
[pc, mobile, tablet, tv, smart]
The Analysis will only respect Results by items of this Device Type
item
int
The Analysis will focus only on a specific Media item (if item is set, and streamtype is set to "allmedia", item will be interpreted as GlobalID)
itemReference
[ID, GID, hash, refnr, externalReference]
If Media Items are used as Keys for the Result Items, by default, their "ID" is returned. Setting this Parameter to another Item Property will change this Key to the desired Attribute.
limit
int
in contrast to the Media API, the limit can be set on this Endpoint to 100.000 if necessary. This can make sense on all Methods, that return long lists of Media Items.
channel
int
The Analysis will only respect Results in this Channel
format
int
The Analysis will only respect Results in this Format
deliveryPartner
int
The Analysis will only respect Results from this Delivery Partner
affiliatePartner
int
The Analysis will only respect Results from this Affiliate Partner
campaign
int
The Analysis will only respect Results from this Campaign
licensor
int
The Analysis will only respect Results by items of this Licensor
platformVariant
string
The Analysis will onyl respect Results on the given platformVariant
pageIntegration
[js, embed, wc, native]
The Analysis will only respect Results by items of Media, that was included by this Type of integration.
browser
[firefox, chrome, edge, explorer, safari, opera, samsung browser]
The Analysis will only respect Results by Media, that was delivered on the given Browser
os
[windows, macOS, linux, ios, android, chromeOS]
The Analysis will only respect Results by Media, that was delivered on the given Operating System
countryCode
2-Letter Country Code
The Analysis will only respect Results by Media, that was delivered in the given Country
regionCode
int
The Analytics will only respect Results by Media, that was delivered in the given Country Region (3Q nexx Region ID)
manufacturer
String
The Analysis will only respect Results by Media, that was delivered by Devices from the given Manufacturer.
deliveryDomain
String
The Analysis will only respect Results by Media, that was delivered on the given Domain
consentEnvironment
[none, onlystring, 1, 2]
The Analysis will only respect Results by Media, that were delivered in the given User Consent Environment
playbackMode
[bumper, preview, pseudolive, scenesplit, story, presentation, endless, premiere, mini, micro, hero]
The Analysis will only respect Results by Media, that was delivered in this PlaybackMode
dataMode
[api, static, offline]
The Analysis will only respect Results by Media, that was delivered in this DataMode
mediaOrigin
[own, remote]
The Analysis will only respect Results by Media, that are managed by nexxOMNIA (or are Remote Media)
startCondition
[autoplay, autoplaymuted, manual, manualmuted]
The Analysis will only respect Results by Media, that was started as defined.
viewCount
[onlyfirst, afterfirst]
The Analysis will only respect Results, where the View was the initial Media in the Player ("onlyfirst") or came later ("afterfirst")
Last updated