Comment on page
Webhook
The studio provides branded mini-games (HTML5 games) and stores game results (scores, playtime) in the system database.
However, some brands want to retrieve game results and store them in the brand's database.
This guide explains how brands can obtain game results from the studio.
- 1.The game player is connected to the customer (brand)'s system (website or app, etc.).
- 2.The brand's system recognizes the player and assigns a unique ID ('userid') to the player.
- 3.The brand's system loads the branded mini-game by calling the system's URL with the 'userid'.
- 4.The player plays the branded mini-game.
- 5.When the player completes the play, our (studio) system sends the game results to the brand's system using the Webhook URL.
- 1.The customer needs to create a campaign on our system's Studio website.
- 2.The brand needs to create a program (webhook) on their server to obtain game results.
- 3.The brand needs to update the webhook URL in the "Return Game Result" section of the campaign settings.
- In the basic scenario step 3, the brand's system needs to call our (studio) system's URL with the 'userid'.
- The 'userid' value must be passed using the GET method.
Name | Description | Format | Sample |
|---|---|---|---|
userid * | Unique ID generated from the customer's system | Alphanumeric (case-sensitive) + up to 20 digits | T4g4fLTaorjames |
Example,
Original campaign URL address
https://branded.mini-games.io/?php=landing@8NKHT2hK&campaign_no=1
The brand's system must call this URL and send the "userid".
https://branded.mini-games.io/?php=landing@8NKHT2hK&campaign_no=1&userid=T4g4fLTa
- In step 5 of the basic scenario, the brand needs to create a program (webhook) on their server.
- This webhook must have a URL that can be accessed from the system server.
- Our (studio) system sends game results using the POST method with the following parameters.
If the branded mini-game is not an 'instant win' type.
Name | Description | Sample |
|---|---|---|
userid * | User's unique ID | T4g4fLTa or james |
tx_id * | Unique ID for each game played | 234234 |
time * | Datetime when the game player attempted to play | 2023-04-10 06:39:23 |
score * | Score obtained by the game player | 3500 |
playtime* | Duration of play by the game player (in seconds) | 20 |
* Indicates a required value.
If the branded mini-game is an 'instant win' type.
Name | Description | Sample |
|---|---|---|
userid * | User's unique ID | T4g4fLTa or james |
tx_id * | Unique ID for each game played | 234234 |
time * | Datetime when the game player attempted to play | 2023-04-10 06:39:23 |
reward_image * | Reward image | https://branded.mini-games.io/upload/reward/f1GByiOHZZ9biLGd32jp.png |
reward_item * | Return code (Return Code) | Coffee |
* Indicates a required value.
The brand server must return the result code to our studio system.
Code value | Description |
|---|---|
S | When successful |
F | When failing
If you want to state the reason for failure, you can add text after the "F" code.
Example) "F: Score is missing." |
// getting data
isset($_POST[‘userid’]) ? $userid = $_POST[‘userid’] : $userid = ”;
isset($_POST[‘tx_id’]) ? $tx_id = $_POST[‘tx_id’] : $tx_id = ”;
isset($_POST[‘score’]) ? $score = $_POST[‘score’] : $score = ”;
isset($_POST[‘playtime’]) ? $playtime = $_POST[‘playtime’] : $playtime = ”;
isset($_POST[‘time’]) ? $time = $_POST[‘time’] : $time = ”;
// checking validity
if (trim($score) == “”) {
echo “F : score is missed”;
exit;
}
if (trim($playtime) == “”) {
echo “F : playtime is missed”;
exit;
}
if (trim($time) == “”) {
echo “F : time is missed”;
exit;
}
// saving data into database
$sql = “insert into playing_log (‘tx_id’, ‘userid’, ‘time’, ‘score’, ‘playtime’) values (‘”.$tx_id.”‘, ‘”.$userid.”‘, ‘”.$time.”‘, ‘”.$score.”‘, ‘”.$playtime.”‘);”;
//echo $sql;
// connection DB
// insert data
~~~
// result of saving
if ($result) {
echo “S”;
}
else {
echo “F : DB failure”;
}
To obtain parameter values when the returned data is in JSON format, you must first parse the data.
Last modified 6mo ago