> ## 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.

# Mintlify Integration

> So integrierst du bchic Analytics in deine Mintlify Dokumentation.

Da Mintlify aktuell noch keine native Plugin-Integration anbietet, binden wir das Tracking über ein kleines, benutzerdefiniertes Skript ein. Das ist in wenigen Minuten erledigt.

<Steps>
  <Step title="Website ID abrufen">
    Zuerst benötigst du die **Website ID** deiner Dokumentation aus deinem bchic Dashboard.

    1. Öffne die **Einstellungen** (Zahnrad-Icon unten links).
    2. Navigiere zum Menüpunkt **Organisation**.
    3. Öffne den Bereich "Verknüpfte Website URLs" über das Pfeil-Icon.

    <img src="https://mintcdn.com/bchic/bC-FpAMa04VldK7d/images/integration/mintlify/step1.jpeg?fit=max&auto=format&n=bC-FpAMa04VldK7d&q=85&s=711f62981c650e4bedbb00cd1e407e97" alt="Einstellungen Organisation Dashboard" width="1920" height="1080" data-path="images/integration/mintlify/step1.jpeg" />

    Füge hier nun die URL deiner Dokumentation hinzu (z. B. `docs.deine-firma.de`) und klicke auf das Plus-Symbol:

    <img src="https://mintcdn.com/bchic/bC-FpAMa04VldK7d/images/integration/mintlify/step2.jpeg?fit=max&auto=format&n=bC-FpAMa04VldK7d&q=85&s=908baf6a63762582a658c6977b1ef6c0" alt="URL zur Organisation hinzufügen" width="1920" height="1080" data-path="images/integration/mintlify/step2.jpeg" />

    Klicke anschließend neben der neu erstellten URL auf den **Installations-Button** (das Code-Icon). Kopiere dir aus dem angezeigten Code-Schnipsel deine ID heraus. Du findest sie im Attribut `data-website-id`.

    <img src="https://mintcdn.com/bchic/bC-FpAMa04VldK7d/images/integration/mintlify/step3.jpeg?fit=max&auto=format&n=bC-FpAMa04VldK7d&q=85&s=f973a9819bc01da506bbe3139ab62807" alt="Website ID kopieren" width="1920" height="1080" data-path="images/integration/mintlify/step3.jpeg" />
  </Step>

  <Step title="Tracking-Datei erstellen">
    Erstelle nun in deinem Dokumentations-Projekt eine neue Datei. Wir empfehlen, diese im Hauptverzeichnis (dort wo auch deine `docs.json` liegt) zu speichern.

    Nenne die Datei: `bchic.js`

    Füge den folgenden Code in diese Datei ein. **Wichtig:** Ersetze `YOUR-ID-HERE` mit der ID, die du im ersten Schritt kopiert hast.

    ```javascript bchic.js theme={null}
    (function() {
    // Create a new script element
    var script = document.createElement('script');

    // Set the source and defer attributes
    script.src = 'https://analytics.bchic.de/script.js';
    script.defer = true;

    // Set your custom data-website-id attribute
    script.setAttribute('data-website-id', 'YOUR-ID-HERE');

    // Append the script to the head of the document to start loading it
    document.head.appendChild(script);
    })();
    ```
  </Step>
</Steps>

## Überprüfung

Sobald du diese Änderungen gepusht hast, wird das Skript automatisch auf allen Seiten deiner Dokumentation geladen. Du kannst die Installation überprüfen, indem du deine Docs besuchst und im bchic Dashboard schaust, ob der erste Besucher (du selbst) getrackt wird.
