[ProtoTools] Google Analytics Tracking

[nerdmor]

Have you ever wanted to know how many people are playing your game? Ever wanted to know what paths they take, what secrets they find, what choices they make? Then this plugin is for you!


 


ProtoTools_GoogleAnalytics allows you to send information from your game directly to Google Analytics, where you can study it to find ways to improve your game.


 


Download it Here


 


 


Features:

• Allows for tracking of screens and events
  
• Works both on deployed or web games
  
• Should work on every plataform (Tested on Windows and Web)
  
• Automatically tracks maps
  
• Allows for manual tracking of desired events
  

 


Installation:

1. As usual, download the plugin and put it in your project's plugin folder
   
2. Go to https://analytics.google.com and create a free Google Analytics account.
   
   When setting up your account, set the track as "mobile app"
   
3. Give your account name something that describes your company/group
   
4. Set up your game's name
   
5. /monthly_2016_01/analytics1.png.f11928eb35d215f23a6689ca989ca66f.png">
   Also set up your country and timezone
   
   
   
   
    
   

[*]/monthly_2016_01/analytics2.png.157258c02adac5472aaa0f97beeca5c5.png">
After accepting the terms and conditions, in the next screen, Google Analytics will give you a Tracking ID. Take note of it.






 

[*]/monthly_2016_01/analytics3.png.54ea7ad40632c5255c67108c6217dbb3.png">
In the plugin configuration, fill the parameter "trackingId" with the tracking ID provided by Google Analytics




 

[*]Done!


 




Configuration:


The only parameter that needs to be set is the TrackingId. However, the following ones can be used to customize your tracking:

• userPerSave: by default, the plugin tracks every installation or instance of the game as a different user. If you think, however, that every savefile should be treated as a different user, simply change this value to "1"
  
• trackTitle: by defult, the plugin will send a screen named "title" whenever a user gets to the title screen. If you do not want that to happen, change this value to "0"
  
• autoMapTrack: by default, the plugin will send every map name as a screen view when the map is opened. If you want to change that and send your screens manually, change this to "0"
  
• mapPrefix: whenever the plugin sends an automatic map view, it will prefix it with this string. eg: a map named "The village in" will be sent as "maps/the village inn"
  

 


Usage:


The plugin will track maps and the title as screens (see configuration). If you want to track specific things manually, you can use these commands:

• protoGA screen "[screen description]"
  
   
  
• This will send a screen view with [screen description] as a parameter. Quotes are mandatory. Supports the same Control Characters as normal messages in the game
  
• eg:
  
  protoGA screen "the village inn"
  
• protoGA screen "dungeon 1/secret room"
  
• protoGA screen "\N[1] house"
   
  

[*]protoGA event "[event category]" "[event action]" "[event label]" "[event value]" "[noninteraction]"

• 
   
  
• This will send an event with the parameters above. Please note that all parameters are mandatory and quotes are also mandatory. Supports the same Control Characters as normal messages in the game.
  
• "noninteraction" should only be sent as "true" when the event is being sent without the player doing anything
  
• eg:
  
  protoGA event "first dungeon" "open door" "secret door" "0" "false"
  
• protoGA event "second boss" "start fight" "-" "0" "false"
  
• protoGA event "main village" "Got gold" "\V[1]" "0" "false"
  
• protoGA event "stone" "stepped over" "-" "0" "true"
  

 


References:





For more information on how Google Analytics tracks data, please contact me here, or on Twitter @nerdmor or visit:


For generic information on Google Analytics:


https://analytics.google.com


https://www.google.com/intl/en/analytics/standard/


https://analyticsacademy.withgoogle.com/course02


https://developers.google.com/analytics/devguides/collection/protocol/v1/


For specific information on App Tracking:


https://developers.google.com/analytics/devguides/collection/analyticsjs/screens


 


 


Thanks:


Hime, for inspiring me to do out-of-the-box plugins that anyone could use


RPGMaker community, for being so supportive


Archeia, for making the references that I use all the time




 


 


License:


This plugin is free for commercial and non-commercial use. If you use this plugin, add a reference to me with "Analytics plugin by @nerdmor"

 

[NeoPGX]

When I visit the download link dropbox tells me the file cannot be found. Can you please reupload it?

 

[Kane Hart]

Yeah I never saw this. I would and could use this myself too please

 

[Arise]

The download link is no longer working, if anybody has this plugin please share it.

Thanks!

 

[Jonforum]

interesting tricks

 

[Not_Important]

The link is dead please upload it again!
I would love to have this in my game!

 

[mlogan]

@Not_Important Unfortunately the OP has not been on in almost 3 years, so that's not likely to happen.

 

[Not_Important]

I guessed as much, but just in case, I wanted to ask, maybe even if someone has it