Referral gamification invite-a-friend bonus in mobile app

NOVASOLUTIONS.TECHNOLOGY is engaged in the development, support and maintenance of iOS, Android, PWA mobile applications. We have extensive experience and expertise in publishing mobile applications in popular markets like Google Play, App Store, Amazon, AppGallery and others.
Development and support of all types of mobile applications:
Information and entertainment mobile applications
News apps, games, reference guides, online catalogs, weather apps, fitness and health apps, travel apps, educational apps, social networks and messengers, quizzes, blogs and podcasts, forums, aggregators
E-commerce mobile applications
Online stores, B2B apps, marketplaces, online exchanges, cashback services, exchanges, dropshipping platforms, loyalty programs, food and goods delivery, payment systems.
Business process management mobile applications
CRM systems, ERP systems, project management, sales team tools, financial management, production management, logistics and delivery management, HR management, data monitoring systems
Electronic services mobile applications
Classified ads platforms, online schools, online cinemas, electronic service platforms, cashback platforms, video hosting, thematic portals, online booking and scheduling platforms, online trading platforms

These are just some of the types of mobile applications we work with, and each of them may have its own specific features and functionality, tailored to the specific needs and goals of the client.

Showing 1 of 1 servicesAll 1735 services
Referral gamification invite-a-friend bonus in mobile app
Medium
~2-3 business days
FAQ
Our competencies:
Development stages
Latest works
  • image_mobile-applications_feedme_467_0.webp
    Development of a mobile application for FEEDME
    761
  • image_mobile-applications_xoomer_471_0.webp
    Development of a mobile application for XOOMER
    649
  • image_mobile-applications_rhl_428_0.webp
    Development of a mobile application for RHL
    1071
  • image_mobile-applications_zippy_411_0.webp
    Development of a mobile application for ZIPPY
    947
  • image_mobile-applications_affhome_429_0.webp
    Development of a mobile application for Affhome
    884
  • image_mobile-applications_flavors_409_0.webp
    Development of a mobile application for the FLAVORS company
    466

Implementing Referral Gamification (Invite Friends, Get Bonus) in Mobile App

Referral program looks simple—shared link, friend installs, both get bonus. In practice, two-thirds of implementations have attribution or payout bugs. Most common: friend installed but bonus didn't credit. Users get angry, support overloaded. Attribution of install to referral link—technically non-trivial.

Install Attribution

Deferred Deep Link—key mechanism. User taps referral link on iOS, goes to App Store (app not installed), installs, opens—app must "remember" it opened via referral link from specific user.

Native iOS Universal Link and Android App Link don't preserve context through Store. Need deferred deep link SDK:

  • Branch.io—industry standard for referrals. SDK on iOS and Android on first open queries Branch API, which matches install with prior session over link via device fingerprint (IP + device model + OS version + timestamp correlation). Returns referrer_id and campaign_data.
  • Firebase Dynamic Links—free alternative, but Google announced deprecation (2024). Requires migration.
  • Adjust / AppsFlyer—MMP (mobile measurement partners), more precise via probabilistic fingerprinting + deterministic (IDFA/GAID with consent).

On client first launch: BranchUniversalObject.getFirstReferringParams() → if contains referrer_id → POST to server /referrals/activate with {referrer_id, new_user_id}.

Server-Side Validation

Server doesn't just credit on /referrals/activate. Checks:

  • new_user_id hasn't already activated referral (one bonus per account).
  • referrer_id—real user.
  • Condition met (if bonus on first purchase, not install—wait first_purchase event).
  • Anti-fraud: new user IP doesn't match referrer IP (self-referral).

Bonus credited via LedgerService.credit()—atomically, with transaction_type: referral_reward.

UI: Referral Screen

Referral link—https://app.example.com/r/{referral_code}—copied one tap or shared via UIActivityViewController / ShareCompat.IntentBuilder. QR code—CIFilter(name: "CIQRCodeGenerator") on iOS, ZXing or ML Kit Barcode on Android.

Referral progress: how many friends invited, how many activated, how much earned. Friend list with status—invited / installed / activated / rewarded. Motivates more sharing.

Bonus credit animation on app open after successful referral—Lottie, confetti via CAEmitterLayer, with bonus amount centered.

Referral Program Level Gamification

Basic: invite 1 → get bonus X. Gamified: reach levels. Example:

Level Invites Bonus per Friend
Bronze 1–4 50 coins
Silver 5–14 75 coins
Gold 15+ 100 coins

Progress bar to next level on referral screen. Notification "2 more friends to Gold"—push via FCM/APNS with deep link.

Two-way bonus (referrer and new user both rewarded) converts better than one-way—show both amounts in share message: "Come, get 100 coins, I'll get 100 too".

Process

Choose and integrate deferred deep link SDK → server referral validation logic → referral screen UI + animations → push notifications on status → QA (test install via referral link on real devices) → publication.

Timeline Estimates

Implementation with Branch.io, referral screen, server validation, basic animations: 2–3 working days with ready API. With gamified levels and referral analytics: 4–5 days.