Rendezvous SDK

by Kofi Dadzie, October 25, 2015

Rancard’s Rendezvous platform extends a number of components that developers can use in enhancing user acquisition and engagement in apps and web portals.

The Rendezvous SDK can be embedded in a mobile app or web portal to enable the social graph to capture signals and to surface social recommendations to users.

The Rendezvous iOS SDK makes it easy to build social recommendations and discovery features experience into an iOS app. It provides various functionalities that helps to manage users, capture users’ preferences and activities, as well as serve recommendations within your app.

Getting Started

Create a Rancard (Merchant) Account
To access the Rendezvous iOS sdk, a Rancard account is required. Click here  to create an account.

Get your App Details

Once an account is set up, sign in here to get your developer app credentials(Client ID and App Secret).. This uniquely identifies each application or client developing against the Rendezvous product (i.e: using the Rendezvous SDK) and would be required by each implementation of the SDK.

Create a Store
Once you have an account and app credentials(App ID & App Secret), a virtual store should also be created to obtain a unique Store ID. This uniquely identifies a store that serves the purpose of hosting Merchant’s content items.
Store ID would be required for capturing user actions related to items .  create a virtual store here

Install and configure the SDK
The Rendezvous SDK has dependencies on the following frameworks which you’ll need to add to your project.
SWIFTY JSON framework (v4.0.0)
Alamofire Framework (v4.6.0)
CryptoSwift Framework (v0.8.3)
ObjectMapper Framework (v3.1.0)
Installing the Rendezvous SDK
Follow the steps below to install the SDK.

Download and extract the zip archive containing the Rendezvous SDK and its dependencies
Drop or add the Rendezvous framework file and all its dependency frameworks to your project

Steps for adding SDK to project
1. Add all the Frameworks in the directory you just unzipped to your project
2. Then in Xcode, select project and select a Target -> General -> Embedded Binaries and add all the Frameworks you just extracted
3. In the future, to update to the latest version of our SDK, just repeat steps 1-2.

Configuring the SDK
Add RENDEZVOUS_CLIENT_ID, RENDEZVOUS_STORE_ID, and optional RENDEZVOUS_ENVIRONMENT (production/sandbox) and their corresponding values to info.plist file .

Using the SDK

i) To initialize:
rendezvous = Rendezvous.initialise

ii) Call the various apis in the code as needed: Sample below:
rendezvous?.userSignUp(userName: “XX XX”, userID: “”, userType: “email”, password: “”, recommendationRequestId: “”, { error,JSON in

See sample call and  use scenarios below

Return to Rendezvous >>