Tasks, Rewards & API Integration
Information for marketers and developers on tasks, user engagement, and implementation of the GAMEE API
Last updated
Was this helpful?
Information for marketers and developers on tasks, user engagement, and implementation of the GAMEE API
Last updated
Was this helpful?
When advertising your product or project with GAMEE, you will work closely with GAMEE's Head of Partnerships to help achieve your KPI goals and smoothly onboard your company's project tasks into our Telegram application.
Advertisers can benefit from incorporating an almost limitless number of task types into the GAMEE application, which are designed to encourage user engagement with carefully selected rewards.
Click here to read more about partnering with GAMEE.
Tasks that you select will appear in the "Tasks to Do" list in the GAMEE app, and can be further promoted with accompanying copy and images in our community channels.
In this section of the app, users come to engage with tasks from GAMEE and our partners in order to discover interesting projects and to receive rewards for their engagement.
In addition, tasks may be further boosted by being sent directly to users in GAMEE's communication channels.
There are effectively no limit for tasks that you can choose; as long as the task completion is trackable and is in line with your KPI goals, it can be implemented. You may also opt to feature more than one task in the GAMEE application. Note that more challenging or time-consuming tasks for users are typically rewarded with more rewards in our app, to further encourage completion.
Typical tasks include (but are not limited to):
Join a partner community
Play a partner game
Achieve a specified outcome in a partner app (points, winning a series of games, etc.)
Create an account on a partner website or application
Deposit a specified amount in a partner website or application
Follow social media channels
Refer a specified number of other users
At GAMEE's end, rewards are sent when we receive confirmation via the API that the user has completed the required action or actions. The user receives an automated notification via the GAMEE bot that their reward is waiting, and they can then claim it.
Rewards we offer depend on what events and products are currently featured in the app, and will be selected by our development team to attain maximum engagement.
At different times throughout the year, certain in-app soft currencies are more beneficial to users and that is reflected in the rewards we offer. For instance, they may be:
Tickets – Tickets can be used in the GAMEE application to enter draws with monetary prize pools, boost mining rates, and attain other improvements and advantages to the user experience.
Blue Coins – Similar to Tickets, Blue Coins can be used to improve aspects of the user experience.
Spins – When a cash Wheel of Fortune is active, spins allow the users to spin the wheel with the chance of winning monetary rewards, alongside other soft currencies.
From the partner's side, any additional rewards you may opt to provide can be beneficial, but they are not a requirement. You may offer bonuses, whitelist access or other rewards when a user completes your task, in addition to the rewards that GAMEE provides.
In order to track completed user actions, you will need to integrate the GAMEE API and link it to your task action, which his how we track task completion and rewards. The link to this will be provided to you during the discussion phase.
The flow takes place over three stages:
1. The user is able to see the task in the application's task list. The task shows:
Small thumbnail image
Task title
Task description
Reward for completion
2. When a user clicks on the task, they are directed to an URL of your choosing. In the URL parameters, we pass the user's Telegram user ID. After that, it is down to the partner company to save this information and track user progress.
3. When a user completes the task, the partner will call our API, the task will be marked as completed, and then the reward will be delivered to the user.
You will be sent unique GAMEE API parameters during your discussions with GAMEE, and can then use the following guides to help you integrate the GAMEE API into your product:
Each task has 7 parameters:
Task ID
201
Every Telegram task has its own unique ID number
Icon
A brand logo
Name
Follow MrCrypto on X!
Call to action for the task
Description
Join the crypto revolution!
Additional details
URL with specified UserID
https://example.com/?uid={telegramUserId}
Telegram UserID will be replaced by actual UserID.
Authentication token
mrcrypto
The authentication token is partner-specific and must be passed in the request header
Reward
1000 Tickets
Reward user gets upon task completion
Example header with partner authentication token, task ID and user's Telegram UserID.
Authentication token: mrcrypto
Task ID: 201
Telegram UserID: 1234567
curl -X GET -k -H 'Auth: mrcrypto' -i 'https://GAMEE-API-HERE.com/taskApi.php?taskId=201&telegramUserId=1234567
Success response: {"status":"ok"}
Error response: 1 error: {code: int, message: string}
999
Invalid type parameters
999
Invalid Auth Header
-32001
Telegram Task not found
-32001
Telegram User not found
-32001
Invalid telegram user
999
Task completion failed
201
mrcrypto
{"status":"o k"}
curl -X GET -k -H 'Auth: mrcrypto' -i 'https://api.GAMEE-API-HERE.com/taskApi.php?taskId=201&telegramUserId=1234567'
201
mrcrypto
{"error": {"code":-32 001,"mess age":"Tele gram user not found"}}
curl -X GET -k -H 'Auth: mrcrypto' -i 'https://api.GAMEE-API-HERE.com/taskApi.php?taskId=201&telegramUserId=157'
Please fill in this contact form and we will respond as soon as possible.