Skip to content

Testing Your Referral Programs

Jump to bottom Edit New page
Laxman Papineni edited this page Mar 22, 2016 · 22 revisions

Pre-requisites

Please make sure, your campaign is in "LIVE" mode (AppVirality dashboard -> Select App -> Campaigns)

1)In STEP 4 of github, along with "appvirality.appkey", do add "appvirality.debug = true"

Alt text

  1. Two devices (Device-A and Device-B) with your APP / APK installed (with AppVirality SDK integrated)

Going forward, Device-A acts as Referrer and Device-B acts as Friend.

Referrer = Device-A

Friend = Device-B

  1. Have your APP / APK ready on both the devices (Tip - Send it via an e-mail to both the devices, as you will have to install and uninstall frequently during the testing cycle)
NOTE for Developers: Once you’re done with testing, in release build, don't forget to remove "appvirality.debug = true" from appvirality.properties file in "assets" folder.

Step by Step Guide

You can add test devices either through API or Dashboard.

Listing Test Devices via API

Listing Test Devices via Dashboard

  1. Go to AppVirality dashboard → Test Devices

![Alt text](https://github.com/appvirality/appvirality-sdk-android/blob/master/images/Test Devices_with_border.jpg?raw=true "AppVirality Dashboard left sidebar")

  1. Click on “Add Test Device” button to start the listening mode

![Alt text](https://github.com/appvirality/appvirality-sdk-android/blob/master/images/Add Test Device_with_border.jpg?raw=true "AppVirality Dashboard Test Device Section")

  1. Open the App in ‘Device-A’, and Shake it 3 times to start the SDK in debug mode.

Once the debug mode starts, you will see a toast message saying "Your device started in debug mode".

![Alt text](https://github.com/appvirality/appvirality-sdk-android/blob/master/images/Device bebug mode starts_with_border.png?raw=true "toast message confirming device debug mode")

On dashboard “Test Devices” section, you can see your test device listed with its Android ID, after completion of listening mode (i.e 30 seconds).

To avoid confusion, don’t forget to name your device. In this case we are naming it as “Referrer - Device (A)”.

  1. Repeat step-6 with ‘Device-B’. Now you can see both the devices listed on the dashboard.

![Alt text](https://github.com/appvirality/appvirality-sdk-android/blob/master/images/both the devices_with_border.png.jpg?raw=true "AppVirality Dashboard Test Devices Section")

This completes the registration process for your test devices. You can “Reset” them at any point from AppVirality dashboard itself to use them as new devices i.e Friend-2, Friend-3, etc.

Click “Delete Icon” against device to completely release a device from test mode.

Let’s Start Real Testing

  1. Once you’ve test devices ready, uninstall your APP from Device-B (i.e. Friend, as you’ve to “Reset” the device and re-install after clicking on referrers referral link).

  2. Go to AppVirality dashboard → Test Devices, and Reset the Device-B (i.e. click “Reset” button against Device-B).

  3. Go to AppVirality dashboard → Campaigns → Create Campaign to set your reward rules.

  4. Open your APP on Device-A (i.e. Referrer), launch referral program and invite Device-B (i.e Friend) via email/social media channels.

  5. Click on invitation link from Device-B and install your APK directly (Not from playstore, refer step 3).

  6. Once installed, launch the APP. You should be able to see the welcome screen (If you’ve configured it while integrating with AppVirality SDK).

Tip: If you're clicking on same referral link for more than once, please make sure to clear mobile browser cache after each cycle.

Tip: If more than 2 devices are participating in the test cycle, please make sure that you have nothing (i.e email ids, twitter ids, etc) in common on those devices.

![Alt text](https://github.com/appvirality/appvirality-sdk-android/blob/master/images/Welcome Screen_with_border.jpg?raw=true "Welcome screen on friend mobile")

  1. Login to your AppVirality dashboard → Analytics section to view metrics like Invites, Clicks, Installs, and Revenues (In case of transaction based reward rules).

Alt text

  1. Go to “Influencers” tab to view all the users participating in the referral program and individual analytics of each user.

Alt text

  1. Go to “Referrer Rewards” and “Friend Rewards” tabs to view history of Referrers/Friends in particular.

![Alt text](https://github.com/appvirality/appvirality-sdk-android/blob/master/images/Referrer and Friend_with_border.jpg?raw=true "AppVirality Dashboard Analytics Referrer Rewards tab")

This completes one basic cycle of testing. You might want to repeat the tests with different reward rules or conditions like “Max Reward Cap”, “Review Period”, “User Targeting”, etc.

If you’ve any queries, feel free to email me at lax [at] appvirality.com.

Help on other topics:

Please have a look at our Wiki page

  1. Getting Started With AppVirality Android SDK Integration
  2. AppVirality API for referral Growth Hack
  3. How to Add Test Devices & Test Referral Program
  4. Using Custom Domain
  5. Init Callback | hasReferrer | getUserKey
  6. Using Referral Code & Referral Link
  7. [Optional] Exclude Premium Users
  8. [Optional] Dynamic Share Message
  9. [Optional] Remind Later Settings
  10. [Optional] To Whom and When to Show Growth Hack
  11. [Optional] Reward Notifications or Web-hook Configuration
  12. [Optional] Android Push Notification Configuration
  13. [Optional] Personalized Welcome Screen
  14. Referral Program on Apps having Login and Logout

@ 2014-2015 Appvirality.com

Growth Hacks

Clone this wiki locally