Guide

DSP Dashboard — Full Guide

How to prepare your export, upload it, read your analytics, and use AI to interrogate your streaming data.

What Is the DSP Dashboard?

The DSP Dashboard turns your raw royalty export files into a visual analytics suite. Upload a CSV, JSON, or TSV from any major distributor or DSP, and you instantly get four analysis panels: Platform Breakdown, Geographic Performance, Track Performance, and Revenue Velocity. The dashboard works with data from any platform — Spotify, Apple Music, TIDAL, Amazon Music, YouTube Music, DistroKid, TuneCore, CD Baby, and more.

Multi-platform support

Upload data from multiple DSPs in a single file, or upload them one at a time. The platform column in your data tells the dashboard how to segment everything.

No formatting required

As long as your file has the required columns (see below), the dashboard will parse it automatically — regardless of column order, capitalization, or extra columns.

Required Columns & File Format

Your file needs at minimum these six columns. Column names are flexible — the dashboard uses smart matching to detect them even if they have slightly different names in your export.

Column Required? Description
dateRequiredDate of the streams/revenue. Accepts YYYY-MM-DD, MM/DD/YYYY, or most standard date formats.
trackRequiredTrack name or identifier. Used to populate the Track Performance table.
platformRequiredThe DSP name (e.g. "Spotify", "Apple Music", "TIDAL"). Used for the platform breakdown chart.
countryRequiredTwo-letter ISO country code (US, GB, DE, etc.) or full country name. Used for geographic analysis.
streamsRequiredNumber of streams for that row. Integer values expected.
revenueOptionalRevenue in USD for that row. If omitted, revenue-related charts will be hidden. Include for Revenue Velocity analysis.
Accepted formats: CSV (.csv), JSON (.json), and tab-separated values (.tsv). Maximum file size: 50MB. Files larger than 50MB should be split by time period before uploading.

How to Export from Major Distributors

DistroKid

Bank → select "Streaming" → choose your date range → click "Download CSV". The export includes date, store (platform), country, title (track), quantity (streams), and earnings (revenue).

TuneCore

Reporting → Sales Reports → choose date range → Export. Select "Detailed Report" for track-level and country-level breakdowns. Download as CSV.

CD Baby

Reports → Earnings → choose your date range → Export to CSV. The detailed export includes store name, territory, title, and sales figures.

Spotify for Artists

Stats → Streams → Download CSV (upper right). Exports per-track, per-country stream counts. Note: revenue figures are not available directly from Spotify for Artists — combine with distributor data for full revenue view.

Apple Music for Artists

Trends → choose metric → Download. Apple exports include plays, listeners, and Shazams by country and track. Add a "revenue" column manually from your distributor report if needed.

United Masters

Dashboard → Analytics → Export. United Masters exports include platform, country, track, and stream data in CSV format compatible with the dashboard.

Best practice: Use your distributor's export (DistroKid, TuneCore, CD Baby, etc.) rather than individual DSP exports — distributors consolidate all platform data in a single file with revenue included.

How to Upload Your File

1

Open the DSP Dashboard

From the main app navigation, click "DSP Dashboard". You'll see the upload area in the center of the screen.

2

Drag and drop or click to browse

Drag your CSV, JSON, or TSV file directly onto the upload zone, or click "Browse Files" to select it from your file system. Only one file at a time is supported per session.

3

Review the column mapping

After upload, the dashboard shows a column mapping preview. Confirm that each required column is correctly matched to your file's columns. You can manually reassign any mismatched columns using the dropdown selectors.

4

Confirm and load the dashboard

Click "Load Dashboard". All four analysis panels populate instantly from your data. No credits are spent at this stage — the dashboard visualization is always free.

Note: Uploaded data is used for in-session analysis only and is not permanently stored on our servers. If you close the browser tab, you will need to re-upload your file in the next session.

Understanding the Four Analysis Panels

01

Platform Breakdown

A bar chart and data table showing your stream and revenue totals by platform. Key things to look for: platform concentration risk (if one DSP is over 80% of your streams), and revenue-per-stream disparities between platforms (TIDAL and Apple Music typically pay 2–3x Spotify's per-stream rate).

02

Geographic Performance

A world map and sortable country table showing streams and revenue by territory. Identify your top 5 markets, flag unexpected growth in new territories (potential tour or promo opportunities), and compare your revenue-per-stream by country to understand where your listeners are most valuable.

03

Track Performance

A sortable table of your catalog ranked by streams, revenue, or stream velocity (streams per day since release). The velocity column is particularly useful for identifying breakout tracks before they peak — a high-velocity new track warrants increased promotional investment immediately.

04

Revenue Velocity

A time-series chart showing revenue trends over the date range in your data. Useful for spotting seasonal patterns, measuring release impact, and tracking whether your catalog's earnings baseline is rising or falling between release cycles. Only available if your data includes a revenue column.

Using Ask the Data (3 Credits, 10 Turns)

Ask the Data is an AI chat that can answer natural language questions about your uploaded data. It's available once your file is loaded. See the Ask the Data guide for full usage instructions. Key points:

Date range is locked at session start

When you unlock an Ask the Data session, you'll set a date range filter. This range locks for the duration of the session (10 turns). Choose your range carefully — it determines which data the AI can see and analyze.

10 turns per session

Each session gives you 10 messages. Ask focused, specific questions to maximize the value per turn. The AI has full context of your uploaded data and your conversation history within the session.

Getting the Most from the DSP Dashboard

Upload quarterly exports for trend visibility

A single month of data shows snapshots, not trends. Export 3–6 months from your distributor for a richer analysis. The Revenue Velocity chart becomes much more informative with longer time ranges.

Combine exports from multiple distributors

If your catalog is split across DistroKid and TuneCore, combine both exports into a single CSV before uploading. Just ensure the column names match — or manually map them in the column matching step.

Watch for geographic outliers

Unexpected spikes in countries like Brazil, Mexico, Indonesia, or Germany often indicate algorithmic playlist placements. These are worth investigating — a track with organic traction in a new market is a targeting signal for your next release or ad campaign.

Use revenue-per-stream to prioritize platform growth

Sort the platform breakdown by revenue ÷ streams. Platforms with the highest per-stream rate (often Apple Music or TIDAL) deserve promotional attention if they currently have low stream volume. Small audience shifts to higher-paying platforms can significantly increase earnings without growing your total listener count.