Points Data for Analytics - HL Vanilla Community
<main> <article class="userContent"> <p><strong>📝 NOTE</strong>: It is assumed you know how to create custom Dashboards and Charts. If not, <a href="https://success.vanillaforums.com/kb/articles/433#building-custom-charts-dashboards" rel="nofollow noreferrer ugc">read this article</a> before proceeding.</p><p>When building your own Dashboard Charts, you can pull data from various <strong>data sources</strong> to view different types of analytics events.</p><ul><li>In this article, we're going to focus on the <strong>Points</strong> data source.</li></ul><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6030677/uploads/HY0X2OBRA7DQ/points-ds.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/HY0X2OBRA7DQ/points-ds.png" alt="points_DS.png" height="868" width="1024" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <h2 data-id="overview">Overview</h2><p>The Points data source tracks each time a user earns points in your <strong>Higher Logic Vanilla </strong>community through:</p><ul><li>Badges</li><li>Reactions</li><li>Q&A</li></ul><h2 data-id="filter-chart-data">Filter Chart data</h2><p>Controlling what data is shown in a Chart is accomplished via the <strong>Group By</strong> and <strong>Filter </strong>options.</p><ul><li>The <strong>Group By</strong> options (available for pie graphs, line graphs, bar graphs, and tables) enable you to view data by points data by user, subcommunity, Category, country, and more.</li><li>You can add <strong>Filters </strong>to your query to <em>drill into</em> or <em>exclude</em> specific types of events (e.g., exclude staff Roles from points data or focus your Chart on points earned in a specific Subcommunity).</li></ul><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6030677/uploads/2TNWU04LPU3O/points-groupby-filters.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/2TNWU04LPU3O/points-groupby-filters.png" alt="points_GroupBy_Filters.png" height="806" width="1059" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p>Let's learn about each of the available Group By and Filter options.</p><h2 data-id="user">User</h2><p>For each Points event logged, the following information is available about the user who has earned the points. Use this data to group or filter Points data. </p><ul><li><strong>Continent</strong></li><li><strong>Country</strong> and<strong> Country Code</strong></li><li><strong>User Name</strong></li><li><strong>User Role Type, Role Name </strong>and <strong>Role ID</strong></li><li><strong>User Rank</strong></li><li><strong>User ID</strong></li><li><strong>User UUID</strong></li></ul><h2 data-id="points">Points</h2><p>For each event logged, the following information is provided:</p><ul><li>the number of <strong>Points Given</strong></li><li>the <strong>Points Source, </strong>this can include:<ul><li>Reactions</li><li>Q&A</li><li>Badges</li><li>Posts</li></ul></li></ul><h2 data-id="category-subcommunity">Category & Subcommunity</h2><ul><li>When points are earned via Q&A, Reactions, and Posts, the Category Name is logged, allowing you to track how many points users have been awarded per category. </li><li>If you're using Subcommunities, the Subcommunity Name and ID are logged. This enables you to track how many points users have been awarded per Subcommunity. </li><li>Points earned via Badges don't have an associated Category or Subcommunity because these points are considered global.</li></ul><p>The following parameters can be used to group or filter Points data by Category and Subcommunity:</p><ul><li><strong>Category Name</strong></li><li><strong>Subcommunity Name</strong></li><li><strong>Subcommunity ID</strong></li></ul><p><br></p> </article> </main>