ASP.NET Integration - bchic Analytics

bchic Analytics lässt sich in wenigen Minuten in jede ASP.NET-Anwendung einbinden. Das Tracking-Script wird zentral in deinem Layout oder Master Page platziert und erfasst automatisch alle Seitenaufrufe ohne Cookies oder personenbezogene Daten.

Tracking-Script abrufen

Hole dir zunächst dein persönliches Tracking-Script aus dem bchic Dashboard.

Öffne die Einstellungen (Zahnrad-Icon unten links).
Navigiere zu Tracking → Setup.
Kopiere das angezeigte Script-Tag mit deiner Website-ID.

Das Script sieht etwa so aus:

<script defer src="https://cloud.bchic.de/script.js" data-website-id="deine-website-id"></script>

Script in Layout einbinden

Je nach ASP.NET-Version bindest du das Script unterschiedlich ein:

ASP.NET MVC / .NET Core

Öffne deine zentrale Layout-Datei (meist Views/Shared/_Layout.cshtml) und füge das Script im <head>-Bereich ein:

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
        <title>@ViewBag.Title - My Application</title>

        <!-- bchic Analytics -->
        <script defer src="https://cloud.bchic.de/script.js" data-website-id="deine-website-id"></script>

        @Styles.Render("~/Content/css")
        @Scripts.Render("~/bundles/modernizr")
</head>
<body>
@RenderBody()
</body>
</html>

ASP.NET Web Forms

Öffne deine Master Page (meist Site.Master) und füge das Script im <head>-Bereich der <asp:Content>-Sektion ein:

<%@ Master Language="C#" AutoEventWireup="true" CodeBehind="Site.master.cs" Inherits="YourApp.SiteMaster" %>
<!DOCTYPE html>
<html lang="de">
<head runat="server">
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title><%: Page.Title %> - My Application</title>

    <!-- bchic Analytics -->
    <script defer src="https://cloud.bchic.de/script.js" data-website-id="deine-website-id"></script>

    <asp:ContentPlaceHolder ID="HeadContent" runat="server">
    </asp:ContentPlaceHolder>
</head>
<body>
<form id="form1" runat="server">
    <asp:ContentPlaceHolder ID="MainContent" runat="server">
    </asp:ContentPlaceHolder>
</form>
</body>
</html>

ASP.NET Core Razor Pages

Öffne Pages/Shared/_Layout.cshtml und füge das Script hinzu:

<!DOCTYPE html>
<html lang="de">
<head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>@ViewData["Title"] - My Application</title>

    <!-- bchic Analytics -->
    <script defer src="https://cloud.bchic.de/script.js" data-website-id="deine-website-id"></script>

    <link rel="stylesheet" href="~/css/site.css" asp-append-version="true" />
</head>
<body>
<div class="container">
    <main role="main" class="pb-3">
        @RenderBody()
    </main>
</div>
@await RenderSectionAsync("Scripts", required: false)
</body>
</html>

Deployment und Überprüfung

Speichere die Änderungen und deploye deine Anwendung.
Öffne deine Website im Browser.
Prüfe im bchic Dashboard unter Live → Aktive Besucher, ob dein Besuch erfasst wurde.

Alternativ kannst du in den Browser DevTools (F12) → Network-Tab prüfen, ob ein Request an cloud.bchic.de/api/send erfolgreich gesendet wurde (Status 202).

Erweiterte Konfiguration

Custom Events tracken

Du kannst zusätzlich zu Seitenaufrufen auch Custom Events tracken, z.B. Button-Klicks oder Formular-Submissions:

// Im Script-Block oder in einer separaten JS-Datei
function trackCustomEvent(eventName, eventData) {
if (window.bchic) {
    window.bchic.track(eventName, eventData);
}
}

// Beispiel: Button-Klick tracken
document.getElementById('download-button').addEventListener('click', function() {
trackCustomEvent('download', { file: 'whitepaper.pdf' });
});

Single Page Application (SPA) Support

Falls du eine ASP.NET Core App mit einem Frontend-Framework wie React oder Vue.js betreibst, musst du Seitenaufrufe manuell tracken, wenn sich die URL ändert:

// Bei jedem Route-Change aufrufen
if (window.bchic) {
window.bchic.track();
}

Content Security Policy (CSP)

Falls du eine Content Security Policy verwendest, füge bchic zu deinen erlaubten Domains hinzu:

<meta http-equiv="Content-Security-Policy" content="
    script-src 'self' https://cloud.bchic.de;
    connect-src 'self' https://cloud.bchic.de;
">

Oder in deiner Web.config bzw. Startup.cs:

// ASP.NET Core Startup.cs
app.Use(async (context, next) =>
{
    context.Response.Headers.Add("Content-Security-Policy",
        "script-src 'self' https://cloud.bchic.de; connect-src 'self' https://cloud.bchic.de;");
    await next();
});

Entwicklungsumgebung ausschließen

Um Tracking auf localhost oder in Entwicklungsumgebungen zu deaktivieren, nutze eine Razor-Bedingung:

@if (!Context.Request.Host.Host.Contains("localhost"))
{
    <script defer src="https://cloud.bchic.de/script.js" data-website-id="deine-website-id"></script>
}

Häufige Probleme

Script wird nicht geladen

Prüfe, ob die data-website-id korrekt ist (keine Leerzeichen, kein Trailing Slash).
Stelle sicher, dass keine Firewall oder AdBlocker das Script blockiert.
Überprüfe die Browser Console (F12) auf JavaScript-Fehler.

Keine Daten im Dashboard

Warte 1-2 Minuten nach dem ersten Besuch, bis Daten verarbeitet wurden.
Stelle sicher, dass das Script im <head> steht, nicht am Ende von <body>.
Prüfe, ob deine Website öffentlich erreichbar ist (nicht hinter VPN/Firewall).

POST-Requests werden blockiert

Falls du AntiForgeryToken oder CSRF-Protection verwendest, stelle sicher, dass externe POST-Requests an cloud.bchic.de nicht betroffen sind. bchic sendet Tracking-Daten per POST, aber diese benötigen keine CSRF-Tokens.

Datenschutz & Compliance

bchic Analytics ist vollständig DSGVO-konform ohne Cookies oder Consent-Banner:

Keine Cookies → Keine Einwilligung erforderlich
Keine IP-Speicherung → Anonymisierung durch Hashing
Server in Deutschland (Hetzner Falkenstein)
Kein Drittland-Transfer → Keine US-Cloud

Deine Datenschutzerklärung muss bchic dennoch erwähnen. Wir stellen dir einen fertigen Textbaustein zur Verfügung: Datenschutz-Textbausteine

Support

Falls du Unterstützung bei der Integration benötigst oder Fragen zu deinem spezifischen ASP.NET-Setup hast, melde dich gerne direkt bei uns:

E-Mail: support@bchic.de
Chat: Direkt im Dashboard (Icon unten rechts)

Wir helfen dir gerne bei der Einrichtung, auch per Screenshare oder Remote-Session.

​ASP.NET MVC / .NET Core

​ASP.NET Web Forms

​ASP.NET Core Razor Pages

​Erweiterte Konfiguration

​Custom Events tracken

​Single Page Application (SPA) Support

​Content Security Policy (CSP)

​Entwicklungsumgebung ausschließen

​Häufige Probleme

​Script wird nicht geladen

​Keine Daten im Dashboard

​POST-Requests werden blockiert

​Datenschutz & Compliance

​Support