Skip to content

  Behaviour

Query analytics data by audience behaviour, primarily how long they listen and when.

Drop-off rate

Group results by session duration.

This query provides different results between podcast or stream queries.

Podcast analytics uses the duration of files to map listening sessions into a percentage duration. The results contain 10 buckets, covering 10% each. This can more appropriately be described as "listen through rate". Using percentages instead of absolute time like "minutes" caters for reporting over episodes with very different durations.

Warning

Most podcast files are downloaded in one big transfer when consumed via podcast apps, and even browser based listening may always request the entire file instead of consuming it in segments. This always skews the listen-through rate towards 100% for podcast.

Stream analytics uses listening duration in minutes, but grouped into 25 buckets of data, each covering 5-minute sections up to 2 hours and then one final bucket for all sessions longer than 2 hours.

Listen through rate over past week
<base>/podcast/totals/dropoff_rate?range=last_7_days

"results": [
    {
        "range_start": 1,
        "range_end": 10,
        "percent": "1 - 10",
        "users": 753,
    },
    {
        "range_start": 11,
        "range_end": 20,
        "percent": "11 - 20",
        "users": 633,
    },
    ...
    {
        "range_start": 91,
        "range_end": 100,
        "percent": "91 - 100",
        "users": 28802,
    }
]
Stream drop-off rate
<base>/stream/totals/dropoff_rate?range=last_7_days

{
    "metadata": { ... },
    "results": [
    {
        "range_start": 0,
        "range_end": 5,
        "minute": "0 - 5",
        "users": 1216396,
    },
    {
        "range_start": 6,
        "range_end": 10,
        "minute": "6 - 10",
        "users": 847015,
    },
    {
        "range_start": 11,
        "range_end": 15,
        "minute": "11 - 15",
        "users": 668061,
    },
    ...
    ]
}

Day of week

Group results by the listener's weekday, using Sunday as day 0.

Users by day of week in the previous month
<base>/podcast/totals/day_of_week?range=previous_month

"results": [
    {
        "day_name": "Sun",
        "day_number": 0,
        "users": 316743
    },
    {
        "day_name": "Mon",
        "day_number": 1,
        "users": 464506
    },
    ...
]

Hour of day

Group results by the listener's hour of day, from 0 (00:00 - 00:59) to 23 (23:00 - 23:59).

Users by hour of day in the previous month
<base>/podcast/totals/hour_of_day?range=previous_month

"results": [
    {
        "hour_of_day": 0,
        "users": 80241,
    },
    {
        "hour_of_day": 1,
        "users": 76927,
    },
    ...
]

Day and hour

Group results by the listener's day of week and hour of day.

Use to display heatmaps of weekly activity.

Users by hour of day in the previous month
<base>/podcast/totals/hour_of_day?range=previous_month

"results": [
    {
        "day_number": 0,
        "day_name": "Sun",
        "hour": 0,
        "users": 16269,
    },
    {
        "day_number": 0,
        "day_name": "Sun",
        "hour": 1,
        "users": 15866,
    },
    ...
]

Day parts

Group results by the listener's daypart, for example "Breakfast Peak" or "PM drive".

Uses the UK Rajar standard day parts.

Each result contains a human friendly name and the day part information.

Users by daypart in the previous month
<base>/stream/totals/day_part?range=previous_month

"results": [
    {
        "title": "Breakfast Peak",
        "days": "Mon - Fri",
        "hours": "6 - 10",
        "users": 682927,
    },
    {
        "title": "Mid Morning",
        "days": "Mon - Fri",
        "hours": "10 - 13",
        "users": 459609,
    },
    {
        "title": "Afternoon",
        "days": "Mon - Fri",
        "hours": "13 - 16",
        "users": 406820,
    },
    ...
]