Radioplayer

Developer Reference

 Back
User Guide v.1.2 · Current

Radioplayer Developer Reference

User Guide v.1.2

Technical reference for Radioplayer partner integrations.

Version
Current
Document type
API reference
Audience
Radioplayer partner engineering teams

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:

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.

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”.

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

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:

These KPIs and charts provide actionable insights into listening behaviors, helping broadcasters refine content strategies and improve audience engagement.

Broadcaster Content Performance

Visual Data Representations

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.

Migration Support

The KPIs in this dashboard are based on data from previous Insight events.

Scorecard

Visual Data Representations

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.