MMO / Virtual Goods Integration Overview
Integrating your virtual goods game into Kongregate is a straight forward process that can be done in a few days by an experienced engineer. There are some special permissions that have to be set for transaction-enabled games, so when you're ready please contact us at apps@kongregate.com to request a game review, get a contract signed, and get started with integration.
Connect to our Client API Object
In order to get access to some required basic user information for the server APIs, you'll need to connect to our local API through either ActionScript or Javascript. You can find out details about the specific language connections in our API Overview page. Throughout the rest of the documentation you will see references to methods for this Kongregate API object.
Integrate a Few Quick APIs
Integration with Kongregate requires implementing 3 of our APIs within your game:
Virtual Goods: You will be able to accept Kongregate’s currency, kreds, as payment within your game. Any non-kreds payment methods will need to be removed. We currently screen games to maintain a quality experience, so please email apps@kongregate.com to request permission to publish the game.
Authentication: Giving users a single-sign-on experience reduces registration friction, increasing the number of accounts in the game. We have a simple API that allows you to validate a logged-in Kongregate user via a server-side call and get them into your game entirely behind the scenes.
Statistics: This is a very simple API that allows you to submit progress and high scores of players in the game. In addition to on-site leaderboards, this will enable us to put achievements on your game and feature it heavily if it gets a high rating on the site.
Embed the Game on Kongregate
The game itself will be embedded in an iframe on one of our game pages. These iframes can get up to 1050 x 700, though we recommend staying at under 1000 x 650 to keep the game visible on smaller laptop screens. If you have not worked with iframes before, you’ll want to be careful to have a cross-domain cookies workaround in Safari, and to set your P3P headers for IE, or the game won’t work.
Our new iframe resize API can be used if you need to dynamically resize the iframe for varying heights during gameplay. If you are interested in using the resizing API, please contact us at apps@kongregate.com so we can enable it.
Comments