[ProtoTools] Google Analytics Tracking

Discussion in 'JS Plugin Releases (RMMV)' started by nerdmor, Jan 19, 2016.

  1. nerdmor

    nerdmor Veteran Veteran

    Messages:
    40
    Likes Received:
    18
    First Language:
    Portuguese
    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
      analytics1.png



       

    [*]/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.
    analytics2.png





     

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



     

    [*]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"
     
    Last edited by a moderator: Jan 19, 2016
    #1
    Jonforum, Kane Hart, NeoPGX and 11 others like this.
  2. NeoPGX

    NeoPGX ~ King of Cuteness ~ Veteran

    Messages:
    774
    Likes Received:
    88
    Location:
    Shreveport, LA, United States
    First Language:
    English (US)
    Primarily Uses:
    N/A
    When I visit the download link dropbox tells me the file cannot be found. Can you please reupload it?
     
    #2
    Kane Hart likes this.
  3. Kane Hart

    Kane Hart Elmlor.com Veteran

    Messages:
    656
    Likes Received:
    166
    Location:
    Barrie, Ontario, Canada
    First Language:
    English
    Yeah I never saw this. I would and could use this myself too please :)
     
    #3
  4. Arise

    Arise Veteran Veteran

    Messages:
    131
    Likes Received:
    18
    The download link is no longer working, if anybody has this plugin please share it.

    Thanks!
     
    #4
  5. Jonforum

    Jonforum Veteran Veteran

    Messages:
    1,586
    Likes Received:
    1,366
    Location:
    Canada / Québec
    First Language:
    French
    Primarily Uses:
    RMMV
    interesting tricks
     
    #5

Share This Page