Shape
A series by cohort date; recent cohorts are still maturing
Chart · Conversion
Initial conversion is the share of each period's new customers who started a free trial or bought anything within a chosen timeframe: day 0, 3, 7, 14 or 30 days, or unbounded. It is customers with a trial start or a purchase divided by new customers. Renewals do not count.
Formula
Initial conversion rate = new customers with a trial start or purchase in the timeframe / new customers
Shape
A series by cohort date; recent cohorts are still maturing
API name
initial_conversion
Measures
Initial Conversion (Percent)
Filter and segment by
App, Store, Product, Product duration, Offering, Country, Platform, App version
Definition
New customers are grouped by their cohort date. For each one, RevenueDot looks for a trial start, a subscription purchase or a one-time purchase inside the timeframe. Day 0 means the calendar day (UTC) of the cohort date, and 7 days means that day plus the next seven. A customer counts once, however many things they bought.
The timeframe is the conversion_timeframe selector and defaults to 7 days. A trial start counts as a conversion even though no money has moved yet, which is why this chart reads higher than Conversion to Paying. A paid introductory offer is not told apart from a regular purchase and counts as a direct purchase.
Cohorts whose timeframe has not finished stay marked incomplete until it has. Filters on the purchase (store, product, offering) change what counts as a conversion but never change the new-customer denominator. Sandbox purchases are excluded. You can open it in the dashboard under Charts or fetch it with GET /v2/projects/{project_id}/charts/initial_conversion. The response has the same shape as RevenueCat's Charts API, so scripts written for that API keep working. The secret key needs the charts_metrics:charts:read permission. The Charts guide lists every parameter.
Worked example
A week with 200 new customers, read at the 7 day timeframe.
| Step | Customers |
|---|---|
| New customers | 200 |
| Started a free trial within 7 days | 30 |
| Bought without a trial within 7 days | 6 |
| Initial conversions | 36 |
Initial conversion is 36 / 200 = 18.0%.
Why it matters
Initial conversion is the first measure of whether your paywall and onboarding turn visitors into subscribers or trial users. It reacts within days of a change, long before revenue charts do, so it is the right chart to watch while you test paywall copy, prices or the placement of the paywall in onboarding.
It also shows when you are leaving money on the table before the paywall. If few new customers reach any purchase screen, the fix is earlier in the flow. Compare the day 0 and the 7 day timeframes: a large gap means customers need time and reminders, a small gap means they decide in the first session.
API
Same path and response shape as RevenueCat's Charts API, so existing scripts keep working.
curl "https://api.revenuedot.app/v2/projects/$PROJECT_ID/charts/initial_conversion?resolution=day" \
-H "Authorization: Bearer $SECRET_KEY" # sk_... with charts_metrics:charts:read Reference: Charts guide · REST API v2
FAQ
It is the share of new customers who start a trial or buy something within a set number of days after they first appear. Both a trial start and a purchase count as a conversion.
Initial conversion starts from new customers and counts trial starts and purchases. Trial conversion rate starts from customers who already started a trial and counts how many of them paid.
Use 7 days as a default and add 0 days to see first-session decisions and 30 days to see late converters. Pick one and keep it when you compare periods.
No. Only a trial start, a subscription purchase or a one-time purchase counts, and each customer counts once.
Get started
Connect your app to RevenueDot Cloud, free up to $10,000 a month in tracked revenue, and all 43 charts fill from your store history after import.
Already have an account? Sign in · Prefer your own servers? Self-host free