Skip to content
upseamdocs
Open the App GitHub

Analytics

What a verified vendor sees in the Upseam App: what happened to each change you pushed, which SDK versions are in use and the public npm downloads.

On this page

A verified vendor gets a page in the Upseam App with numbers about the changes it pushed. Every number about users is a range, never a count. The rules are on What vendors see about users.

#Who can open it

Sign in to the App with GitHub and add the API vendor workspace to your account under Settings, Account. You see your provider when the Upseam GitHub App is installed on the account that owns the verified repository and you have access to that repository. Everyone else who is signed in gets the same "This page does not exist" answer, whether the provider is registered or not.

#Overview

The Overview of your provider shows:

  • Changes pushed in the last 30 days: how many changes you sent. This is your own data, not a count of users.
  • The flow of your changes. Of the organizations your changes reached, how many fixed them with an Upseam pull request, fixed them without Upseam, or still have them open. A table under the chart gives the same numbers as ranges, and on a narrow screen only the table shows.
  • Acceptance. How organizations decided on your changes, as bars.
  • SDK versions. Organizations by major version of your SDKs, taken from their subscriptions to your provider. Versions with too few organizations are merged into Other.
  • Merges by day. The merged range of each change on the day you pushed it.
  • Public npm downloads from the last 7 days, for up to 3 of your npm packages: the top 5 versions of each and Other versions. PyPI downloads are not shown.

#Changes

Changes is a feed of your pushed changes grouped by month. A change opens its own page with its flow and a table of the same numbers.

Note

Usage and Impact preview are listed in the App and show that they are coming. They show no numbers yet.

#How the numbers read

Each number is a range such as 25–49, or fewer than 15. The ranges are 15–24, 25–49, 50–99, 100–249, 250–499, 500–999, 1,000–2,499, 2,500–4,999 and 5,000 or more. A sum over several changes is a range that contains the true total. A share is shown only when both numbers are at least 25, rounded to 10%.

A change that Upseam delivered but did not yet count shows analytics later. Upseam counts at most 5 new changes per provider in any rolling 7 days. Every change is still stored and delivered to users as usual.

A total that adds parts reads fewer than 25 when it is hidden.

The analytics load up to 30 times an hour per provider.