8 min read
Mobile App Trial-to-Purchase Tracking: RevenueCat Integration Best Practices
Turn trial behavior into revenue signals with source-level attribution
· Grometrics Team
The short version
Most mobile app teams know how many trials they start. Few know which marketing channels actually convert those trials into paying customers. RevenueCat handles the subscription logic, but without connecting that data to your acquisition sources, you're guessing which campaigns create real revenue. Grometrics links RevenueCat purchase events to your traffic sources so you can see trial-to-paid conversion by campaign, ad group, and keyword, not just aggregate revenue numbers. This guide covers the setup steps and best practices for getting source-level visibility into your trial-to-purchase funnel.
- Connect RevenueCat to Grometrics in minutes via API or SDK
- Track trial start, conversion, cancellation, and refund by acquisition source
- Identify which campaigns drive actual paid conversions versus wasted trial starts
- Use screen-level tracking to find where users drop before reaching your paywall
- Combine RevenueCat data with Apple Search Ads spend for real ROAS reporting
Why trial-to-purchase tracking needs source attribution
RevenueCat gives you transaction data, including purchases, renewals, trials, cancellations, and refunds. That's the revenue side of the equation. But the question that drives spending decisions is: which channel brought the user who just converted? Without that link, you're optimizing for volume rather than quality.
Ad platforms report their own conversion claims. Apple Search Ads shows installs. Meta reports app events. But those platforms grade their own homework. They claim conversions they didn't necessarily drive so you keep spending. Grometrics connects the full journey: from install source through onboarding screens to the RevenueCat transaction, so you see what actually created a paying customer.
For mobile app teams running paid acquisition, this matters because trial starts are cheap. Converting those trials is what pays for the user. If you're spending on channels that generate many trials but few conversions, you're burning budget on vanity metrics. If you're missing channels that convert trials at a higher rate, you're leaving revenue on the table.
- RevenueCat transaction data without source context shows what happened, not why
- Ad platform reporting favors channels that claim credit, not channels that drive revenue
- Trial conversion rate varies significantly by acquisition source in most mobile apps
- Understanding source-level conversion helps you allocate budget to channels that create customers, not just installs
What you cannot see with RevenueCat alone: RevenueCat shows you transaction events and subscription metrics. It does not show you which campaign, keyword, or ad creative brought the user who just converted. It also does not show you where users dropped off in your onboarding funnel before reaching the paywall. Grometrics fills both gaps by connecting RevenueCat events to first-party acquisition data.
Setting up RevenueCat integration in Grometrics
Getting RevenueCat data into Grometrics takes a few steps. First, you add your RevenueCat public API key in the Grometrics dashboard under Integrations. Then you configure which subscription events you want to import, including trial starts, conversions, renewals, cancellations, and refunds. Grometrics pulls this data on a schedule that keeps your revenue numbers current without overloading your systems.
The integration maps RevenueCat product identifiers to your internal product names so reporting stays consistent. You can also set up event filtering to exclude test purchases or specific product types if your app has multiple subscription tiers.
If you're already tracking install sources through Grometrics SDK or server-side integration, the RevenueCat data joins automatically. You don't need to reconfigure your existing tracking setup.
- Add RevenueCat public API key in Grometrics Integrations settings
- Select which events to import: trials, purchases, renewals, cancellations, refunds
- Map RevenueCat product IDs to your internal product names
- RevenueCat events auto-join with existing source attribution if SDK is already installed
- No changes to your app code required beyond initial SDK setup
Setup timing: Most teams complete the RevenueCat integration in under 10 minutes. The SDK installation for mobile apps (iOS, Android, React Native, Flutter) is separate and typically takes a few minutes per platform. Both can be done in parallel.
Tracking the trial-to-purchase funnel by source
Once RevenueCat data flows into Grometrics, you can build a funnel that starts with the acquisition source and ends with the paying customer. The funnel view shows trial starts, trial conversions, and revenue, all broken down by the campaign, ad group, or keyword that brought each user.
This is where most mobile teams discover surprises. A channel that generates many trial starts might have a low conversion rate. A smaller channel with fewer trials might convert at double the rate. Without source-level visibility, you'd optimize toward the high-volume channel and miss the efficient one.
Grometrics also surfaces refund events in the funnel. If a channel has high trial volume but also high refund rates, that's a signal that users are starting trials but churning quickly. This could indicate a mismatch between the channel's audience and your app's onboarding, or a pricing issue that shows up after the trial period.
- Funnel view: acquisition source → trial start → trial conversion → paid revenue
- Compare conversion rates across campaigns, ad groups, and keywords
- Identify channels with high trial volume but low conversion
- Track refund rates by source to catch quality issues early
- See revenue per trial start (not just total revenue) to find efficient channels
Refunds matter for attribution: A trial that converts but then refunds within 30 days costs you money in ad spend and processing fees. Grometrics ties refunds back to the original acquisition source so you can see which channels drive users who actually stick versus users who churn immediately after converting.
Screen-level journey tracking before the paywall
RevenueCat tells you when a purchase happens. It doesn't tell you what happened in your app before that purchase. If users are dropping off at a specific onboarding screen before they ever see your paywall, RevenueCat won't show you that. Grometrics screen-level tracking fills this gap by recording every screen a user visits from install through purchase.
This matters because many trial-to-purchase failures happen before the paywall. Users might bounce on a feature explanation screen, drop on a pricing disclosure, or abandon during a forced login flow. With screen-level tracking, you see exactly where the funnel breaks and which acquisition sources have users who reach the paywall versus users who drop early.
When you combine screen-level data with RevenueCat conversion data, you get a complete picture: which sources bring users who actually see the paywall, which sources bring users who bounce early, and which sources convert at the highest rate once they reach the purchase screen.
- Track every screen from install to purchase for each user journey
- See drop-off points by individual screen in your onboarding flow
- Compare screen-level retention by acquisition source
- Identify paywall reach rates: what percentage of trial starts actually see your purchase screen
- Find screens that cause disproportionate drop-off across all sources or specific channels
Onboarding screens and paywall reach: If only 40% of trial starts from a specific campaign reach your paywall, that explains the low conversion rate. The problem isn't pricing or product fit, it's getting users to the purchase decision. Fix the onboarding flow, and that channel's conversion rate may improve without changing your ad spend.
Combining RevenueCat with Apple Search Ads for ROAS
If you're running Apple Search Ads, you can import your keyword-level spend data into Grometrics and combine it with RevenueCat revenue. This gives you real return on ad spend at the keyword level using actual revenue, not estimated conversion values from purchases, renewals, and refunds attributed to each keyword.
The workflow is straightforward. Import your Apple Search Ads campaign data through the Ads integration. RevenueCat data is already flowing. Grometrics matches RevenueCat transactions to the Apple Search Ads click that created the user. You see spend, revenue, and ROAS for each keyword, with refunds deducted from the revenue side.
This closes the loop that ad platforms leave open. Apple Search Ads reports installs and in-app events. Grometrics shows you the revenue. When a keyword has many installs but low revenue, you can reduce spend. When a keyword has fewer installs but strong revenue, you can scale. The decision moves from optimizing for install volume to optimizing for revenue contribution.
- Import Apple Search Ads spend at keyword level
- Match RevenueCat purchases to Apple Search Ads clicks
- Calculate real ROAS: revenue minus refunds divided by spend
- Compare keyword performance across install count, trial conversion, and revenue
- Make spend decisions based on revenue contribution, not install volume
Real ROAS versus platform ROAS: Apple Search Ads reports ROAS based on its own event attribution, which often includes events that don't result in revenue. Grometrics uses actual RevenueCat transaction data, including refunds, so your ROAS reflects money that actually hit your account, not estimated conversion values.
Best practices for ongoing trial tracking
Setting up the integration is the first step. Keeping the data useful requires a few ongoing practices. First, review your trial-to-purchase funnel weekly during active campaigns. Channels perform differently over time as creative fatigue sets in or audience targeting shifts. Weekly review catches shifts before they eat your budget.
Second, segment by product if your app has multiple subscription tiers. A channel that converts well to a basic plan might underperform on premium tiers. RevenueCat product mapping in Grometrics lets you see this split so you can allocate budget toward the tiers that match your high-performing channels.
Third, watch for refund concentration. If one channel has a refund rate double your average, that's a signal to investigate. The issue might be audience mismatch, or it might be a pricing page problem that only affects users from that source. Grometrics refund attribution by source makes this visible.
- Review trial-to-purchase metrics weekly during active campaigns
- Segment conversion and revenue by subscription tier
- Monitor refund rates by source and investigate anomalies
- Update product mappings when launching new subscription tiers
- Use screen-level data to identify onboarding improvements that lift conversion across all sources
Keep your RevenueCat API key secure: Grometrics accesses RevenueCat data through your public API key with read-only permissions. You can revoke access at any time from the RevenueCat dashboard. Grometrics does not write any data back to RevenueCat. It only reads transaction events for attribution purposes.
READY TO SEE YOUR REAL NUMBERS?
Connect your payment provider and see which channels actually drive revenue.
Start tracking for free →RELATED POSTS