Playtomic is a great way to understand how playertesters are playing your games during the development phases of your game and then to further study how your game is being played and spread around the world once you release it.  Beyond the real time analytics tools it also offers global leaderboards, heatmaps, custom game data, and level sharing APIs.

I can’t recommend Playtomic enough as it has really had a large and beneficial impact on the way I approach my game development, playtesting, and publishing. I’m not the only one enjoying Playtomic either–over 2,000 developers are currently using the service to track over 3,000 individual games, and logging an amazing billion combined real time events per day!

TUTORIAL

This tutorial will focus on the basics of getting your account setup with Playtomic and getting the basics of the analytics working in your game SWF.  I’ll be using the latest Playtomic API version 3.15 for ActionScript 3.0 (though Playtomic does support ActionScript 2.0 as well.) I’ll also be using the Flash IDE to create the game project but the code I’ll be demonstrating will work basically the same if you’re not using Flash. I’ll provide the source for the demo above saved as a Flash CS4 project in case you haven’t upgraded to the latest version yet.

 REGISTER FOR YOUR ACCOUNT AND CREATE YOUR FIRST GAME

Register:

First step is to simply register your account on Playtomic. This is pretty basic and you don’t even have to wait for an email for your account to activate.

Create First Game:

The next step is to create your first game in the system. I’m just using a ‘Test Game’ for the purposes of this tutorial.  The important part is to hit the two radio buttons. Select ‘Casual/mobile game’ for ‘Game Type’ and ‘Web’ under the ‘Flash’  platform area. Then just click the ‘Create Game’ button and the system will bring you to the game overview screen for API setup.

First Game API Overview:

You should now be looking at the API information for the game you just created. The most important information here is the game credentials area that lists your SWFID and GUID.  You should keep these numbers private since they are the way the API will communicate from your game to the Playtomic system.

The other important areas are the documentation and downloads areas. I’ve marked everything on the screenshot to the left that you can click to enlarge. You can get to this screen by clicking on ‘API Setup’ in the vertical nav menu at the left when you are logged in on the Playtomic website.

Download the Tutorial:

Normally you’ll click on the download link for the latest Playtomic API zip file on the Playtomic website. You’ll then extract the contents of the zip and find the folder called ‘Playtomic’ inside the folder called ‘gameapi-as3′.  You’ll want to copy the ‘Playtomic’ folder into the root folder of your game project so that the folder is at the same directory level as your FLA file.

This time though I’ve already included the latest Playtomic API within the tutorial download. At the time this tutorial was written that was version 3.15 for ActionScript 3.0.

You can download the tutorial here. I saved the FLA as a Flash CS4 FLA for people using older versions of Flash still.

Extract the tutorial zip and then open up both TestGame.fla and TestGame.as in the Flash IDE.

I’m only going to point out the most important parts from the source. The tutorial TestGame.as source file itself is heavily commented and should be fairly self-explanatory. This tutorial also assumes you know the basics of ActionScript 3.0.

In order for everything to work you are going to need to have already setup your new game on the Playtomic website from the instructions further above. If not go ahead and do that now because you’ll need your unique SWFID and GUID to plug into the TestGame.as config area.

// Playtomic API constants
// NOTE: CHANGE THESE TO MATCH YOURS OR IT WON'T WORK!
//
// SWFID from Playtomic API Setup screen
private static const PLAYTOMIC_SWFID:String = "xxxxxxxxxxxxxxxxx";

// GUID from Playtomic API Setup screen
private static const PLAYTOMIC_GUID:int = xxxx;

Before you can use the API you'll need to import the Playtomic classes. You'll see I do that near the top of the source file with the other standard Flash imports.

// import the Playtomic API
import Playtomic.*;

You need to init the Playtomic API as soon as possible in your game code and definitely before you call any of the Playtomic services. I usually do this with an init function of some type called during my FLA Document class constructor phase.

// Init the Playtomic API as soon as possible and
//   before you call any other Playtomic services!
private function init():void {
  // Initialize the API by logging the view
  //   this registers a 'view' on the server
  Log.View(PLAYTOMIC_GUID, PLAYTOMIC_SWFID, root.loaderInfo.loaderURL);
}

While we have now logged a 'view' above we want to track how many times the game will actually be played during that view session. In other words there should be more 'plays' of your game than 'views'. If not, the view to play ratio is a great indication that your game could use some improvement!

I typically track the 'play' event when my gameplay assets are being instantiated.

// Play the game
private function playGame():void {
  // Registers a 'play' event on the server. There can be multiple 'play' events per 'view'
  Log.Play();
  // do one time setup for game
  setupGame();
}

Another very easy and powerful thing to do with Playtomic is to track custom counter metrics. I have included an example in the tutorial. Whenever the player clicks on the 'Credits' button on the main menu we track a 'ViewedCredits' event. You can use these events to track all sorts of handy data. I usually track common things like every time the credits are viewed, the instructions are viewed, the sound or music is toggled on or off, how many times the game is restarted or paused. Basically any handy data point you'd like to gather to start understand how players interact with your game or the menus surrounding your game.

// Listens for mouse click on credits button
private function creditsButtonClickListener(event:MouseEvent):void {
  // Track a custom metric on the server so we know a
  // player viewed the credits screen
  Log.CustomMetric("ViewedCredits"); // metric, names must be alphanumeric

There are many other types of metrics you can track too. I like putting in tracking for average score so that even if players aren't submitting a score I can see how players are doing with the game. You can do this with a level average metric call. When your game doesn't have individual levels you can just feed in the string 'Game' (or whatever you want) that represents the entire game and not a specific level.

In the tutorial I track a level average metric when the player hits the 'Quit' button.

// Quit game button click listener
private function quitGameButtonClickListener(event:MouseEvent):void {
  // Track the current score as a level average metric event
  //   You can track averages for specific levels or the entire game.
  //   Here the string 'Game' represents the entire game not a
  //   particular level string.
  Log.LevelAverageMetric("Score", "Game", score);

That's about it! The Playtomic website documentation is pretty decent and the community forums on the site are starting to mature a bit so that you can often get help from a question posted up there before too long. Once you integrate Playtomic into your own game you'll start thinking up all kinds of great uses for it. I've used the global leaderboards and level sharing APIs and will start experimenting with the heatmaps soon. I will use this base tutorial code to write up a few followup tutorials on Playtomic soon.

Let me know if I can improve this tutorial and if you have any questions at all!

[DOWNLOAD FLASH CS4 VERSION OF TUTORIAL]

It has been almost 60 days since I released TurnStyle and as I’m gearing up again to do another big round of game development in the next few weeks I think this time is as good as any to get this off my plate.

I will share my MochiAd developer screenshots below:  I have created 3 reports all of which show the entire history of the game in the wild.  I will report my numbers on Traffic, Hosts, and Countries along with some of my own thoughts and markings on the screenshots:

(All images can be clicked on to view larger)

TurnStyle Traffic Data

The purple area on the image above represents the typical viral spike present in most games that are released on the internet.  I have looked at a ton of these graphs of released flash games and their signature is almost identical.  Yes there are bumps and spikes along the way depending on various sites or occurrences that may happen to your game but the underlying spike and then long tail down is the same.  The main difference between games is that the higher your spike is in the beginning then the higher the hits per day will run you during the long tail down.  TurnStyle has tapered off to generating around 100-200 plays a day now.  The highest spike I had was around 8500 or so and earned my around $3 in a single day. Woot!

The green area on the image above represents when I got approved for the excellent service called Flash Game Distribution by the same guys who run the Flash Game License site.  I was allowed access into the beta version of the service, submitted my game and enabled my options and got a nice spike in my traffic.  I can’t recommend them enough for how easy they make it to get a decent boost.  I imagine it paying off quite well on a more successful game.  In less than 15 minutes of your time you can have your game emailed to over 451 publishers, enabled for portals who subscribe to their game feed API, and use their manual submit accelerator to walk through 100s of the most popular portals which don’t have an auto-submit.  All your games data is featured on the left pane of a frame and you can paste it right into all the portals submit forms.  Cake!

TurnStyle Host Distribution Data

Here you see the hosts view from my MochiAds developer Stats page.  Once again I am viewing all date data for TurnStyle.  Early on my game got picked up by arcade.fi and got a ton of plays.  This was great for the players in Finland but not so great for my revenue.  You get paid various amounts depending on where you game is being played.  Every country and domain have different eCPMs that they pay.  This is due to all the various ad inventories or deals that have been struck between Mochi and the ad buyers.  If your game is played in certain countries you won’t get any revenue at all sometimes since there are no ad campaigns running there.

You can also see here that bored.com really gave me some great revenue as a single site.  As I mention in my image above, the MochiAds domain is listed as the top one because this is an artifact of the Mochi Distribution system.  Most publishers subscribing to their feed are going to be using the Mochi embed to save on hosting fees.

TurnStyle Country Distribution Data

Just for fun I thought I’d also include the country data for TurnStyle.  You can see the top 2 countries which aren’t that surprisingly are United States and United Kingdom but then something funny is that Finland is the 3rd highest.  Well I have no idea but they really enjoyed my game.  I was even using the Google translation tool to read the comments users were leaving in Finish and that was quite fun.

It has been a great learning experience self-publishing TurnStyle.  I couldn’t be happier for what knowledge I’ve gained about the Flash business space.  It has also shown me why working out better deals and new models with publishers will be crucial to running a successful Flash game studio.  I’m coming to see what I had read others talking about that MochiAds (and other ad networks for that matter) should be considered more as secondary or tertiary income or even a viable tool for getting some leverage in your dealings with sponsors and licensees of your game.  You should be aware that if they are asking you to remove your ads you should consider this in the cost of your sponsorship/license deal.

I am trying out Flash Game License for my new game Orange You Glad and it is going great so far.  I’ve had sponsor interest and am receiving bids so I’m quite thrilled with my progress on my second Flash game.  I will be posting more on my experiences in that department down the road I am sure!

This is not only my first Flash game but also the first thing I have ever really released onto the internet as well so it has been a real interesting learning experience!

If you don’t care about tech mumbo jumbo if you skip down near the bottom you can see some funny stats from which countries are playing this game and my personal thoughts on my experience so far.

Distribution and Ad channel technology I used – MochiAds:

I decided to go with MochiAds to do my game distribution. It is non-exclusive and free so I am also able to make other deals as well. One of the main benefits they offer is that they “wrap” your Flash game in a preloader that contains customizable and controllable ads from their network. So, the further your game spreads on the internet the better for them and you. You get a percentage of the revenue from the “impressions” that the ads receive as people wait for your game to download. I like that people have the ability to skip the ad by clicking the ‘x’ because let’s face it- ads are annoying. I also then think that let’s face it, I have to eat too.

Another great free benefit that MochiAds provides you is that the preloader that wraps your Flash game is encrypted as well as version controlled. This means that I can update my Flash game with bug fixes, new links, new ads or whatever I want in ONE location and that anyone playing the file (even if they have downloaded or are linking to a SWF somewhere on a portal) will receive a “diff” of the changes in the version. All seamlessly while it downloads. This is really incredible in my opinion. It has been a joy to work with and I have made quite a few tweaks and changes to my game already and it is nice to see them being picked up by all the portals which have received a copy of my game. The encryption is a nice benefit too I would guess though I don’t know much about Flash obfuscation yet I just hear it slows down someone decompiling your code a little bit.

Along with the distribution channels your game is automatically placed in you receive a full stat report at your MochiAd dashboard page. This is where you setup all the keywords, game thumbnail, description, instructions etc. that are distributed when a partner of MochiAds receives your game. I have watched my game spreading to over 40 sites now all without me having to do any further work. They do this because they benefit as well as the developer the further the game gets. They also have a more detailed stat service through MochiBot which I also signed up for which provides further detail on people who saw more than the ad. In other words, people who actually played your game.

The stats are a blast to watch! Especially for someone who is a complete stat and number junkie like myself.

Other portals I have released my game on:

Kongregate:

Kongregate was the first portal I uploaded my game on myself. The submit process was very easy and only involved a few steps. You must have a Kongregate user account obviously but besides that it is really straightforward to get your game up there. You fill out the form with info on your game, upload a thumbnail, check any of the API options you may be using, and also let them know whether your game is “exclusive” to the Kongregate site or not. Options like this one, along with the stats API question control how much your percentage of the ad revenue will be.

Since Kongregate has a deal with MochiAds already they will suppress the display of your ads in your MochiAds preloader. The preloader download bar still works fine but no ads will display. They do this for many reasons and it seems to make fair sense.

Anyway, back to the percentage points: You get 25% of the ad revenue that your game receives just for uploading it to the site. If you also integrate either (or both) of their APIs (HighScore and Statistics) you receive an additional 10% for this bringing your total possible to 35%. Now, if you make your game exclusive to Kongregate you can receive a another 15% bonus bring the grand total to 50%. A nice thing about the exclusive is that they do let you turn that off if you ever feel like putting your game elsewhere and you will revert back to the 25% or 35% share depending on your other options.

Once your game is uploaded and published it will show up on their new games list. At this point it is up to the portal users to rate and view your game past a ‘under judgement’ period. The judgement period is a timeframe where you can’t view the rating of the game yet when you go to rate. I guess the idea is that this helps early reviewers judge with less bias. In actuality most early commenters during this phase like to post their ratings in the comment feed below the game. Once your game has received 75 ratings the rating number is revealed to all. If your game does well enough it will move through the rankings accordingly. TurnStyle seemed to fair pretty well for a first attempt. TurnStyle’s rating seems to fluctuate around 3.25/5 stars over there. It is ranked around 240/3200 in the puzzle game category currently on their site too. I guess that isn’t too shabby at all with everything considered. As of this post date my game was played over 3500 times, rated over 450 times, favorited 17 times, and earned me 1 fan.

Newgrounds:

This is the only other portal I have submitted to so far. Similar to Kongregate it followed a manual form submission process. Once your game is up on the site it also undergoes a judgement mode where people have to vote and review it for it to acheive it’s placement ranking. The system is similar enough to Kongregate’s that I won’t go into great detail here. They also offer an API but I haven’t looked into that yet. I am allowed to have my MochiAds viewed up there and they seem to get me a pretty good eCPM rate so far based on my MochiAd stats so that is good.

It seems TurnStyle faired a good deal better on Newgrounds than on Kongregate. My game got 7 reviews: 6 perfect “10s” and 1 “9″ for a review rating of 9.9. The voting system seems to indicate that my game has a vote rating of around 3.5/5 stars with 298 votes received and over 1200 plays.

The cool news was the first day I submitted it my game did well enough to get voted 6th Most Hottest Game for Monday! That was pretty exciting. I missed the coveted 1-5 spots that would have gotten my game even higher in views. It was still on the front page though just didn’t have the icon next to it. Oh well, pretty good for first Flash game I guess.

Traffic Stats and Ad Revenue so far:

So, I wanted to provide all the above data for context to what I will now share so that other developers can see how these stats relate to what distribution technology I used and where I have manually uploaded it. I will detail the rough number of hosts my game has reached (remember only two of which I submitted to myself) along with traffic numbers, impressions received, and revenue received so far. I do this because I have found it really helpful seeing the other Flash developers who have been transparent about this business space so that all may learn to be better.

TurnStyle Stats: 3 Days in the wild

Dates: Feb 28, 2009 – Mar 02, 2009
Ad requests
Total: ~15000
Impressions: ~10000
Skips: ~5000
Revenue: $2.40
# of Hosts: 42
# of Countries: 101

% of Plays by Top 5 Countries:
39% from Finland (this is crazy.. also almost half the leaderboard scores are from Finland too.)
20% from USA
7% from UK
4% from Canada
4% from Germany

I have also made about $3 dollars from my 3500 plays at Kongregate through their system.

So, while this game hasn’t been a financial success yet at a whopping $6 of ad revenue so far the education that I have received and continue to receive is fairly priceless. Also, ad revenue is more of a long tail approach as my game (and future games) spread through the internet. I try to visualize a day where I may have 10-20 games roaming about each bringing me a couple bucks a day potentially. Well, that ads up when these little critters can “work” 24/7. Heck, who couldn’t use an extra 10x $1 a day.. that’s almost $4k a year when you think about it. So, while $6 earned so far on 200 hours of work at least might initially discourage some- I believe that is a short-sighted reaction. There is also the idea that while most of your games will end up relatively “unplayed” in the scheme of things- you only need 1 or 2 to really “blow up”. I think the more quality games you can release over time the better.

In order to work on a different angle to monetizing the Flash business space there is also the world of licenses and sponsorship to consider. I have signed up for an account over at FlashGameLicense which lets you sell licenses to released games and find sponsorships of various types for unreleased games that portals buy. It allows bidding and reviewing and other matchmaking services to allow Flash developers to get a fair price for good work. I am excited about the potential that FGL offers to do this kind of work fulltime. I will be posting more experiences regarding those adventures in later posts!

Aside from all the business aspects and traffic aspects I’ll share a few personal joys from this experience:

The thought tickles me so that potentially 15,000 people have seen my illustrations and played my game. I can’t believe I didn’t do something like this earlier in my life because it is so much darn fun! There is something so tantalizingly weird about hitting refresh on your browser while watching your MochiAd stat page and seeing that every 5 seconds 20 more people have tried your game. It blows my simple mind.

I would also like to thank all my close friends and friends of friends that have played this game and offered their feedback. In the anonymous world of the internet it is still the opinions of those I am close to that I most value hearing. I can’t wait to make more games!