@gamiphy/dashboard-core v2.0.71

Gamiphy Available SDKs

Introduction

Gamiphy is a user engagement and retention platform which offers clients the tools to engage, reach out and retain users, Gamiphy offers clients an all-inclusive gamification service with a variety of features including loyalty programs, branded games, quizzes and playable apps, basically anything to keep users engaged and coming back.

This document contains all the needed information to integrate the services that is provided by Gamiphy, focusing mainly on both Gamibot ( the loyalty program) and Gamistore ( the mini games).

Creating Gamiphy Account

details about the dashboard, how to signup, and link to documents.

Installation

Gamibot and Gamistore are available as a javascript library that you can install on your application and integrate with using the javascript package manager npm, or a static script injection in code.

Gamibot

Getting Started

Step 1: Gamibot Initialization

Gamibot.init(<botId>, <options>)

Kindly see more details about the options below.

Registering your users

You can register your users and communicate to Gamibot by calling the following method and passing the user data.

Gamibot.login({
	name: <name>, // Your user name. [Required]
	email: <email>, // You user email. [Required]
	avatar: <avatar>, // Your user avatar url. [Optional]
	hash: <hash> // Generated HMAC 
})

|

Logout users

When users want to log out of your app, simply call logout like so:

Gamibot.logout();

Gamibot still showing for anonymous

As Gamibot is accessible for anonymous users, you can specify where to redirect these users to do sign-up/login whenever they are trying to do a specific task, Gamibot will call the methods you specify here. isSignUp is a flag available for you so you can know where to redirect the users, to the signup form or the login form according to your needs.

Gamibot.init(<botId>, {
	onAuthTrigger((isSignUp) => {
		if(isSignUp) {
			//Add redirect to sign up code
			//e.x. window.location.href = '/sign-up' in web
		} else {
			//Add redirect to login code
			//e.x. window.location.href = '/login' in web
		}
	})
})

Showing the bot If you selected the option withWidget in the init method as false, that means you need to handle showing, and closing the bot by calling the following methods:

Open Gamibot

Gamibot.open() // will open Gamibot

Close Gamibot

Gamibot.close() // will close Gamibot

Tasks and events

As you will have a Gamiphy account where you can access the dashboard and design the user journey in addition to several configurations, you will need to complete the integration according to the selected configs in the dashboard, for example when you are going to add a task, you will be asked to fill in the action name and the event name.

Gamibot will fire an action whenever the user trying to do a specific task in the bot so you can handle the business logic in your application, the following method onTaskTrigger will be called, and you will be receiving the action name you specified in the dashboard as a parameter, you can perform your login the call back function shown below according to each action per task.

Gamibot.onTaskTrigger(<actionName>, () => {
	//Action name handler
	//e.x. Redirect to the page where you can do the task
})

In order to send back to the bot whenever the user did a specific task in your application, so Gamibot can consider that task as done, you will need to call the following method and pass the eventName as a parameter, eventName value is specified in the dashboard when you create your tasks.

Gamibot.taskDone(<eventName>)

Handling user's redeem

The following method will be called whenever the user is trying to redeem his points from Gamibot, Gamibot will trigger this method and pass the reward details as an object to the method, you can inject your logic within the handler according to the reward config you specified in the dashboard.

Gamibot.onRedeemTrigger((reward) => {
	// On redeem handler
})

kindly note the fields of the reward object you will get as a parameter as described above.

Whenever the user attempt to get the reward, and he actually did get the reward, you'll need to communicate that to Gamibot so that the user points will be updated. you can do so by calling the following method.

Gamibot.redeemDone(<rewardId>)