> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bchic.de/llms.txt
> Use this file to discover all available pages before exploring further.
# ASP.NET Integration
> Integriere bchic Analytics in deine ASP.NET Web Application oder MVC-Projekt.
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.
Hole dir zunächst dein persönliches Tracking-Script aus dem bchic Dashboard.
1. Öffne die **Einstellungen** (Zahnrad-Icon unten links).
2. Navigiere zu **Tracking → Setup**.
3. Kopiere das angezeigte Script-Tag mit deiner Website-ID.
Das Script sieht etwa so aus:
```html theme={null}
```
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 ``-Bereich ein:
```html theme={null}
@ViewBag.Title - My Application
@Styles.Render("~/Content/css")
@Scripts.Render("~/bundles/modernizr")
@RenderBody()
```
### ASP.NET Web Forms
Öffne deine Master Page (meist `Site.Master`) und füge das Script im ``-Bereich der ``-Sektion ein:
```html theme={null}
<%@ Master Language="C#" AutoEventWireup="true" CodeBehind="Site.master.cs" Inherits="YourApp.SiteMaster" %>
<%: Page.Title %> - My Application
```
### ASP.NET Core Razor Pages
Öffne `Pages/Shared/_Layout.cshtml` und füge das Script hinzu:
```html theme={null}
@ViewData["Title"] - My Application
@RenderBody()
@await RenderSectionAsync("Scripts", required: false)
```
1. Speichere die Änderungen und deploye deine Anwendung.
2. Öffne deine Website im Browser.
3. 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:
```javascript theme={null}
// 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:
```javascript theme={null}
// 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:
```html theme={null}
```
Oder in deiner `Web.config` bzw. `Startup.cs`:
```csharp theme={null}
// 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:
```html theme={null}
@if (!Context.Request.Host.Host.Contains("localhost"))
{
}
```
## 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 `` steht, nicht am Ende von ``.
* 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](https://docs.bchic.de/de/legal/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](mailto:support@bchic.de)
* **Chat:** Direkt im Dashboard (Icon unten rechts)
Wir helfen dir gerne bei der Einrichtung, auch per Screenshare oder Remote-Session.