Radioplayer Developer Reference
User Guide v.1.3
Technical reference for Radioplayer partner integrations.
- 1 How Data Can Be Filtered
How Data Can Be Filtered
Several tools have been introduced to allow users to navigate data temporally, aggregate it, and filter it by different dimensions. These filters can be used together to refine analysis effectively.
Users can:
- Select specific time periods to analyze trends over time.
- Aggregate data based on different dimensions, such as station, listened country, or device.
- Combine multiple filters to generate precise and insightful reports.
This functionality enhances data accessibility and ensures that broadcasters can extract the most relevant insights for their strategic decisions.
Data Picker
The Data Picker allows users to refine their data selection within the Insight Dashboard.
- Select specific time periods for analysis (two-days ago, previous week, last 7 days, previous month, last 30 days, last 90 days or custom range).
- Compare different data sets to evaluate trends over time.
Currently, the reported data is from two days prior due to the processing and consolidation mechanisms of the Firebase acquisition source, which requires 24 to 48 hours. _The introduction of our proprietary SDK will significantly reduce this delay, allowing data to be available within a few hours._
Country Filter
The country filter is useful for selecting one or more countries when monitoring Radioplayer projects across multiple regions. This feature is particularly useful for system administrators, allowing them to filter stations of a single nation or analyze aggregated data from multiple countries.
Broadcaster Group Filter
The Broadcaster Group filter allows users to select one or more broadcaster groups. A Broadcaster Group is a collection of stations that are generally owned by the same entity or are part of a unified brand name. This feature is particularly useful for organizations managing multiple stations across different markets.
Station Filter
The station filter allows users to select one or multiple stations within the Insight Dashboard. Users can search for stations by entering letters into the search box, enabling quick and efficient filtering. This feature helps broadcasters and analysts focus on specific stations or groups of stations for more targeted data analysis.
Listen Country
Filter The listen country filter allows users to filter where one or more stations are being listened to. Users can search for countries using the search box and filter for one or multiple nations, making it easier to analyze listening trends across different geographical areas.
Device Filter
The device filter allows users to filter on which device one or more stations are being listened to. This filter works similarly to other filters, enabling users to refine data by selecting specific device categories such as mobile, smart speakers, automotive systems, or web players. By using this filter, broadcasters and analysts can analyze listening behaviors based on device type and gain insights into user engagement across different platforms. This filter is only available on dashboards relating to new insigths events.
Device Category Filter
The device category filter allows users to filter on which device one or more stations are being listened to. The selectable options are related to the old insight event categorisation logic. This filter works similarly to other filters, enabling users to refine data by selecting specific device categories such as mobile, smart speakers, automotive systems, or web players. By using this filter, broadcasters and analysts can analyze listening behaviors based on device type and gain insights into user engagement across different platforms. This filter is only available on the old insight event dashboards called “Migration support”.
Custom Settings Configuration
These settings are accessible via the Settings Panel , with visibility and modification rights determined by the permissions associated with the user's role.
Local Time Zone
This setting controls how timestamps are displayed based on the selected country data.
- Behavior: If enabled (
True), and the selected reporting countries share a single, unified time zone , the data will be displayed in that local time zone. If the selected countries represent multiple different time zones or if this flag is disabled (False), all time-related data defaults to the UTC+0 standard.
Favorite Station (Default Country)
This option allows administrators to set a default country to pre-populate the 'Country' filter upon application launch.
- Visibility: Only accessible to Territory Admin and Super Admin roles.
- Functionality: You may select a default country from those visible within your scope. This selection ensures the application's country filter is automatically set to your preference when starting the app.
Minimum Session Duration
This setting defines the minimum threshold required for a listening session to be considered valid for analytics purposes.
- Visibility: Only accessible to Territory Admin and Super Admin roles.
- Functionality: Users can select the minimum valid duration for a session from the following discrete time values: 1, 15, 30, 45 or 60 seconds. Sessions lasting less than the configured duration will be excluded from core reporting metrics.
KPI Overview
The Insight Dashboard provides key metrics to help broadcasters and analysts track audience engagement and station performance. The main KPIs available include:
Broadcaster Groups & Stations
Scorecard
- Sessions : The total number of listening sessions. A session starts when playback begins and ends when it stops.
- Average Session Duration (TSL) : The average time users spend listening per session.
- Total Time Spent Listening (TTSL) : The cumulative listening time across all sessions.
- Average Quarter-Hour (AQH) : The average number of active sessions within a 15-minute window.
Each KPI includes a percentage trend comparing data with the previous period, helping users monitor audience behavior, engagement, and station performance over time.
Visual Data Representations
The dashboard features various graphical representations for easy analysis:
- Day Distribution : Displays listening activity trends by day, with options to view total sessions or unique devices.
- Hour Distribution : Shows listening activity trends by hour, allowing users to track hourly audience engagement.
- Station Distribution : Compares the percentage of listening activity across selected stations, helping assess performance differences.
- Country Distribution : Highlights listening activity by country, providing insights into geographic trends.
- City Distribution : Shows listening activity by city, offering a localized view of audience engagement.
- Geographic Distribution Map : A visual map representation of audience locations, helping identify key markets and listener density.
- Daily Station Distribution : Tracks the daily performance of each selected station over time.
- Device Percentage : Breaks down listening sessions by device type.
- Device Distribution : Provides a detailed breakdown of listening by device type, including how users access content.
- Daily Device Distribution : Tracks daily trends in device usage, helping broadcasters understand platform preferences and engagement shifts.
These KPIs and charts provide actionable insights into listening behaviors, helping broadcasters refine content strategies and improve audience engagement.
Live
Scorecard
- Sessions : The total number of listening sessions. A session starts when playback begins and ends when it stops (min. duration 60 s).
- Reach : Count the number of listeners, where each listener is identified by a unique device that tunes into a station. If a listener tunes into 3 different stations within a day, week, or month, it will be counted three times. In case of unavailable data, it is recommended to resize the selected time interval. The maximum selectable time range is 90 days.
Each KPI includes a percentage trend comparing data with the previous period, helping users monitor audience behavior, engagement, and station performance over time.
Visual Data Representations
- Trend Distributions : The chart shows the average sessions (or reach) by hour of the day, comparing weekdays (Monday–Friday) and weekends (Saturday–Sunday). It highlights differences in user activity patterns between workdays and weekends, showing peak hours and overall engagement throughout the day.
- Day Parts Distribution : This pie chart shows the distribution of listening sessions by time of day within the selected time period. The sessions are grouped into four time blocks: morning, afternoon, evening, and night, highlighting which parts of the day users are most active in listening. This breakdown provides a clear view of user behavior throughout the day, helping to identify peak listening periods.
- Stations & Programs: Provides insights into station and program performance, helping assess the effectiveness of different broadcasts.
- Top 50 Most Listened-To Songs : Highlights the 50 most popular songs across stations, offering insights into audience music preferences.
- Top 50 Most Listened-To Artists : Displays the 50 most played artists, helping broadcasters and the music industry understand audience trends.
On-demand
Scorecard
- Total on demand session : Number of listening sessions (streams). Unlike live sessions, there is no minimum listening duration for each episode.
- Total podcast consumption : Number of streaming sessions and the number of offline sessions, identified as the number of downloaded episodes.
- Reach : Count the number of listeners, where each listener is identified by a unique device that tunes into a station. If a listener tunes into 3 different stations within a day, week, or month, it will be counted three times. In case of unavailable data, it is recommended to resize the selected time interval. The maximum selectable time range is 180 days.
Each KPI includes a percentage trend comparing data with the previous period, helping users monitor audience behavior, engagement, and station performance over time.
Visual Data Representations
- Podcasts Charts : Top 1000 podcasts by listening sessions, including station info and the number of active episodes (non-expired).
- Most Subscribed Series : Top 1000 podcasts ranked by number of subscriptions received during the selected period, including additional information about the associated station.
- Most Listened Episodes : Top 1000 most-listened episodes, with related information such as podcast and station details.
- Daily Listeners Distribution : This graph shows the total daily distribution of users who listened to a podcast broadcast by a station.
- Episodes Streams Distribution : This visualization displays the distribution of episodes downloads or strems over time, allowing users to select the granularity of the data by day, week, or month.
- Episodes Downloads Distribution : This visualization displays the distribution of episodes downloads or strems over time, allowing users to select the granularity of the data by day, week, or month.
- Total Consumption Distribution : This visualization shows the total podcast consumption over time, representing the combined number of downloads and streams. Users can adjust the data granularity by selecting a daily, weekly, or monthly view.
- Subscriptions Distribution : This visualization displays the distribution of podcast subscriptions over time, allowing users to select the granularity of the data by day, week, or month.
To ensure accurate data and real-time reporting, broadcasters must provide metadata to the Radioplayer backend via Now Playing updates and/or schedule updates. Podcasts will only appear if they are linked to one or more stations within the selected filters. Providing complete metadata enhances the accuracy of insights and optimizes audience engagement strategies.
User Journey
Scorecard
- Total Favourite Active Subscriptions : The total number of active subscriptions to stations since January 1st, 2025. This value represents the balance of users who add a station to their favourites list minus those who remove it.
- Average Stations Favourite : The average number of stations marked as favourites by each user. This can be interpreted as the “length” of the user's favourites list.
Each KPI includes a percentage trend comparing data with the previous period, helping users monitor audience behavior, engagement, and station performance over time.
Visual Data Representations
- Favourite Stations : The top 50 stations based on the total number of overall subscribers.
Note: Metrics in this section are based on lifetime data.
Migration Support
The KPIs in this dashboard are based on data from previous Insight events.
Scorecard
- Sessions : Tracks distinct listening sessions using unique session identifiers. This metric was not displayed in the previous dashboards.
- Reach : Count the number of listeners, where each listener is identified by a unique device that tunes into a station. If a listener tunes into 3 different stations within a day, week, or month, it will be counted three times. In case of unavailable data, it is recommended to resize the selected temporal interval. The maximum selectable time range is 90 days.
Visual Data Representations
- Source Tracking Trend-Line : Compares the daily trend of tracked devices from the old Insights system, the new Insights dashboard, and the upcoming SDK. This chart is independent of the global device filter.
- Day Distribution : Displays listening sessions per day, with options to view total sessions or unique devices.
- Hour Distribution : Shows hourly listening sessions, with options for total sessions or unique devices.
- Station Distribution : Analyzes the percentage share of listening across stations based on aggregated session data.
- Daily Device Distribution : Tracks daily device usage trends, providing insights into changing listening habits.
- Device Percentage : Breaks down listening activity by device category, based on aggregated session data.
By leveraging these KPIs and visualizations, broadcasters can gain deeper insights into their audience and improve their content strategies.
Difference Between Old and New Insight Data
The data available in the new Insight Dashboard generally show lower absolute numerical values compared to the old RP_Insight system. This discrepancy arises due to a key structural change in data collection. The current data model does not include listening data from mobile app versions lower than 7.8, resulting in a more refined and precise dataset. However, this difference will progressively diminish as more users update their applications, leading to a gradual realignment of data over time.
Additionally, there has been a significant improvement in the accuracy of listening time calculations. The new system now determines listening duration by calculating the difference between the stop and start events of each individual listening session, ensuring a more precise measurement of user engagement.
To facilitate the understanding of data during this transition period, a dedicated dashboard will be released soon. This dashboard will allow users to consult the total data from the old RP_Insight system, with certain limitations on set of data showed, ensuring continuity in analysis while adapting to the new data model.