Rewards API
"Make it to level 3 after download and get 2 gamerholic coins"
This is a great way to drive downloads to your game or app.
Why pay $2.50 - $3 per download with other services?
Using gamerholic,
download + engagement = $0.50
This is also a great re-engagement tool
"You made it to level 3 last time, make it to level 6 this time and you'll get 2 more gamerholic coins"
NEW! Daily super bonus... 1st player DAILY to hit your milestone will get $5 - $50 in bitcoin. Daily super bonus could also be a gift card valued up to $100.
Faq's
How many coins can I give for reaching a milestone?
For now ghc(2) is hard coded as the milestone reward. You'll soon be able to set your own reward. For example, you could say, 1st gamer to reach level 5 gets ghc(30)
What happens when I run out of coins?
When you run out of coins, your game is removed from the live list. Load more coins to your account, then turn your rewards settings on to get re-listed.
Rewards API
Step 1: Authenticate your game
GET https://gamerholic.com/api/v1/api.php?key=YOUR_KEY&gameKEY=YOUR_GAMEKEY&action=authenticate
json response:
{
"status":0 //invalid login
"status":10 // invalid gameKey for this DevID
"status":20 //invalid token
"token":4o99ru4ur4u4rufjoijg
"superBonus":1 or 0 if the daily super bonus reward is not active
"superBonusAmount":20 in GHC
"superBonusDesc":"20 Gamerholic coins" or "$25 Bestby gift card"
"superBonusType"= 1 is bitcoin (GHC), 2 is gift card;
"prize"= ex: $25 bestbuy, if super bonus is a gift card;
"prizeImage"=>0 is no prize image, otherwise the url to the gift card prize will be shown;
"imageHeight"=>height of prize image
"imageWidth"=>width of prize image
}
you'll need this token for future calls to the API
Step 2: Reward user
GET https://gamerholic.com/api/v1/api.php?token=token&gameKEY=gameKEY&action=reward&name=GAMERHOLIC_USER_NAME
json response:
{
"status":0 //invalid user name
"status":1 //success
"status":2 //this user was credited for this promo before (set a new milestone for the user)
"status":3 //insufficient developer coins
"status":4 //invalid gameID
"status":5 //this gamer was credited coins in the past
"newDevBalance":0
"user": userID of the user
"superBonus":1 or 0 if the daily super bonus reward is no longer active
"superBonusAmount":20 in GHC
"wonSuperBonus":0 or 1 if the gamer won the daily super bonus
"wonSuperBonus":0 or 1 if the gamer won the daily super bonus
"overRideCode":1234 //if the gamer hit this milestone before, you are given an over ride code to reward the gamer for hitting a new milestone. For example, you can say, "you scored 50 points before, score 100 points this time and you'll get 2 more coins". If the gamer hits the new milestone, you'll need the over ride code to reward the gamer.
"overRideCount":3 //The over ride count tells you how many times the gamer won the new mile stones you set. An over ride count of 2 means, twice before you set a new milestone for the gamer to hit and they got it.
Use the over ride count to set the newest mile stone. For example if your milestones are 100 points apart,
an over ride count of 2 would mean the new milestone should be 300, an over ride count of 3, the new mean a new mile stone of 400. OverRideCount * points + points.
}
Step 3: Reward previous winner
GET https://gamerholic.com/api/v1/api.php?token=token&gameKEY=gameKEY&action=reward&name=GAMERHOLIC_USER_NAME
json response:
{
"status":0 //invalid user name
"status":1 //success
"status":2 //this user was credited for this promo before (set a new milestone for the user)
"status":3 //insufficient developer coins
"status":4 //invalid gameID
"status":5 //this gamer was credited coins in the past
"newDevBalance":0
"user": userID of the user
"superBonus":1 or 0 if the daily super bonus reward is no longer active
"superBonusAmount":20 in GHC
"wonSuperBonus":0 or 1 if the gamer won the daily super bonus
}
