19,306

Views

Beginner

Level

7

Comments

Kongregate and Newgrounds

by Jon (Updated on 2014-03-20)


Stencyl has partnered up with Kongregate and Newgrounds to bring you direct integration of each of these popular networks’ APIs to bring Ads, Leaderboards and Achievements to your games.

Note: All of these blocks may be found under the Game > Flash section of the Palette.


Contents

  • Kongregate
  • Newgrounds
  • Other APIs (CPMStar)


Kongregate

Kongregate is a popular gamer-oriented Flash portal. It’s developer friendly and towards a more sophisticated hardcore audience than typical Flash portals.
 

Before you Start

The bulk of our support involves sending scores over to Kongregate's servers. To do this, you first need to set up high scores on Kongregate's end. This page tells you how to do this.
 

Setting Up

Before you use the Kongregate API, use this block to initialize it. It doesn’t matter where or when this happens. Sticking it inside the first scene is best practice.


Submitting Scores

Unlike other services, Kongregate displays its scores as part of its site rather than in-game.

To submit a score, use this block. Be sure to set up each field you wish to record on Kongregate’s site and adhere to its best practices.


Player Info

With these blocks, you can test whether the player’s registered, a guest and their user name, if they are registered.


Achievements

The best games on Kongregate have achievements. Unfortunately, the staff picks out which games get achievements. The minimum bar is a 3.5 rating (in practice, it’s now 4+), hitting the front page and reaching at least several hundred thousand plays.

 

Newgrounds

Newgrounds is a popular site for user-generated Flash content and games. They’re a great place to get a game sponsored.


Setup

Every Newgrounds game has 2 secret values that you must set, so that Newgrounds’ servers can communicate with your game. Set those values on the Advanced Settings page on the Dashboard.


Showing an Ad

Ads can be shown at any point during the game, whether at the start or between levels.


Leaderboards

Newgrounds supports scoreboards. In order to use them, you have to set the scoreboards up on their site before they can be tested.

Once they are, you can opt to show the scoreboard, passing in the board’s ID/name, which you defined on Newgrounds.

Similarly, using that same board ID/name and passing in a value, you can submit a score to Newgrounds servers.

 

Medals

Medals are Newgrounds term for achievements. Like scoreboards, medals must be set up on Newgrounds site.

Two blocks can be used to work with medals. The move block is a one-time use block that you call at the start of the game (or anytime before a medal shows) to place the medal’s popup at an appropriate place on screen.

To unlock a medal (in other words, unlock the achievement), just use the unlock medal block.


Other APIs (CPMStar)

Besides Newgrounds and Kongregate, we support CPMStar pre-game ads. These work much in the same way as other forms of web game ads in the sense that you just input your Developer key, and the ads will automatically show, just like that.

As you probably know, CPMStar is invite-only, so only those with access need worry about this.


Summary

  • Third party services let you increase your game’s engagement and provide simple ways to monetize.
  • Use services responsibly to complement a game.
  • Consider creating a mobile version of a game or receiving a sponsorship if you really want to monetize a game to its full extent.
Disclaimer: All articles are geared towards Stencyl 3.0 and above. Use comments to provide feedback and point out issues with the article (typo, wrong info, etc.). If you're seeking help for your game, please ask a question on the forums. Thanks!

7 Comments

jesusalva
I think that Kongreat will ask the MEDAL name, not username. if you logged on, it already know who are you.

the ID of kongreat is for greater progams, I only use it when I need fill a number camp.

0 8 months, 1 week ago
snowbrger
what do you do with the id of player in the kongregate coding?

0 1 year, 1 month ago
Rnd
submit score to Kongregate with name: value:
what is name ?? is it statistic name / player username ?

0 1 year, 2 months ago
pokedan1
When will other sites like flashgames.com or amourgames.com be
Released?

0 1 year, 3 months ago
AK80
Newgrounds game key and id are with small letters inside the page of your game you want upload.It took me 3 days to see it.
1 1 year, 7 months ago
srimasis
where can i find newgrounds game key and api id.
1 1 year, 8 months ago
rob1221
Since the Newgrounds site design change, leaderboards and medals no longer require admin approval.
0 1 year, 10 months ago

Sign In to Comment