Community Events 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>Community</strong> <strong>Events </strong>data source, which tracks all Event activity across your <strong>Higher Logic Vanilla (Vanilla)</strong> community.</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/F0GBLNOGMKOC/commevents-datasource.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/F0GBLNOGMKOC/commevents-datasource.png" alt="CommEvents_DataSource.png" height="847" width="1461" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <h2 data-id="overview">Overview</h2><p>The Community Event data source tracks when:</p><ul><li>an event is added</li><li>an event is updated</li><li>an event is deleted</li><li>users RSVP to an event</li></ul><p>For each Event activity logged, you can see:</p><ul><li>the <strong>Type</strong> of action that occurred</li><li>the <strong>Event Name</strong> or <strong>ID </strong></li><li>the <strong>Event Location </strong></li><li>the <strong>Event Start Date</strong></li><li>the <strong>Event End Date</strong></li><li>the <strong>Parent Record Type</strong></li><li>the <strong>Parent Record ID</strong></li><li>the <strong>Subcommunity Name </strong>or<strong> ID</strong></li><li>information about the <strong>User</strong> who initiated the action</li></ul><p>When users RSVP to an event, you will also be able to see:</p><ul><li>the response received aka <strong>Responding User Event Attending</strong></li><li>information about the <strong>Responding User </strong></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 event name/ID, event location, subcommunity, user name/ID, 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 guests from traffic data or focus your Chart on traffic seen in a specific category).</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/50V3M4XD342P/groupby-filters.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/50V3M4XD342P/groupby-filters.png" alt="GroupBy_Filters.png" height="805" width="1064" 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="type">Type</h2><p>Each Event action logged has a <strong>type. </strong>The type parameter defines what happened. </p><ul><li><strong>add</strong>:<strong> </strong>An event was added</li><li><strong>edit</strong>: An event was edited</li><li><strong>delete</strong>:<strong> </strong>An event was deleted</li><li><strong>responseReceived</strong>:<strong> </strong>A user RSVP'ed to an event</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/TLVK3MVMPRUE/type-example.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/TLVK3MVMPRUE/type-example.png" alt="type_example.png" height="552" width="1064" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <h2 data-id="event-info">Event info</h2><p>Each Event action logged is associated with a specific Event. You can group and/or filter Event data based on the following event parameters:</p><ul><li><strong>Event Name: </strong>The name of the event</li><li><strong>Event ID: </strong>The event ID</li><li><strong>Event Location: </strong>Where the event is being hosted</li><li><strong>Event Start Date: </strong>When the event is scheduled to start</li><li><strong>Event End Date: </strong>When the event is scheduled to end</li><li><strong>Parent Record Type: </strong>If the event was posted in a group OR category</li><li><strong>Parent Record ID: </strong>The ID of the group or category the event was posted in</li><li><strong>Subcommunity Name: </strong>The name of the subcommunity the event was posted in</li><li><strong>Subcommunity ID: </strong>The ID of the subcommunity the event was posted in</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/9GQ5LK2J11DR/event-info-example.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/9GQ5LK2J11DR/event-info-example.png" alt="event_info_example.png" height="806" width="1064" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <h2 data-id="responding-user-event-attending">Responding User Event Attending</h2><p>The <strong>Responding User Event Attending</strong> parameter will only appear on <strong>responseReceived</strong> activity, and defines the RSVP response received. This will either be <strong>Yes</strong>, <strong>No</strong>, or <strong>Maybe</strong>. If "Other" is listed, your Chart includes other types of event activity such as add, edit, or delete.</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6030677/uploads/EI5PRZ835C9G/responding-user-event.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/EI5PRZ835C9G/responding-user-event.png" alt="responding_user_event.png" height="663" width="1103" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <h2 data-id="responding-user-nameid">Responding User Name/ID</h2><p>The<strong> Responding User Name </strong>and <strong>Responding User ID </strong>will only appear on <strong>responseReceived </strong>activity, and defines the user RSVP'ing to the event. Typically, this will be the same as the User Name and User ID info, but can differ if an RSVP is being logged via the API.</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6030677/uploads/PIXP4VWNRFN7/responding-user-name-id.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/PIXP4VWNRFN7/responding-user-name-id.png" alt="responding_user_Name_ID.png" height="674" width="1109" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <h2 data-id="user-info">User Info</h2><p>Each Event activity is triggered by a user. This parameter will define the user who added, edited, or deleted an event, OR the user who has RSVP'ed to the event. You can group and filter Event data using the following user parameters:</p><ul><li>User Name</li><li>User ID</li><li>User UUID</li><li>User Role Type</li><li>User Rank ID</li><li>User Rank Name</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/W9QUC2L31T9U/user-info.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/W9QUC2L31T9U/user-info.png" alt="user_info.png" height="868" width="1109" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p><br></p> </article> </main>