AnalyticsClarity

Frameworks · Integration

VitePress mit AnalyticsClarity verbinden

AnalyticsClarity für VitePress-Dokumentation aktivieren.

AnalyticsClarity verwendet keine Cookies und keine Fingerprinting-Techniken. Senden Sie mit Ereignissen niemals E-Mail-Adressen, Namen, Bestellnummern, IP-Adressen oder andere personenbezogene Daten.

Vorbereitung

Erstellen oder wählen Sie zuerst die passende Website in AnalyticsClarity. Kopieren Sie anschließend die Website-ID aus Websites → Ihre Website → Einstellungen → Tracking-Code.

Installation

  1. 1

    Einbauort öffnen

    Ergänzen Sie .vitepress/config.ts mit einem head-Eintrag.
  2. 2

    Tag einrichten

    Website-ID kopieren.
  3. 3

    Tag einrichten

    Script mit data-ac-website-id als head-Eintrag hinterlegen.
  4. 4

    Veröffentlichen und prüfen

    Dokumentation neu bauen und veröffentlichen.
AnalyticsClarity
// .vitepress/config.ts
export default defineConfig({
  head: [[
    'script',
    {
      defer: '',
      src: 'https://script.aclaritytag.com/ac.js',
      'data-ac-website-id': 'IHRE_WEBSITE_ID',
    },
  ]],
});
Ersetzen Sie IHRE_WEBSITE_ID durch die ID aus Ihren AnalyticsClarity-Website-Einstellungen.

Eigene Ereignisse taggen

Für Klicks können Sie ein Ereignis direkt als HTML-Attribut ergänzen. Verwenden Sie kurze, sachliche Namen und nur nicht-personenbezogene Eigenschaften.

AnalyticsClarity
<button
  data-ac-event="cta_geklickt"
  data-ac-event-placement="hero">
  Kostenlos starten
</button>
Beispiel: ein CTA-Klick mit sicherer Platzierungsangabe.

Nach erfolgreichen Formularen, Käufen oder anderen Aktionen können Sie ein Ereignis auch im Code auslösen:

AnalyticsClarity
window.analyticsClarity?.track('formular_abgesendet', {
  form_id: 'kontakt',
});
Beispiel: nach erfolgreichem Absenden eines Kontaktformulars.
Verwenden Sie analyticsClarity.track nicht für Kontaktdaten, Suchbegriffe, Freitext oder eindeutige Kundenkennungen. Die strenge DSGVO-Konfiguration unterstützt keine Nutzer-Identifikation.

Erfolg prüfen und entfernen

  • Rufen Sie die veröffentlichte Website in einem Browser ohne Content Blocker auf.
  • Öffnen Sie in AnalyticsClarity die Website. Nach dem ersten Aufruf erscheinen die ersten Daten im Dashboard.
  • Bei Single-Page-Apps werden normale URL-Wechsel über die Browser-History automatisch erfasst.
  • Zum Entfernen löschen Sie das Script beziehungsweise den Tag aus dem oben genannten Einbauort und veröffentlichen die Änderung.
WeiterEreignisse und Ziele aktivierenTracking prüfen und die ersten wichtigen Aktionen messen.