Umbraco

Copy your tracking snippet

In OnyxMetric, open your site's Site Settings and copy the tracking script. It looks like this:

<script src="https://app.onyxmetric.com/api/script.js?siteId=YOUR_SITE_ID" async></script>

YOUR_SITE_ID is the numeric ID of your site.

Add the snippet to Umbraco

1. In the backoffice, open Settings and expand Templates.
2. Open the master template your other templates use as their layout. If you have none, create one and point your page templates at it.
3. Add the tag before </head> and click Save:

@using Umbraco.Cms.Web.Common.PublishedModels;
@inherits Umbraco.Cms.Web.Common.Views.UmbracoViewPage
@{
    Layout = null;
}
<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8" />
    <title>@Model.Name</title>
    <script src="https://app.onyxmetric.com/api/script.js?siteId=YOUR_SITE_ID" async></script>
</head>
<body>
    @RenderBody()
</body>
</html>

4. Check that each page template points at it, for example Layout = "Master.cshtml";. A template with Layout = null; renders its own <head> and needs the tag added directly.

Saving in the backoffice writes the file to Views/Master.cshtml in the project, so you can also edit it in your IDE and commit it.

To keep the ID out of the template, store it in appsettings.json and read it through IConfiguration.

Check that it works

Load your live site and click through a few pages. Pageviews show up in the OnyxMetric dashboard within seconds.

If nothing arrives:

• View the page source and search for script.js?siteId= to confirm the tag is present.
• In the browser's Network tab, check that script.js returns 200 and that requests go to /api/track.
• Turn off ad blockers, or proxy the script through your own domain.
• Read script troubleshooting for other causes.