Metrics

Audio analytics reports on the approximate number of unique users listening to podcast or stream content over one or more listening sessions in any reporting period.

It allows reporting of metrics (number of users, sessions, listen hours, ect) grouped and filtered by different dimensions (countries, day parts, browsers, etc).

Audio metrics

These are the metrics used by the API to measuring audio content consumption.

Metric	Name	Description
Users	Unique users	Approximate unique users seen in the reporting period. A "user" is calculated using the IAB Podcast Measurement standard of combining the IP and User-Agent. For stream analytics, where the content server provides a unique listener id it may be used to improve accuracy.
AS	Active sessions	Approximated number of unique listening sessions that was active in the reporting period. A unique "session" is calculated by combining the Users identifier with the content being accessed. Sessions are subject measurement rules around expiry and exhaustion which determine how long they live and when they "restart".
SS	Sessions starts	Number of sessions started in the reporting period. While active sessions AS takes into account sessions that was already active at the beginning of the reporting period, SS filters this further to include only sessions that started within the reporting period.
TLH	Total listening hours	Number of audio hours consumed across all sessions. For example, 10 streaming sessions of 6 minutes each will be reported as 1 total listening hour.
Bytes	Bytes sent	Bandwidth used to deliver audio content to end users. Includes only the encoded audio data, excludes TCP and other network overheads.
ATSL	Average time spent listening	The average duration that listeners consume audio content. Calculated by dividing the total listen hours (TLH) by the number of active sessions (AS)
AAS	Average active sessions (per hour)	Calculated by dividing total listen hours (TLH) by the number of hours in the reporting period.
LTR	Listen through rate	Podcast only. Represents the number of sessions that was listened to completion. Based on the amount of podcast episode file data that was downloaded, which may be larger than actual amount listened.
Bounce	Bounce rate	Percentage of sessions that was shorter than 1 minute. Only available when querying unqualified data.

Result data

API queries by default respond with just the basic metrics, users and active_sessions. Setting the result_type filter to full returns all metrics available.

Example: Full metricsExample: Basic metricsExample: Specific metrics

"<base>/stream/totals/device?range=last_7_days&result_type=full"

{
    "metadata": { ... },
    "results": [
    {
        "country_code": "NA",
        "country": "Namibia",
        "users": 45577,
        "users_percent": "   2.64%",
        "active_sessions": 236085,
        "session_percent": "   3.73%",
        "total_listen_bytes": 13614481279069,
        "session_starts": 233885,
        "average_time_spent_listening": 65.98,
        "total_listen_hours": 259624.46
    },
    ...
    ]
}

"<base>/stream/totals/device?range=last_7_days&result_type=basic"

{
    "metadata": { ... },
    "results": [
    {
        "country_code": "NA",
        "country": "Namibia",
        "users": 1354557,
        "users_percent": "  78.61%",
        "active_sessions": 4813789,
        "session_percent": "  76.07%"        
    },
    ...
    ]
}

"<base>/stream/totals/device?range=last_7_days&result_type=tlh,bytes"

{
    "metadata": { ... },
    "results": [
    {
        "country_code": "NA",
        "country": "Namibia",
        "total_listen_bytes": 13614481279069,
        "total_listen_hours": 5997411.49
    },
    ...
    ]
}