Analytics

Welche Seiten gelesen werden, und wonach Leser suchen, ohne es zu finden: Analytics zeigt, wo die Dokumentation hilft und wo sie zu kurz kommt. Clay arbeitet mit drei Diensten, die keine Cookies setzen und keine personenbezogenen Daten speichern: Plausible, Umami und GoatCounter. Jeden davon gibt es als gehosteten Dienst oder für den eigenen Server.

analytics:
  plausible: {}

analytics:
  plausible:
    domain: "docs.example.com"
    src: "https://stats.example.com/js/script.js"

analytics:
  umami:
    websiteId: "94db1cb1-74f4-4a40-ad6c-962362670409"

analytics:
  goatcounter:
    code: "meine-docs"

#Was gezählt wird

• Seitenaufrufe, auch wenn Leser von Seite zu Seite gehen, ohne dass der Browser eine neue Seite lädt.
• Suchen ohne Ergebnis, mit dem Suchbegriff, einen Moment nachdem der Leser aufhört zu tippen. Sie zeigen, was deiner Dokumentation fehlt.
• Kopierter Code und Prompts, und das Seitenmenü: eine Seite als Markdown kopieren oder öffnen und ChatGPT oder Claude dazu fragen.
• Antworten auf „War diese Seite hilfreich?“, siehe unten.

Nur Seitenaufrufe zählen:

analytics:
  plausible: {}
  events: false

In Plausible erscheinen Ereignisse, sobald du sie als Ziele anlegst, etwa „Search without results“. Umami und GoatCounter listen sie von selbst.

#War diese Seite hilfreich?

Mit Analytics endet jede Seite mit der Frage „War diese Seite hilfreich?“ und einem Ja und einem Nein. Eine Antwort wird als Ereignis „Page feedback“ gezählt, mit der Seite und yes oder no, und die Frage weicht einem Dank. Seiten mit vielen Neins sind die, die du zuerst verbessern solltest.

Eine Seite wird einmal beantwortet, solange die Seite offen ist. Die Antwort wird nicht auf dem Gerät des Lesers gespeichert; ein späterer Besuch fragt also wieder. Leser, deren Browser darum bittet, nicht verfolgt zu werden, sehen die Frage nicht, da nichts sie zählen würde, und ebenso niemand bei events: false. Um die anderen Ereignisse ohne die Frage zu behalten:

analytics:
  plausible: {}
  feedback: false

#Wann nichts gezählt wird

• Während clay dev: Analytics läuft nur in gebauten Seiten.
• Bei Lesern, die nicht verfolgt werden wollen: Browser mit Global Privacy Control oder Do Not Track laden gar keine Analytics.

#Datenschutz

In der EU braucht es die Einwilligung der Leser, um etwas auf ihrem Gerät zu speichern oder auszulesen, etwa ein Cookie, außer es ist unbedingt erforderlich (die ePrivacy-Richtlinie, in Deutschland das TDDDG). Personenbezogene Daten wie IP-Adressen brauchen nach der DSGVO eine Rechtsgrundlage.

Die drei Dienste sind so gebaut, dass das einfach bleibt: Sie setzen keine Cookies und nutzen nichts sonst auf dem Gerät der Leser, und sie speichern keine IP-Adressen oder anderen personenbezogenen Daten, nur Zahlen. Deshalb werden sie üblicherweise ohne Cookie-Banner genutzt, auf Grundlage eines berechtigten Interesses. Was dir bleibt:

• Nenne den Dienst in deiner Datenschutzerklärung: was gezählt wird, von wem und warum.
• Schließ den Auftragsverarbeitungsvertrag des Dienstes ab, wenn du ihn gehostet nutzt. Plausible und GoatCounter werden in der EU gehostet; mit einem eigenen Server verlassen die Daten ihn nie.
• Suchbegriffe sind Text, den Leser tippen. Wenn sie personenbezogene Daten in die Suche tippen könnten, schalte Ereignisse mit events: false ab.

Dienste, die Cookies setzen, etwa Google Analytics, brauchen eine Einwilligung, bevor sie laden, und damit ein Cookie-Banner. Clay bringt keines mit. Brauchst du einen solchen Dienst, füge sein Skript mit head und einem Einwilligungs-Werkzeug deiner Wahl hinzu.