Skip to main content
Gameball Integration With Your Mobile App

Start engaging your players and add a game-like flavor to your mobile app.

Ahmed El Assy avatar
Written by Ahmed El Assy
Updated over a week ago

Before you start the integration, you need to have your API Key and Transaction Key through your Gameball account. Read about how can you get your account integration details? (API Key & Transaction Key

Step 1: Install Gameball player profile on your mobile app

It only takes a few minutes to install the Gameball player widget on your mobile app on your web app. Follow the below steps on our technical docs based on your app iOS, Android, and React Native:

  1. Installation

  2. Initialization

  3. Show Gameball Player Profile

Once installed, your players will be able to view their Gameball Player Profile on your mobile app. Gameball profile will be added as a popup/overlay as per the below and it can be accessed through any button:

Step 2: Configure your Firebase account details on Gameball

You must have a Firebase account and it should be configured on your Gameball Admin Dashboard account through Configure your Firebase account on Gameball

Configuring your Firebase account on Gameball will allow Gameball to:

A. Send in-app and push notifications/messages on your app to your players

Step 3: Send Players Events to Gameball

You can track actions your players (customer) take as Player Events, while logged into your platform only. Sending events will be through Send actions (events) API.

You can use these player events in the below:

Step 4: Configure Friends Referral Integration

If you are not going to use the referral program, skip this step.

Gameball can reward your players for referring their friends to join your platform. Read about Friends Referral Program

You should follow the integration steps based on your mobile app iOS, Android, and React Native.

Step 5: Reward your players based on the paid amount through Cashback Program

Through the cashback program, for every paid placed order on your mobile app using cash, credit card, Paypal.. etc, you can reward your players' Points based on a predefined equation. Follow the below steps to complete the integration:

  1. Configure the reward equation on Gameball Admin Dashboard. Read about how to Launch the cashback program

❗️Note: The program must be Active

2. On every successful paid placed order on your mobile app, use Cashback API to update Gameball

❗️❗️Important Note: It is recommended to send the cashback API call when the order status is completely paid. In case the payment method, for example, is COD (Cash on delivery), you should send the API call when the customer actually paid the order amount.

What is next?

Did this answer your question?