A referral program sounds simple: share a link, a friend installs, both get a bonus. In practice, 80% of implementations have bugs in attribution or payout. The most common issue: a friend installs the app but the bonus is not credited. Users get angry and contact support. We have specialized in referral system and mobile app gamification for over 5 years and delivered more than 20 turnkey projects. We guarantee correct attribution and reliable payouts. Our engineers have integrated dozens of such systems for iOS, Android, and Flutter, enabling clients to reduce user acquisition (UA) costs by up to 30%. Average savings per 1000 installs — $1,500. For a typical mid-size app, this translates to monthly savings of $8,000 on UA costs. This can save up to $15,000 per month on UA costs with a high-volume app.
Deferred Deep Linking: The Key Mechanism
Deferred Deep Link is the key mechanism. A user taps a referral link on iOS, goes to the App Store, installs, opens — the app must recall that it was opened via a specific user's link. Native Universal Link (iOS) and App Link (Android) do not preserve context when passing through the Store. An SDK is required that remembers the click before installation. Without it, install attribution is impossible, and referral bonuses cannot be credited accurately.
Main SDKs for deferred deep link:
| SDK |
Attribution Type |
Cost |
Notes |
| Branch.io |
Probabilistic fingerprinting + deterministic (IDFA/GAID) |
Freemium |
Industry standard, antifraud, install attribution |
| Adjust / AppsFlyer |
MMP, deterministic + probabilistic |
Paid |
Full analytics, retargeting, install attribution |
| Firebase Dynamic Links |
Probabilistic (IP+device) |
Free |
Being deprecated, migration required |
Branch.io is 1.5 times better than IP-based probabilistic attribution (source: Branch SDK documentation). On the client at first launch we call BranchUniversalObject.getFirstReferringParams(). If it contains referrer_id — POST to server /referrals/activate with {referrer_id, new_user_id}. We use proven SDKs and guarantee correct attribution at all stages.
How to prevent referral fraud?
The server does not simply credit a bonus on /referrals/activate. We check:
-
new_user_id has not already activated a referral (one bonus per account).
-
referrer_id is a real user.
- Condition met (if bonus is for first purchase — wait for
first_purchase event).
- Anti-fraud: IP of new user does not match referrer IP (self-referral). Also check device fingerprint via Branch API. We also use HMAC signatures to ensure server requests are not tampered with. Our anti-fraud measures block 99% of self-referral attempts.
Bonus is credited via LedgerService.credit() — atomically, with transaction_type: referral_reward. This prevents double crediting and ensures idempotency. This server validation ensures only legitimate referrals are credited.
Gamification Boosts Conversion
Referral link — https://app.example.com/r/{referral_code} — copied to clipboard with one tap or shared via UIActivityViewController (iOS)/ShareCompat.IntentBuilder (Android). QR code for referral link — CIFilter(name: "CIQRCodeGenerator") on iOS, ZXing or ML Kit Barcode on Android.
Referral program progress: how many friends invited, how many activated, how many bonuses earned. Friend list with status: invited / installed / activated / rewarded. Bonus credit animation when app opens after a successful referral — Lottie, confetti via CAEmitterLayer, with amount centered. Users who view their referral progress are 25% more likely to invite friends.
Level gamification:
| Level |
Invitations |
Bonus per friend |
| Bronze |
1–4 |
50 coins |
| Silver |
5–14 |
75 coins |
| Gold |
15+ |
100 coins |
Progress bar to next level visible on referral screen. Push notification "You only need 2 more friends to reach Gold" via FCM/APNs with deep link. Two-sided bonus (both referrer and new user) converts better — always show both amounts in sharing message.
Referral link example
The referral link structure is `https://app.example.com/r/{referral_code}`. The referral code is a unique alphanumeric string generated per user. When clicked, the SDK captures device info and redirects to the app store. After install, the app retrieves the referrer_id and credits referral bonuses accordingly.
Branch.io Attribution Details
When a referral link is clicked, Branch.io records a session with device fingerprint (IP, model, OS, timestamp). After installation, on app open, the SDK requests the Branch API, which matches the install to the session. It returns referrer_id and campaign_data. The probability of collision is less than 0.1%. Our experience shows that correct attribution increases referral program conversion by 40%.
Process of Work
- Analytics: SDK selection, server logic design.
- Deferred deep link SDK integration (Branch.io or alternative).
- Server API implementation for validation and bonus crediting.
- Referral screen UI with gamification and animations.
- Push notifications about status (FCM/APNs).
- QA: test install via referral link on real devices.
- Publication to App Store / Google Play.
What's Included
- Deferred deep link SDK selection and integration.
- Server logic for attribution, validation, and bonus crediting.
- Referral screen UI with progress bar and animations (Lottie, confetti).
- Push notifications with deep link to referral screen.
- API and architecture documentation.
- Post-launch support (2 weeks).
Time Estimates and Effectiveness
Basic integration with Branch.io and a referral screen — 2–3 business days with a ready API. With gamified levels, analytics, and push — 4–5 days. Savings on user acquisition (UA) can reach 30%, and the average LTV of an inviting user grows by 40%. This results in a high ROI through referral bonuses and reduced churn.
Get a consultation on your referral system — contact us to evaluate your project. We work turnkey. We have 5+ years of experience and 20+ successful projects.
Mobile App Monetization: IAP, Subscriptions, and Ad Mediation
An app with poorly implemented purchases loses money not because users don't want to pay, but because a StoreKit transaction hangs, Receipt Validation fails with an error, or restore purchases doesn't work — and the user writes to support or leaves a 1-star review. Our experience (over 7 years in mobile development) shows that proper monetization increases LTV by 30–60% within the first three months after implementation. Get a consultation on monetizing your app — we'll analyze the current model and find growth points.
Why StoreKit 2 is the Best Choice for IAP?
StoreKit 2 (iOS 15+) is a modern API with async/await and device-side verified transactions without a server. Transaction.currentEntitlements returns all active purchases. Key change compared to StoreKit 1: JWS signature verification on device via VerificationResult<Transaction> — no need to send receipt to server for basic validation.
But server-side validation is still needed for consumable purchases and fraud prevention. App Store Server API replaces the old /verifyReceipt endpoint. Webhooks via App Store Server Notifications v2 provide real-time events: SUBSCRIBED, DID_RENEW, EXPIRED, REFUND — without polling.
A typical mistake: not handling paymentQueue(_:updatedTransactions:) in the background for unfinished transactions. User bought a consumable, app crashed before finishTransaction — purchase remains in queue, restores on next launch and requires reprocessing on server. Without server idempotency — double crediting.
How Not to Lose Revenue on Subscriptions?
The subscription model requires tracking states: trial → active → grace period → expired → refunded. RevenueCat is the de facto standard for managing subscriptions in production. It abstracts StoreKit and Google Play Billing, providing a unified API, webhooks, cohort analytics, and A/B testing of paywalls.
Alternatives to RevenueCat include custom implementations with Adapty or Qonversion. Fully custom only if data must not leave the infrastructure or there is non-standard logic. We guarantee that webhook setup and subscription lifecycle event handling is done without losses — verified on projects with over 500k DAU.
Google Play Billing Library 6+ requires handling PurchasesUpdatedListener and explicitly calling acknowledgePurchase() or consumePurchase() within 3 days — otherwise Google automatically cancels the purchase and refunds. The average cost of such an error is a significant loss per user per month (based on our project data).
Ad Mediation: Boosting CPM via Bidding
Showing ads from a single source means losing revenue. Mediation (waterfall or bidding) requests ads from multiple networks and displays the best bid. Google AdMob is the foundation for banner, interstitial, rewarded ads. Mediation via AdMob Mediation or MAX (AppLovin) is the second de facto standard. MAX uses In-App Bidding — a real-time auction without waterfall. In practice, MAX yields significantly higher CPM than classic waterfall (depending on geo and audience). For example, for rewarded video in the US, the improvement can be substantial. With 100,000 rewarded video impressions per day, switching from waterfall to In-App Bidding can generate additional daily revenue.
ironSource (Unity Ads) has a strong position in the gaming segment, especially rewarded video. Mintegral covers the Asian audience well.
Setting up mediation requires ATT (App Tracking Transparency) on iOS 14+. Without requestTrackingAuthorization, ad CPM drops by 3-5 times for non-consenting users. SKAdNetwork and Privacy Manifest (iOS 17) are mandatory requirements; without them, review fails.
| Network |
Ad Type |
Feature |
| AdMob |
banner, interstitial, rewarded |
Wide network, easy start |
| MAX (AppLovin) |
rewarded, interstitial |
In-App Bidding, high fill rate |
| ironSource |
rewarded video |
Best for games |
| Mintegral |
rewarded, native |
Asia, programmatic |
How We Implement Monetization: Step-by-Step Process
- Current model audit — analysis of funnel, paywall, price tiers, and identification of bottlenecks.
- Model design — choose type (subscription, consumable, non-consumable) and optimize price points.
- IAP integration — set up StoreKit 2 / Google Billing 6, receipt validation, webhooks.
- Ad mediation — connect 3-6 networks, configure waterfall or In-App Bidding, test fill rate.
- Analytics and cohorts — integrate RevenueCat, Amplitude, or Firebase for LTV tracking.
- A/B testing of paywall — use Remote Config for experiments without a release.
- Launch and monitoring — 2 weeks of free support after launch, bug fixes by 24-hour SLA.
How to Design a Freemium Model and Paywall?
Freemium works when the boundary between free and paid is properly drawn. Too strict a paywall at the start — users delete. Too generous a free tier — no incentive to pay.
A technically sound pattern: server-side feature flags (Remote Config in Firebase or LaunchDarkly) control access to features. This allows A/B testing of paywall without a release, changing trial conditions, and running promotions.
Implementation at the code level: EntitlementManager — a single point for checking access to features, aware of subscription status, flags, and promos. No scattered isPremium checks throughout the code. Experience shows this approach reduces paywall-related bugs by 80% (confirmed on 30+ projects).
Checklist of Typical Monetization Mistakes
- Missing handling of
unfinished transactions — revenue loss of 5-10%.
- No server-side idempotency for consumable processing — double crediting.
- Forgot to call
acknowledgePurchase() on Android — purchase cancelled after 3 days.
- Not handling
REFUND and DID_RENEW events — incorrect subscription status.
- Paywall without A/B testing — leaving 20-40% of monetization potential.
- Ads from a single source (e.g., AdMob without mediation) — CPM 15-30% lower.
Scope of Monetization Work
- Current model audit — analysis of funnel, paywall, price tiers.
- IAP integration — StoreKit 2 / Google Billing 6, receipt validation, webhooks.
- Ad mediation — configure MAX / AdMob, connect 3-6 networks, test fill rate.
- Analytics setup — RevenueCat, Amplitude / Firebase, cohort analysis.
- Documentation — description of entitlements, restoration procedure, review checklist.
- Team training — analysis of typical mistakes, support recommendations.
- Guarantee — 2 weeks free support after launch, bug fixes by 24-hour SLA.
Estimated Timelines
| Stage |
Duration |
| Basic IAP (one store) |
1–2 weeks |
| Subscription system + RevenueCat + paywall |
3–5 weeks |
| Ad mediation (MAX + 3 networks) |
1–2 weeks |
| Full cycle (IAP + ads + analytics) |
4–8 weeks |
Cost is calculated individually. We have been working in this field for over 8 years and have implemented monetization in over 40 projects — many of which passed App Store Review without a single rejection. Contact us for an audit or order a consultation — we'll tell you what growth points exist in your app.