GrowSurf Docs
Help CenterSystem StatusContact SupportYour Dashboard →
  • Welcome
  • Getting Started for Web
    • Google Tag Manager
    • Participant Auto Authentication
  • Getting Started for Native Mobile
  • Developer Tools
    • Embeddable Elements
    • JavaScript SDK
      • Tutorials
      • Single Page Applications
      • API Reference
    • REST API
      • Tutorials
      • Objects
      • API Reference
      • API Guidelines
      • API Response Codes
    • Webhooks
      • Securing Your Webhooks (optional)
      • Examples
      • Events Reference
    • Metadata
  • Integrations
    • ActiveCampaign
      • Tutorials
    • Amplitude
    • AWeber
      • Tutorials
    • Brevo (formerly Sendinblue)
      • Tutorials
    • Cal.com
    • Calendly
    • Campaign Monitor
      • Tutorials
    • Chargebee
    • Constant Contact
      • Tutorials
    • ConvertKit
      • Tutorials
    • Customer.io
      • Tutorials
    • Drip
      • Tutorials
    • EmailOctopus
      • Tutorials
    • Fullstory
    • GetResponse
      • Tutorials
    • Google Ads
    • Google Analytics
    • Heap
    • Help Scout
    • HubSpot
      • Tutorials
    • Intercom
      • Tutorials
    • Klaviyo
      • Tutorials
    • LinkedIn Ads
    • Mailchimp
      • Tutorials
    • MailerLite
      • Tutorials
    • Mailjet
      • Tutorials
    • Make
      • Tutorials
    • Marketo
      • Tutorials
    • Meta (Facebook) Ads
    • Mixpanel
    • Pabbly Connect
      • Tutorials
    • PayPal
    • Pendo
    • PostHog
    • Recurly
    • Salesforce
      • Tutorials
    • Segment
    • SendGrid
      • Tutorials
    • Slack
    • Stripe
    • Tango Card
    • Typeform
    • X (Twitter) Ads
    • Zapier
      • Tutorials
      • Using Filters
      • Troubleshooting
Powered by GitBook
On this page
  • Referral tracking
  • Referral trigger
  • Referral portal

Was this helpful?

Getting Started for Native Mobile

For native iOS and Android app integration, start here once you've created your GrowSurf campaign.

Last updated 3 months ago

Was this helpful?

In order to integrate a referral program into your native iOS or Android application, there are three flows to consider (you can mix and match any of these with implementations):

  1. - knowing when someone who downloads your app came through a referral link

  2. - knowing when the referred friend performs a qualifying action, which unlocks rewards

  3. - giving your logged-in users a way to share their referral link and check the status of their referrals

Referral tracking

Let's say you want to track which users that downloaded your app came through a referral link.

You have two options for referral tracking on mobile.

Option #1: Web + native mobile integration

This option makes sense if you want to quickly integrate referral tracking, but the user experience may be compromised.

Here's what the flow looks like:

  1. Someone visits a participant's unique referral link on their mobile device (e.g, ).

    1. This webpage should have a form to capture the referred friend's email address.

  2. Once submitted, the form redirects the referred friend to the Apple App Store or Google Play Store in order to allow them to install the app.

  3. The referred friend installs the app.

Instructions:

There are no special requirements to achieve this flow. You can follow .

Option #2: Native mobile integration

This option makes sense if you want to have a seamless native referral tracking integration, but more development effort is required. You will need to use in conjunction with the .

Here's what the flow looks like:

  1. Someone visits a participant's unique referral link on their mobile device (e.g, ).

    • This URL should be using deferred deeplinking (this is necessary to pass the grsf URL parameter to Step #3).

    • This URL should contain JavaScript that detects what mobile device the user is on, and automatically redirects the user to the Apple App Store or Google Play Store in order to allow them to install the app.

  2. The referred friend installs the app.

  3. They open up the app and sign up (this is where you call the GrowSurf REST API endpoint and pass in the grsf URL parameter from Step #1 as the referredBy value).

    • If you are unable to implement deferred deeplinking, you can provide an input field at signup to allow the user to enter their referrer's ID or email.

    • As a pro tip, GrowSurf participants support , so you can include any custom data that you'd like when adding the new referred participant. This is useful if you want to issue .)

Instructions:

In order to achieve this flow, you will need to use deferred deeplinking (for more information on this topic, check out ). As there is no industry standard for deferred deeplinking, and are some out-of-the-box solutions.

You can also skip step #1 when following your campaign's installation page instructions (in other words, no need to install the GrowSurf Universal Code on your Share URL).

Referral trigger

To unlock rewards, your referred mobile users will need to complete a qualifying action that .

Referral portal

These are the most common endpoints used by GrowSurf customers:

On the server-side, you'll need to call the GrowSurf REST API endpoint .

This endpoint only requires the referred logged-in user's email address at a minimum (this person will already exist as a referred GrowSurf participant in your campaign from the step above).

For the use-case of providing your mobile app users with their referral links and the ability to see the status of their referrals, you would use the to retrieve data and display on the client-side.

(to display the logged-in user's referral link)

(to send email invites on behalf of the logged-in user)

(to display the logged-in user's referral statuses and invites)

/POST Trigger Referral by Participant Email
GrowSurf REST API
/GET Participant by Email
/POST Send Participant Invites by Email
/GET Participant Referrals and Invites by Email
Web
https://yoursite.com?grsf=abc123
Getting Started for Web
deferred deeplinking
GrowSurf REST API
https://yoursite.com?grsf=abc123
/Add New Participant By Email
metadata
dynamic rewards
Adjust's in-depth blog post here
Adjust
Branch
triggers a referral
Referral tracking
Referral trigger
Referral portal
referral tracking