<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<body link="#355491" alink="#4262a1" vlink="#355491" style="background: #e2e2e2; margin: 0; padding: 20px;">
<div>
<table cellpadding="0" bgcolor="#FFFFFF" border="0" cellspacing="0" style="border: 1px solid #dadada; margin-bottom: 30px; width: 100%; -moz-border-radius: 6px; -webkit-border-radius: 6px;">
<tbody>
<tr>
<td>
<table border="0" cellpadding="0" cellspacing="0" bgcolor="#FFFFFF" style="border: solid 2px #ccc; background: #dadada; width: 100%; -moz-border-radius: 6px; -webkit-border-radius: 6px;">
<tbody>
<tr>
<td bgcolor="#000000" valign="middle" height="58px" style="border-bottom: 1px solid #ccc; padding: 20px; -moz-border-radius-topleft: 3px; -moz-border-radius-topright: 3px; -webkit-border-top-right-radius: 5px; -webkit-border-top-left-radius: 5px;">
<h1 style="color: #333333; font: bold 22px Arial, Helvetica, sans-serif; margin: 0; display: block !important;">
<!-- To have a header image/logo replace the name below with your img tag -->
<!-- Email clients will render the images when the message is read so any image -->
<!-- must be made available on a public server, so that all recipients can load the image. -->
<a href="http://community.jboss.org/index.jspa" style="text-decoration: none; color: #E1E1E1">JBoss Community</a></h1>
</td>
</tr>
<tr>
<td bgcolor="#FFFFFF" style="font: normal 12px Arial, Helvetica, sans-serif; color:#333333; padding: 20px; -moz-border-radius-bottomleft: 4px; -moz-border-radius-bottomright: 4px; -webkit-border-bottom-right-radius: 5px; -webkit-border-bottom-left-radius: 5px;"><h3 style="margin: 10px 0 5px; font-size: 17px; font-weight: normal;">
What can we track with JBoss Tools usage reporting?
</h3>
<span style="margin-bottom: 10px;">
modified by <a href="http://community.jboss.org/people/adietish">Andre Dietisheim</a> in <i>JBoss Tools</i> - <a href="http://community.jboss.org/docs/DOC-15798">View the full document</a>
</span>
<hr style="margin: 20px 0; border: none; background-color: #dadada; height: 1px;">
<div class="jive-rendered-content"><h1>Preface</h1><p>We maintain a Google Analytics account to track JBoss Tools usage. Google Analytics is designed to track web page usage but it might be adapted to track other applications. That's what we did for JBoss Tools and implemented an Eclipse plugin that shall help us to gather userfull informations about our users in an anonymous manner.</p><h1>How do we track users?</h1><p>When a JBoss Tools user starts its eclipse he triggers a hit to <strong><a class="jive-link-external-small" href="http:///tools/usage/action/wsstartup"><strong><strong>/tools/usage/action/wsstartup</strong></strong></a> </strong>in our Google Analytics Account<strong>. </strong>There are other urls that are tracked (for instance /pureTest)<strong>, </strong>but these are not triggered by JBoss Tools users<strong> </strong>and they're not relevant to our use case though<strong>. </strong></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p style="text-align: center;"><a href="http://community.jboss.org/servlet/JiveServlet/showImage/102-15798-13-6353/Picture+2.png"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/102-15798-13-6353/441-116/Picture+2.png </span></a></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><table border="1" cellpadding="3" cellspacing="0" class="jiveBorder" style="width: 100%; border: 1px solid #999999; background-color: #eaeaea;"><tbody><tr><th align="center" style="background-color:#6690BC;; border: 1px solid #999999;background-color:#6690BC" valign="middle">Url</th><th align="center" style="background-color:#6690BC;; border: 1px solid #999999;background-color:#6690BC" valign="middle"><span style="color: #ffffff;"><strong>Event</strong></span></th></tr><tr><td style=" border: 1px solid #999999;"><strong> <a class="jive-link-external-small" href="http://tools/usage/action/wsstartup"><strong><strong> /tools/usage/action/wsstartup</strong></strong></a></strong></td><td style=" border: 1px solid #999999;">A JBoss Tools user starts its Eclipse</td></tr><tr><td style=" border: 1px solid #999999;"><a class="jive-link-external-small" href="http:///pureTest"><strong>/pureTest</strong></a></td><td style=" border: 1px solid #999999;">Test plugin JUnit tests are run</td></tr><tr><td style=" border: 1px solid #999999;"><div class="text_wrapper" title="/tools/usage.html"><div class="text_wrapper"><a class="jive-link-external-small" href="https://www.google.com/analytics/reporting/content?id=35061163&pdr=20100808-20100907&cmp=average&trows=10&gdfmt=nth_day#lts=1283955501535"> <strong>/tools/usage.html </strong></a></div></div></td><td style=" border: 1px solid #999999;">Users browse our usage page on jboss.org <a class="jive-link-external-small" href="http://jboss.org/tools/usage.html">http://jboss.org/tools/usage.html</a></td></tr></tbody></table><h1><strong>What are the user values we track?</strong></h1><p>Google Analytics is designed to track browsers and users browsing web sites. Our Eclipse plugin emulates a browser and reports values the way a browser would. Of course using JBoss Tools in Eclipse does not match the use case of browsing web pages at 100%. It's very close to it though. There are values that are unique to our use case (to track application usage) and are not present in browsers. We map those to values to settings Google Analytics tracks for browsers and misuse their original intent.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><table border="1" cellpadding="3" cellspacing="0" class="jiveBorder" style="width: 100%; border: 1px solid #999999; background-color: #eaeaea;"><tbody><tr><th align="center" style="background-color:#6690BC;; border: 1px solid #999999;background-color:#6690BC" valign="middle"><span style="color: #ffffff;"><strong>Google Analytics Field</strong></span></th><th align="center" style="background-color:#6690BC;; border: 1px solid #999999;background-color:#6690BC" valign="middle">Information we report</th><th align="center" style="background-color:#6690BC;; border: 1px solid #999999;background-color:#6690BC" valign="middle"><span style="color: #ffffff;"><strong>Values</strong></span></th><th align="center" style="background-color:#6690BC;; border: 1px solid #999999;background-color:#6690BC" valign="middle">Example</th></tr><tr><td style=" border: 1px solid #999999;"><p><strong>Content/</strong></p><p><strong>Landing Page</strong></p></td><td style=" border: 1px solid #999999;">What <strong>JBoss Tools version</strong> is reporting?</td><td style=" border: 1px solid #999999;"><ul><li><span>1.0.0.v20100916-0700-H62-Beta1 </span></li><li><span>1.0.0.v20100918-0552-H72-Beta1 </span></li><li><span>etc.<br/></span></li></ul></td><td style=" border: 1px solid #999999;"><a href="http://community.jboss.org/servlet/JiveServlet/showImage/102-15798-13-9465/reports-jboss-tools-version.png"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/102-15798-13-9465/306-79/reports-jboss-tools-version.png </span></a></td></tr><tr><td align="left" style=" border: 1px solid #999999;" valign="top"><strong>Keyword</strong></td><td align="left" style=" border: 1px solid #999999;" valign="top">What are the <strong>JBoss Tools components</strong> that are installed?</td><td align="left" style=" border: 1px solid #999999;" valign="top"><ul><li>archives</li><li>as</li><li>birt</li><li>bpel</li><li>cdi</li><li>deltacloud</li><li>drools</li><li>esb</li><li>flow</li><li>freemarker</li><li>gwt</li><li>hibernatetools</li><li>jbpm</li><li>jmx</li><li>jsf</li><li>jst</li><li>labs</li><li>maven</li><li>modeshape</li><li>portlet</li><li>profiler</li><li>runtime</li><li>seam</li><li>smooks</li><li>struts</li><li>tptp</li><li>vpe</li><li>workingset</li><li>ws</li><li>xulrunner</li></ul><ul></ul></td><td align="left" style=" border: 1px solid #999999;" valign="top"><p><a href="http://community.jboss.org/servlet/JiveServlet/showImage/6331/keyword.png"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/6331/keyword.png </span></a></p></td></tr><tr><td style=" border: 1px solid #999999;"><strong>Visitor Type</strong></td><td style=" border: 1px solid #999999;">Is it a <strong>new or a returning</strong> User?</td><td style=" border: 1px solid #999999;"><ul><li>New Visitor</li><li>Returning Visitor</li></ul></td><td style=" border: 1px solid #999999;"><a href="http://community.jboss.org/servlet/JiveServlet/showImage/6332/visitor-type.png"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/6332/visitor-type.png </span></a></td></tr><tr><td style=" border: 1px solid #999999;"><strong>Language</strong></td><td style=" border: 1px solid #999999;">What <strong>Locale</strong> is Eclipse (Java Locale) set to?</td><td style=" border: 1px solid #999999;"><ul><li>en-US</li><li>de-DE</li><li>fr-FR</li><li>etc.</li></ul></td><td style=" border: 1px solid #999999;"><a href="http://community.jboss.org/servlet/JiveServlet/showImage/6333/language.png"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/6333/language.png </span></a></td></tr><tr><td style=" border: 1px solid #999999;"><p><strong>Locations</strong></p><p>(Continent, Sub-, Region, City, etc.)</p></td><td style=" border: 1px solid #999999;"><strong>Where</strong> is Eclipse run (geographical location)?</td><td style=" border: 1px solid #999999;"><ul><li>Europe (Continent)</li><li>Germany (Country)</li><li>Munich (City)</li></ul></td><td style=" border: 1px solid #999999;"><a href="http://community.jboss.org/servlet/JiveServlet/showImage/6334/city.png"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/6334/city.png </span></a></td></tr><tr><td style=" border: 1px solid #999999;"><strong>Browser</strong></td><td style=" border: 1px solid #999999;">What's the <strong>Eclipse product</strong> the user is running?</td><td style=" border: 1px solid #999999;"><ul><li>JBoss Developer Studio</li><li>JEE Eclipse</li><li>etc.</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Individual Versions are tracked in <strong>Visitors </strong>(Google Analytics section)</p></td><td style=" border: 1px solid #999999;"><p><a href="http://community.jboss.org/servlet/JiveServlet/showImage/6335/browser.png"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/6335/browser.png </span></a></p><p><a href="http://community.jboss.org/servlet/JiveServlet/showImage/6339/browser-versions.png"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/6339/browser-versions.png </span></a></p></td></tr><tr><td style=" border: 1px solid #999999;"><strong>Operating System</strong></td><td style=" border: 1px solid #999999;">What <strong>OS</strong> is JBoss Tools running on?</td><td style=" border: 1px solid #999999;"><ul><li>Linux</li><li>Macintosh</li><li>Windows</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Individual Versions are tracked and might be queried in <strong>Visitors</strong></p><p><strong><br/></strong></p></td><td style=" border: 1px solid #999999;"><p><a href="http://community.jboss.org/servlet/JiveServlet/showImage/6336/operating-systems.png"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/6336/operating-systems.png </span></a></p><p><a href="http://community.jboss.org/servlet/JiveServlet/showImage/102-15798-13-9341/os-versions.png"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/102-15798-13-9341/150-133/os-versions.png </span></a></p></td></tr><tr><td style=" border: 1px solid #999999;"><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>Screen Colors</strong></p></td><td style=" border: 1px solid #999999;">What is the <strong>screen color depth</strong> the user's using?</td><td style=" border: 1px solid #999999;"><ul><li>32-bit</li><li>24-bit</li><li>etc.</li></ul></td><td style=" border: 1px solid #999999;"><a href="http://community.jboss.org/servlet/JiveServlet/showImage/6337/screen-colors.png"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/6337/screen-colors.png </span></a></td></tr><tr><td style=" border: 1px solid #999999;"><strong>Screen Resolution</strong></td><td style=" border: 1px solid #999999;">What's the <strong>screen resolution</strong> the user's using?</td><td style=" border: 1px solid #999999;"><ul><li>1920x1080</li><li>etc</li></ul></td><td style=" border: 1px solid #999999;"><a href="http://community.jboss.org/servlet/JiveServlet/showImage/6340/screen-resolution.png"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/6340/screen-resolution.png </span></a></td></tr><tr><td style=" border: 1px solid #999999;"><strong>Flash Version</strong></td><td style=" border: 1px solid #999999;">What <strong>Java Version </strong>is Eclipse (and hence JBoss Tools) running on?</td><td style=" border: 1px solid #999999;"><ul><li>1.6.0_20</li><li>1.5.0_9</li><li>etc.</li></ul></td><td style=" border: 1px solid #999999;"><a href="http://community.jboss.org/servlet/JiveServlet/showImage/102-15798-13-7224/flash-version.png"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/102-15798-13-7224/350-70/flash-version.png </span></a></td></tr><tr><td style=" border: 1px solid #999999;"><strong>Connection Speed</strong></td><td style=" border: 1px solid #999999;">What <strong>internet connection</strong> is he using?</td><td style=" border: 1px solid #999999;"><ul><li>T1</li><li>Cable</li><li>etc.</li></ul></td><td style=" border: 1px solid #999999;"><a href="http://community.jboss.org/servlet/JiveServlet/showImage/6341/connection-speed.png"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/6341/connection-speed.png </span></a></td></tr></tbody></table><p><strong><br/></strong></p></div>
<div style="background-color: #f4f4f4; padding: 10px; margin-top: 20px;">
<p style="margin: 0;">Comment by <a href="http://community.jboss.org/docs/DOC-15798">going to Community</a></p>
<p style="margin: 0;">Create a new document in JBoss Tools at <a href="http://community.jboss.org/choose-container!input.jspa?contentType=102&containerType=14&container=2128">Community</a></p>
</div></td>
</tr>
</tbody>
</table>
</td>
</tr>
</tbody>
</table>
</div>
</body>
</html>