How the UrbanPiper Referral system works

This article provides an overview of the referral system's functioning and what might be the reasons for it not to work as expected

Written By Anirban Majumdar (Super Administrator)

Updated at December 20th, 2021

The referral system used in the apps and websites of UrbanPiper is based upon a unique "link". This link resembles a standard web link like – https://{var}{var} and has some interesting properties associated with it.

  • This link can intelligently determine whether the user needs to be taken to the Google Play Store or Apple App Store or the website depending upon the device in which the link is clicked. So, if a user clicks on this link from an email or messenger client using an Android device, the user will be taken to the Play Store, if the app is not installed. Otherwise, it will launch the app. This feature is called deep-linking.
  • This link contains information about who shared it and which platform – email, Facebook, Twitter, Whatsapp, etc – was used to share it.

For the referral system to work, the referral loop needs to be completed. This loop implies the following sequence of events need to occur:

  1. A registered user shares a link using the Android app, iOS app or website. This link is available in the "Referral" section of the apps or website.
  2. This link uniquely identifies the user who shared it in the first place and will be different for different users.
  3. The user can choose to share this link any which way – email, messenger, social platforms, etc.
  4. For any other person who clicks on the link, one of the following 2 things can occur:
    1. If the user is using an Android or an iOS device and does not have the app installed, she will be taken to the Google Play Store or Apple App Store listing of the app. If the user has the app installed, then the app will be launched.
    2. If the user is using a laptop or PC, the website of the merchant will open up.
  5. If the user is not already registered and signs-up through the app/website, then upon placing the next order, the referral loop is completed. Depending upon what the merchant has configured, both the person sharing the link and the new person placing the order will get some benefits.

How the referral loop can be broken

The referral loop is sometimes not completed by the customers, and as  a result, the system is unable to process the referral cashback. The reasons why this might occur are enumerated below:

  • The person who clicks on the referral link, doesn't register on the app or website right after clicking on the link but instead does so later.
    • For example, Alice shared a link with Bob. Bob clicks on the link on his Android device. Since Bob is not registered, the link opens up the app's listing on the Play Store. Bob decides that he'll install the app later and closes the Play store. He later opens up the Play Store and goes to the app listing and installs the app.
  • The target person who sees the link doesn't install the app by clicking on the link but instead visits the app store or website directly, and registers. 
  • The target person registers on the app/website by clicking on the link, but doesn't place any order.
  • The target person registers on the app/website by clicking on the link, places an order but the order is not Completed by the merchant.
  • The merchant is using only our apps and is using some other service for the website – now if the person clicking on the link registers on the website, the referral loop won't be closed. This can happen the other way round too, i.e., if the merchant is using our website but not the apps.

Was this article helpful?