Before you start the integration, you need to have your API Key and Transaction Key through your Gameball account. Read about how you can get your account integration details. (API Key & Transaction Key
Step 1: Install the Gameball customer profile on your mobile app
It only takes a few minutes to install the Gameball customer widget on your mobile app or your web app. Follow the steps below on our technical docs based on your app, iOS, Android, and React Native:
Installation
Initialization
Show Gameball customer Profile
Once installed, your customers will be able to view their Gameball Customer Profile on your mobile app. The 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 customers
B. Generate Gameball referral dynamic links and complete the referral experience on mobile (In case you will use the Referral Program)
Step 3: Send Customer Events to Gameball
You can track actions your customers take as Customer Events, while logged into your platform only. Sending events will be through the Send actions (events) API.
You can use these customer events in the below:
Create action-based campaigns and rewards. Read about the events creation engine
Create referral campaigns and rewards. Read about the referral program
Send customer messages based on events. Read about how to create and configure your customer messages
Step 4: Configure Referral Integration
If you are not going to use the referral program, skip this step.
Gameball can reward your customers for referring their friends to join your platform. Read about the Referral Program
You should follow the integration steps based on your mobile app, iOS, Android, and React Native.
Step 5: Reward your customers based on the paid amount through the 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 customers' Points based on a predefined equation. Follow the steps below to complete the integration:
Configure the reward equation on the Gameball Admin Dashboard. Read about the Points earn and redeem settings
❗️Note: The program must be Active
2. On every successful paid placed order on your mobile app, use the 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 pays the order amount.