Read only access to your store revenue: which keys each store needs
In short: a revenue dashboard never needs your store password or an admin key. Each store has a way to grant read only access to sales data: an App Store Connect API key with the Sales and Reports role, a Google Play service account with only "View financial data", a read only Google sign in for AdMob, and a Steamworks Financial API key. This guide shows what each one can and can not do.
App Store Connect: a team key with Sales and Reports access
In App Store Connect, go to Users and Access, then Integrations, App Store Connect API, Team Keys, and generate a key with the Sales and Reports role. That role can download Sales and Trends reports but can not change apps, prices, users or banking details. Do not use an Admin or Finance key for a dashboard.
The tool needs the issuer ID, the key ID, the private key file (.p8, which Apple only lets you download once) and your vendor number from Payments and Financial Reports. Apple keeps daily sales reports for one year, so that is how far back any tool can import daily figures.
Google Play: a service account with "View financial data"
Google Play has no earnings API. The documented way to read revenue is through the monthly report files Google writes to a private Cloud Storage bucket for your developer account. To give a tool access:
- In Google Cloud Console, create a project, enable the Cloud Storage JSON API and create a service account without any project roles, with a JSON key.
- In Play Console, under Users and permissions, invite the service account's email address with only the View financial data permission at account level. Google can take up to 24 hours to activate it.
- Copy the Cloud Storage URI from Download reports; the
pubsite_prod_...part is the bucket the reports are in.
With only the read only storage scope, the service account can download report files and nothing else: it can not publish releases, answer reviews or change store listings.
AdMob: a read only Google sign in
The AdMob API does not accept service accounts, so access is granted by signing in with Google once and approving the admob.readonly scope. That scope can generate earnings reports but can not change ad units, mediation or payment settings. You can withdraw it at any time on your Google account's permissions page.
Steam: a key from a Financial API group
Steam sales data is available through the Steamworks Partner Financial API. In Steamworks, under Users and Permissions, Manage Groups, choose Create new Financial API Group (not a normal group), create its Web API key and tick only the Financial permission. Valve also lets you restrict the key to the IP addresses of the server that uses it.
A key from a normal Web API group is accepted by Steam but returns no sales data, which is the most common reason a Steam connection shows nothing.
What to ask any revenue tool
- Does it ask only for the read only roles above, never for passwords or admin keys?
- Are the keys encrypted when stored, and are they ever shown again after saving?
- Where is the data stored, and can you delete your account and all keys yourself?
RevenueOverview uses exactly these read only methods. Every key is encrypted with XChaCha20-Poly1305 before it is stored, is never shown again after saving, and the data is kept on a server in Germany. You can remove a single store or delete your whole account from the settings page.
Sources
See all your store revenue in one place
RevenueOverview reads the App Store, Google Play, Steam and AdMob for you and shows one total in your own currency.
Try it free How it works