Post Modification 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>Post modifications</strong> data source, which tracks all updates to discussions and comments 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/Y3EB31SZOECQ/post-modifications-datasource.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/Y3EB31SZOECQ/post-modifications-datasource.png" alt="post_modifications_DataSource.png" height="592" width="1160" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <h2 data-id="overview">Overview</h2><p>The Post modifications data source tracks when:</p><ul><li>Discussions are:<ul><li>Edited</li><li>Tagged</li><li>Moved</li><li>Merged</li><li>Closed</li><li>Deleted</li></ul></li><li>Comments are:<ul><li>Edited</li><li>Deleted</li><li>Split</li></ul></li></ul><p>For each modification event logged, you can see:</p><ul><li>the <strong>Type </strong>of modification that was made</li><li>information about the User who published the post that was modified, or the <strong>Insert User</strong></li><li>information about the <strong>User </strong>who made the modification</li><li>the <strong>Category </strong>the modified post is published in</li><li>the <strong>Discussion</strong> that was modified</li></ul><p>Some modification events include additional information. For example:</p><ul><li>When a discussion is moved you can see:<ul><li>the Category it was originally posted in, or the <strong>Source Category</strong></li><li>the Category it was moved to</li></ul></li><li>When a comment is split, or discussions are merged, you can see:<ul><li>the discussion that was originally posted, or the <strong>Source Discussion</strong></li><li>the new discussion that is now posted, or the <strong>Destination Discussion</strong></li></ul></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 modification action (type), 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 members from modification data or focus your Chart on changes made 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/PZQYXMVF5JNH/groupby-and-filters-postmodifications.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/PZQYXMVF5JNH/groupby-and-filters-postmodifications.png" alt="GroupBy_and_Filters-PostModifications.png" height="800" width="1160" 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>The <strong>Type </strong>parameters define the type of modification that occurred:</p><ul><li><strong>comment_edit</strong>: when a comment is edited</li><li><strong>comment_delete</strong>: when a comment is deleted</li><li><strong>comment_split</strong>:<strong> </strong>when a comment is split from its original discussion to create a new thread</li><li><strong>discussionTagged</strong>: when a discussion is tagged</li><li><strong>discussion_edit</strong>:<strong> </strong>when a discussion is edited</li><li><strong>discussion_close</strong>: when a discussion is closed for commenting</li><li><strong>discussion_move</strong>: when a discussion is moved from one category to another</li><li><strong>discussion_merge</strong>:<strong> </strong>when two or more discussions are merged together</li><li><strong>discussion_delete</strong>:<strong> </strong>when a discussion is deleted</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/3LCG1NDLSAQN/group-by-type-pm.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/3LCG1NDLSAQN/group-by-type-pm.png" alt="group_by_type-PM.png" height="607" width="1160" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <h2 data-id="user-name-id-role-rank">User Name, ID, Role, Rank</h2><p>The <strong>User </strong>data shows who modified the post.</p><p>Group data by:</p><ul><li>User Rank Name or ID to see a breakdown of which Ranks are modifying posts</li><li>User Role Name or ID to see a breakdown of which Roles are modifying posts</li><li>User Name, ID, or UUID to see a breakdown of all users modifying posts</li></ul><p>Filter data by:</p><ul><li>User Role Name or ID to see post modifications made by users of a specific Role</li><li>User Rank Name or ID to see post modifications made by users of a specific Rank</li><li>User Name, ID, or UUID to see post modifications made by a specific user</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/1TUYAAP6QRKJ/group-by-user-pm.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/1TUYAAP6QRKJ/group-by-user-pm.png" alt="group_by_user-PM.png" height="663" width="1160" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <h2 data-id="insert-user-name-id-role-rank">Insert User Name, ID, Role, Rank</h2><p>The <strong>Insert User</strong> data shows who posted the content that was modified.</p><p>Group data by</p><ul><li>Insert User Name, ID, or UUID to see a breakdown of all users who have posted content that was then modified</li><li>Insert User Rank Name or ID to see a breakdown of which Ranks have posted content that was then modified</li><li>Insert User Role Name or ID to see a breakdown of which Roles have posted content that was then modified</li></ul><p>Filter data by </p><ul><li>Insert User Name, ID, or UUID to see modifications made to posts by a specific user</li><li>Role Name or ID to see modifications made to posts by users of a specific Role</li><li>Rank Name or ID to see modifications made to posts by users of a specific Rank</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/RJSAAIVKZAFB/group-by-insertuser-pm.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/RJSAAIVKZAFB/group-by-insertuser-pm.png" alt="group_by_InsertUser-PM.png" height="716" width="1160" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <h2 data-id="category">Category</h2><p>The <strong>Category </strong>data shows where the modified post is published. </p><p><strong>šļ»æ NOTE</strong>: For <code class="code codeInline" spellcheck="false" tabindex="0">discussion_move</code> events, the Category will describe the Category the post was moved to.</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/U3CYV1VO9VKZ/group-by-category-pm.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/U3CYV1VO9VKZ/group-by-category-pm.png" alt="group_by_Category-PM.png" height="603" width="1160" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <h2 data-id="source-category">Source Category</h2><p>The <strong>Source Category</strong> data only appears for <code class="code codeInline" spellcheck="false" tabindex="0">discussion_move</code> events, and defines the Category the discussion was originally posted to.</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/QAAERYTYQ3UX/group-by-sourcecategory-pm.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/QAAERYTYQ3UX/group-by-sourcecategory-pm.png" alt="group_by_SourceCategory-PM.png" height="544" width="1160" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <h2 data-id="source-discussion">Source Discussion</h2><p>The <strong>Source Discussion</strong> data only appears for <code class="code codeInline" spellcheck="false" tabindex="0">discussion_merge</code> and <code class="code codeInline" spellcheck="false" tabindex="0">comment_split</code> events, and will define:</p><ul><li>The name of the discussion that was posted and then merged</li><li>The name of the discussion where a split comment was originally posted</li></ul><h2 data-id="destination-discussion">Destination Discussion</h2><p>The <strong>Destination Discussion</strong> data only appears for <code class="code codeInline" spellcheck="false" tabindex="0">discussion_merge</code> and <code class="code codeInline" spellcheck="false" tabindex="0">comment_split</code> events, and will define:</p><ul><li>The new discussion created from merged discussions</li><li>The new discussion created from split comments</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/AZ4PZ3C233C3/group-by-discussions-pm.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/AZ4PZ3C233C3/group-by-discussions-pm.png" alt="group_by_discussions-PM.png" height="678" width="1160" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p><br></p> </article> </main>