Skip to main content

RapidoReach Non-SDK Integration Guide

Get Your API Key​

Sign-up for a new rapidoreach developer account and create a new iOS or Android app here and copy your App ID and API Key.

You’ll need to dynamically generate the Rewards Center link based on the RapidoReach UID. This ensures that every user gets the right credit for their activity. First generate the RapidoReach UID using a script on the server, and pass that to the website.

Open RapidoReach Directly​

  Open https://www.rapidoreach.com/ofw?userId={{Your_Rapidoreach_UserID}}

Android Example:

  startActivity(new Intent(Intent.ACTION_VIEW, Uri.parse("https://www.rapidoreach.com/ofw?userId=597a0ed87760ae04c29975ee-1sJ57hgit-838ab4b72d221a585af8b4be7a540234")));

iOS Swift Example:

  UIApplication.sharedApplication().openURL(NSURL(string:"https://www.rapidoreach.com/rofw?userId=597a0ed87760ae04c29975ee-1sJ57hgit-838ab4b72d221a585af8b4be7a540234")!)

iOS Objective-C Example:

   [[UIApplication sharedApplication] openURL:[NSURL URLWithString: @"https://www.rapidoreach.com/ofw/?userId=test123-1sJ57hgit-838ab4b72d221a585af8b4bff7a540231"]];

Where

InternalUserId = Unique User Id you maintain for each user visiting your website AppId = Unique App Id you can obtain you create app on Rapidoreach (You need to register on Rapidoreach and join as a Publisher) Hash = Checksum generated with a combination of Internal User Id, App Id and App Key. For details please refer documentation here

Once the user clicks the button, the reward center will open in their browser where they can complete surveys in exchange for your virtual currency. We automatically convert the amount of currency a user gets based on the conversion rate specified in your app.

RapidoReach UID​

Reward Callback​

To ensure safety and privacy, we notify you of all awards via a server side callback. In the developer dashboard for your App add the server callback that we should call to notify you when a user has completed an offer. Note that the user ID passed into the web link will be returned to you in the server side callback. More information about setting up and testing the callback can be found here.

The quantity value will automatically be converted to your virtual currency based on the exchange rate you specified in your app. Currency is always rounded in favor of the app user to improve happiness and engagement.