AstralRinth/packages/blog/compiled/project_analytics_2_0.content.ts

// AUTO-GENERATED FILE - DO NOT EDIT
export const html = `<p>Hey everyone!</p><p>For a long time we’ve wanted to give creators better insights into their projects, so I’m excited to share a complete overhaul to project analytics.</p><p>With a new query builder and a lot of new data, you can finally dig into how people are playing your content.</p><div class="video-wrapper mb-8"><video autoplay loop muted playsinline><source src="./analytics-demo.mp4" type="video/mp4"></video></div><h2>TL;DR</h2><ul><li>Query builder</li><li>Breakdowns and filters</li><li>Playtime metrics</li><li>Line, area, and bar chart views</li><li>Table view</li><li>Event markers for project releases and Modrinth outages</li></ul><h2>Explore Your Data</h2><p>To kick things off, let’s talk about the new query builder. At the top of the analytics dashboard, you’ll find a set of controls that lets you ask questions about your projects. You can select projects, choose a timeframe, and add breakdowns and filters to explore exactly the data you want.</p><div class="video-wrapper mb-8"><video autoplay loop muted playsinline><source src="./query-builder.mp4" type="video/mp4"></video></div><h3>Choosing Projects</h3><p>The first step is to choose the projects you want to look at. You can select projects you own, along with projects you’re associated with through organizations.</p><p>When not viewing analytics from a project, the page defaults to selecting all projects and breaking down by project.</p><h3>Timeframes + Interval</h3><p>Next, select a timeframe and group results by an interval. We’ve added several timeframe presets like “Last 30 Days”, along with a custom date range picker. The intervals you can group by are based on the timeframe.</p><h3>Breakdowns + Filters</h3><p>Lastly, the meat and potatoes: breakdowns and filters. Breakdowns split your data into groups to compare. Filters narrow the data down to only what you want to see. You can select up to two breakdowns and as many filters as you want. The following breakdowns and filters are available:</p><ul><li>Project<ul><li>Only available when more than one project is selected</li></ul></li><li>Country</li><li>Monetization<ul><li>Downloads or views that are monetized or unmonetized</li></ul></li><li>Download source<ul><li>Downloads coming from other sources using the CDN, such as launchers</li></ul></li><li>Download reason<ul><li>The reason for the download, such as modpack, dependency, standalone, etc.</li></ul></li><li>Project version</li><li>Loader<ul><li>Downloads from loaders supported by the project</li></ul></li><li>Game version<ul><li>Downloads from game versions supported by the project</li></ul></li></ul><h2>Metrics Overview</h2><p>After selecting your query parameters, all of the data below updates automatically. At the top is an overview with four metric cards showing total views, downloads, revenue, and playtime. Playtime is a new metric that tracks hours played by users in the Modrinth App. You can select any metric card to explore that data further on the graph below.</p><p><img src="/news/article/project-analytics-2.0/metrics-overview.png" alt="A screenshot of the new project analytics metric cards showing views, downloads, revenue, and playtime."></p><h2>Graph Visualization</h2><p>The graph card got a fresh coat of paint too. There are now three different graph views: line, area, and bar. Depending on your query and selected graph view, additional toggles may appear for things like comparing against the previous period or showing values as a ratio instead of a raw amount.</p><div class="video-wrapper mb-8"><video autoplay loop muted playsinline><source src="./graph-views.mp4" type="video/mp4"></video></div><p>The parameters shown on the graph are controlled through the table card below by checking rows. By default, the graph will pre-select up to the first eight parameters based on the current table sorting. You can also hide parameters directly from the graph by clicking them in the legend.</p><h3>Event Markers</h3><p>Another new addition to the graph card is events. Events are markers designed to provide context for unusual trends on the graph. There are two types of events:</p><ul><li><strong>Project Events:</strong> Notable changes related to your project, such as status changes or version releases</li><li><strong>Modrinth Events:</strong> Things that happened on Modrinth that may affect analytics, such as revenue being overreported or analytics outages</li></ul><h2>Table Visualization</h2><p>We’ve also added a new table view at the bottom that displays the full results for your query. The table makes comparing views, downloads, revenue, and playtime much easier.</p><p>You can also export the table as a CSV to manipulate the data in other tools, with options to include the selected interval.</p><p><img src="/news/article/project-analytics-2.0/breakdown-table.png" alt="A screenshot of the project analytics breakdown table showing country rows and metric columns."></p><h2>Contributing Analytics Data</h2><p>If your project uses the Modrinth CDN to download content, you can also send analytics data back to creators. When sending requests to <code>cdn.modrinth.com</code>, include the <code>modrinth-download-meta</code> header:</p><pre><code class="language-json">{
	&quot;reason&quot;: &quot;standalone&quot; | &quot;dependency&quot; | &quot;modpack&quot; | &quot;update&quot;,
	&quot;game_version&quot;: &quot;&lt;valid game version tag&gt;&quot;,
	&quot;loader&quot;: &quot;&lt;valid loader tag&gt;&quot;
}
</code></pre><ul><li><strong>Standalone:</strong> The file was downloaded directly by the user, such as browsing and installing it manually.</li><li><strong>Dependency:</strong> The file was downloaded because it was required by another mod. This can be automatic through a launcher or manually through a dependencies section.</li><li><strong>Modpack:</strong> The file was downloaded as part of installing a modpack.</li><li><strong>Update:</strong> The file was downloaded because the user updated something already installed.</li></ul><p>If using headers isn’t possible, or query parameters work better for your setup, you can also use <code>mr_</code>-prefixed query params instead:</p><pre><code class="language-text">cdn.modrinth.com/...?mr_download_reason=standalone&amp;mr_game_version=1.20.1&amp;mr_loader=fabric
</code></pre><p>—</p><p>We hope you’re as excited about this as we are!</p>`;