Dokumentation & Inhalte · Integration

GitBook mit AnalyticsClarity verbinden

AnalyticsClarity auf einer veröffentlichten GitBook-Site einrichten.

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

    Öffnen Sie die Site-Einstellungen und suchen Sie nach Custom Code oder Header-Code.
  2. 2

    Tag einrichten

    Website-ID kopieren.
  3. 3

    Tag einrichten

    Tag im globalen Head-Code der veröffentlichten Site einfügen.
  4. 4

    Veröffentlichen und prüfen

    Dokumentation veröffentlichen und eine öffentliche Seite testen.
AnalyticsClarity
<script defer
  src="https://script.aclaritytag.com/ac.js"
  data-ac-website-id="IHRE_WEBSITE_ID"></script>
Ersetzen Sie IHRE_WEBSITE_ID durch die ID aus Ihren AnalyticsClarity-Website-Einstellungen.
Wenn Ihr GitBook-Tarif keinen Custom Code erlaubt, messen Sie die vorgeschaltete Website oder verwenden Sie eine eigene Dokumentationsauslieferung.

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.