Radioplayer Developer Reference

User Guide v.1.6

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


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.

Favorite Station (Default Country)

This option allows administrators to set a default country to pre-populate the 'Country' filter upon application launch.

Minimum Session Duration

This setting defines the minimum threshold required for a listening session to be considered valid for analytics purposes.


The Insight Dashboard provides key metrics to help broadcasters and analysts track audience engagement and station performance. The main KPIs available include:

In-Car Insights

Dashboards covering listening that happens inside connected vehicles: live automotive audience, station/broadcaster/country/admin automotive breakdowns, and car brand insights.

Automotive Live Insights

Scorecard

In-Car Listening Flow

HYBRID RADIO

Listening Platform Distribution

Visual Data Representations


The Automotive dashboard adapts automatically to your role (Super Admin) and the filters you apply: depending on the Country, Broadcaster Group and Station filters you select, you'll be shown one of the views described below — Station, Broadcaster, Country or Super Admin — surfacing only the data you have access to.

Single Station Automotive Insights

This view is shown automatically based on your role and the filters you select — "Go to Automotive dashboard" opens the shared Automotive page, which may show a different view depending on your current filters.

Scorecard

METADATA QUALITY REPORT

In-Car Listening Flow

HYBRID RADIO

Visual Data Representations


BROADCASTER Automotive Insights

This view is shown automatically based on your role and the filters you select — "Go to Automotive dashboard" opens the shared Automotive page, which may show a different view depending on your current filters.

METADATA QUALITY REPORT

In-Car Listening Flow

HYBRID RADIO

Visual Data Representations


COUNTRY Automotive Insights

This view is shown automatically based on your role and the filters you select — "Go to Automotive dashboard" opens the shared Automotive page, which may show a different view depending on your current filters.

Scorecard

Metadata Coverage

In-Car Listening Flow

HYBRID RADIO

Automotive Distribution


SUPER ADMIN Automotive Insights

This view is shown automatically based on your role and the filters you select — "Go to Automotive dashboard" opens the shared Automotive page, which may show a different view depending on your current filters.

Scorecard

In-Car Listening Flow

HYBRID RADIO

Automotive Distribution


Automotive Car Brand Insights

This dashboard shifts the point of view from a station, broadcaster or country to a single car brand : every metric below describes the listening behaviour of that brand’s own connected vehicles. Accounts linked to a specific automotive vendor always see that brand’s data; other users can select a single brand from the Brand filter to preview the same brand-centric view.

Scorecard

METADATA QUALITY REPORT

Visual Data Representations


Out-of-Car Insights

Dashboards covering listening outside the automotive context: broadcaster groups & stations overview, live content, on-demand content, and audience engagement.

Overview

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.


Live

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


On-demand

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

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.


Audience Engagement

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

Note: Metrics in this section are based on lifetime data.


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.