RevenueCat

What you need

A RevenueCat account with at least one project. The grant RevenueCat issues is developer-level and covers every project of the account, so one account is one connection in Kwern.

Connect it

Open Settings · Add an account and press Connect RevenueCat. RevenueCat asks you to authorize Kwern; the scopes it asks for are the overview metrics, the charts, the projects and the apps, all read-only.

Then open the product's Apps page, press Choose what Kwern reads and choose the RevenueCat project.

What Kwern reads

The project's overview metrics, each with the period RevenueCat gives it: a live figure, or a 28-day window. From those, five lines accumulate day by day as the connector's series:

• MRR, active subscriptions and active trials — the standing figure of each day
• revenue and new customers — what that day brought

Every figure is read in US dollars. Left to the account's display currency, a series would change denomination the day somebody switched the dashboard.

Every day ever seen is kept and never windowed, so a range you ask for a year from now still answers. A sync re-reads the days since the last one plus a week of overlap, because payments settle late.

Apple Ads revenue per campaign

With Apple Ads connected to the same product, the ASO agent's weekly App growth report puts the revenue RevenueCat attributes to each Apple Ads campaign next to that campaign's spend, as ROAS per campaign. RevenueCat names the campaign only on its Advanced Apple AdServices integration. Until it does, the Revenue page offers Turn on attribution, which walks these steps:

1. Collect the AdServices token — Apple mints the attribution token on the device, so only your app can hand it to RevenueCat. Call enableAdServicesAttributionTokenCollection() right after Purchases.configure, in the build your users run (iOS 14.3 or later). Open RevenueCat's guide
2. Choose Advanced — In RevenueCat, open the project's Integrations, then Apple AdServices, and choose Advanced. Basic ties revenue to Apple Ads but never to a campaign name. Open RevenueCat
3. Sign in with Apple — Advanced asks you to Sign in with Apple. Use an Apple Ads user who is Account Admin or Campaign Group Manager, and pick Read Only: RevenueCat only reads the names.
4. Expect data within 7 days — RevenueCat can take up to 7 days to name campaigns, and names only what comes after. Kwern's daily syncs pick the names up, and the weekly App growth report then gives ROAS per campaign.

   Apple attributes no install from an ad group that targets by age or gender, so its revenue never reaches a campaign.

Nothing is stored along the way: Kwern's daily syncs are the check, and the page stops offering the steps once campaign names appear.

What Kwern can change

Nothing. There is no RevenueCat proposal and no RevenueCat publisher: the grant Kwern holds reads and cannot write. No customer identifier, no email and no receipt is read either — the overview metrics and the project list, and nothing per person.

The agents that use it

No agent needs RevenueCat to run. Its numbers are what every agent reads as the product's reality — whether a listing change is worth making, whether an ad budget is worth defending — and what the Revenue tab of Analytics charts.

When it breaks

RevenueCat allows 25 charts and metrics calls a minute per key, so Kwern caches the overview for fifteen minutes: a dashboard render, an agent run and the daily sync never race each other into a rate limit. Refresh tokens live thirty days and rotate on use; Kwern renews an idle grant before it dies. A revoked grant marks the account as needing attention until you reconnect.

RevenueCat connector · All connectors · How a product is set up