Terminal
Terminal/Skill
Walks through reading a RevenueCat A/B test, from its setup and supporting charts to its results.
By RevenueCat
Works with
npx skills add revenuecat/ai-toolkit --skill revenuecat-experiment-analysisTo analyze an experiment, follow the following steps. Make sure to execute all steps in this order, do not skip any. More details on the step below. If you already have partial information (eg. the experiment ID), you may skip that step only. Continue following all of the other steps. Within a step, issue independent calls together so they run in parallel.
If you don't have the experiment ID yet, find it using the list-experiments RevenueCat tool. It receives a single parameter: project_id, which requires the proj... Project ID. You can also pass a status filter (draft, running, paused, stopped).
Get the experiment setup / metadata by using the get-experiment RevenueCat tool. Parameters: project_id (as above) and experiment_id (from step 1). Pass the following values to the expand parameter: offering.package.product.indicative_price and offering.paywall.
Relevant information to extract:
placements object which defines different offerings per placement (eg. onboarding, feature gate, ...). Offerings include details on the products offered. Products include an indicative_price. Note that only USD prices for the US are returned to provide an understanding of overall pricing levels. Any introductory price is not returned. For price localization tests, tests scoped explicitly outside of the US, or introductory prices, this will not provide the full picture, you might have to resort to the get-product-store-state tool instead (see the revenuecat-store-state skill). Offerings may also include a paywall_id, if the offering uses a RevenueCat Paywall. If paywall_id is null, that means the app is using a custom paywall.indicative_price and the subscription fields (trial_duration, duration) reflect what RevenueCat last synced from the store and can be stale. Before presenting a trial, intro offer, or price from these fields as fact, or flagging one as an experiment confound, confirm with get-product-store-state and cross-check the results' trial metrics.draft means the experiment has not yet started, and there are no results yet.running means the experiment is still actively enrolling new customers.paused means the experiment is no longer enrolling customers, but already-enrolled customers are still assigned to their variant, and the experiment is continuing to collect data for up to 400 days. The experiment can be resumed to continue enrolling new customers.stopped means the experiment is no longer enrolling customers, and already-enrolled customers have gone back to being served their default offering. Results continue to refresh for up to 400 days. The experiment can no longer be started or resumed.For any paywall_id in any offering of the experiment, use the render-paywall-screenshot tool (parameters project_id, paywall_id, version: "published") to look at the paywall and understand the differences. Pass version: "published" so you see what customers were served; the tool defaults to the draft, which may contain unpublished edits. Skip this step if every offering uses a custom paywall (paywall_id is null).
Pull recent chart data scoped to the experiment's runtime, using the get-chart-data RevenueCat tool. Do not skip this step, it provides valuable context to how the app was performing overall in the time frame.
Parameters:
Also pull data for chart_name :
Get the experiment results (so far) using the get-experiment-results RevenueCat tool.
Parameters:
iosusexposed for customers who viewed a paywall or not_exposed for customers who did not view a paywall. Omit this parameter to include all enrolled customers. This filter is available for both enrollment modes.The results can include a metric named Exposed customers. Refer to it as Paywall viewers when talking to the user.
Understanding what changes were made in the experiment, now interpret the results. Use your best judgment.
If the user disputes a claim you derived from catalog metadata, verify it yourself with get-product-store-state rather than asking the user to check the store.
Report your overall findings back to the user, with links to the relevant charts and dashboard entities (see the revenuecat-dashboard-links skill).