Reports for Your Ring App
The Ring Developer Portal generates a weekly metrics report for your public app. It gives you 14 metrics covering active users, account linking, trials, subscriptions, and revenue, each shown for the selected week, the week before it, and year to date. You can read the report in the portal or download it as a PDF.
Reports are available for public apps only. Private apps have no Reports page — see Availability.
Ring generates these reports for you, so you get a consistent view of app performance without instrumenting anything. To track the parts of the customer journey that happen inside your own app — where customers drop off in your signup flow, which features they use, how your webhook endpoint is performing — instrument your app as described in Customer Lifecycle Analytics for Your App.
On this page
- Open the Reports page
- How the report is organized
- Metrics reference
- Select a different week
- Download the report as a PDF
- Reading the numbers
- Availability
Open the Reports page
To open the weekly metrics report:
- Go to the Ring Developer Console.
- On the Apps page, select the Public Apps tab, then choose Manage on the app you want.
- In the app navigation, choose Reports.
The Reports entry sits below Overview and Version history in the app navigation. While the report loads, the page shows Loading reports….
How the report is organized
The Reports page is headed Reports, with the subtitle "Track usage, performance, and key metrics across your app." Below it, a single card holds the report.
The following table shows the controls on the report card.
| Control | Type | Behavior |
|---|---|---|
| Weekly metrics (14) | Card heading | Names the report and shows how many metrics it contains. |
| Generated for Week of <start> – <end>, <year> | Caption | The reporting week the values below belong to. |
| Week selector | Dropdown | Chooses which week's report to display. Labeled with the currently selected week, for example Week of Jul 20 – Jul 26. |
| Download PDF | Button | Downloads the currently displayed report as a PDF. |
The metrics themselves are a four-column table.
| Column | What it holds |
|---|---|
| Metric | The metric name. |
| Last Week | The value for the week before the selected week. |
| This Week | The value for the selected week. |
| YTD | The year-to-date value as of the selected week. |
Metrics reference
The report always contains the same 14 metrics, in the order below.
Engagement and account linking
| Metric | What it measures |
|---|---|
| Total Weekly All Active Users | Customers active in your app during the week. |
| Account Linking Completions | Ring accounts that finished linking to your app. |
Trials
| Metric | What it measures |
|---|---|
| Distinct New Trials Started | Customers who started a free trial during the period, counted once each. |
| Total Trials Expired | Trials that reached the end of their trial window. |
| Trial Conversion Rate % | The percentage of trials that became paid subscriptions. The unit is in the metric name, so a value of 150 means 150%. |
Subscriptions
| Metric | What it measures |
|---|---|
| Total Cancellations | Subscriptions cancelled during the period. |
| Churn Rate | The rate at which paid subscribers cancelled. |
| Total Paid Subscribers | Customers holding a paid subscription. |
| Distinct New Paid Subscriptions | Subscriptions that started during the period, counted once each. |
| Total Active Paid Subscriptions | Paid subscriptions in an active state. |
Revenue
All four revenue metrics are US dollar amounts.
| Metric | What it measures |
|---|---|
| 3p Gross Revenue | Gross revenue attributed to your app, in dollars, before Ring's share is deducted. |
| Ring Revenue Share | The portion of gross revenue retained by Ring, in dollars. |
| Net Proceeds | Your revenue after Ring's share, in dollars: 3p Gross Revenue minus Ring Revenue Share. |
| Gross Transactions | Total transaction value for the period, in dollars. |
Ring retains a 10% revenue share on paid customer subscriptions, so Ring Revenue Share is normally a tenth of 3p Gross Revenue and Net Proceeds is the remaining nine tenths. A week with $165.00 in gross revenue reports $16.50 as Ring's share and $148.50 in net proceeds.
148.5. Treat the revenue rows as dollars and format them yourself if you feed them into a report.Select a different week
Choose the week selector to see the weeks you can report on. Weeks are grouped under a year heading, and the currently selected week is marked with a check. Choosing a week reloads the table for that week.
Only weeks that already have a generated report appear in the list, so the available weeks aren't necessarily consecutive.
Selecting a week changes all three value columns, YTD included. The YTD column is year to date as of the selected week, not as of today, so an earlier week shows a smaller year-to-date total. Keep this in mind when you compare two reports side by side: Last Week and This Week are both relative to whichever week you selected.
Download the report as a PDF
Choose Download PDF to save the report currently on screen. The file is named after the first day of the reporting week, in the form ring-appstore-report-week-of-<yyyy-mm-dd>.pdf.
The PDF reflects the week selected in the week selector, so select the week you want before you download. To archive several weeks, select and download each one in turn.
Reading the numbers
A few conventions apply across the table.
- An em dash (—) means no value for that cell, not zero. A metric that hasn't accrued anything yet, or that can't be computed for the period, shows a dash rather than
0. Where the distinction matters, a genuine zero is displayed as0. - No unit symbol appears next to any value. The four revenue metrics are dollar amounts, and Trial Conversion Rate % is a percentage marked by the
%in its name, so a value of150there means 150% rather than a ratio of 150. Churn Rate carries no unit in either its name or its values; confirm with Ring Support whether it is a percentage or a ratio before you chart it or set alert thresholds on it. - Trial Conversion Rate % can exceed 100. A trial that starts in one week and converts in a later week is counted against the week it converted in, so a week can record more conversions than it recorded trial starts. Read a value above 100 as conversions catching up, not as an error.
- Counts labeled "Distinct" are deduplicated by customer. Distinct New Trials Started and Distinct New Paid Subscriptions count each customer once within the period, so they can be lower than the raw event count.
Availability
Reports are available for public apps only. The Reports entry appears in the app navigation for apps on the Public Apps tab. A private app shows just Overview and Version history, with no Reports entry.
To get comparable metrics for a private integration, instrument your own app as described in Customer Lifecycle Analytics for Your App.
Reports are read-only. There is no control on the page to change what the report contains, add a metric, or change the reporting period from weekly to another interval.
