useDuxtAnalytics()
Eine Leserinteraktion an das eigene Callback der Seite melden — oder an niemanden.
Signatur
const analytics = useDuxtAnalytics();
analytics.track({ name: 'feedback', helpful: true });
Rückgabe
{ track }. track(event) prägt dem Ereignis den Dokumentationskontext auf und
übergibt es an duxt.analytics.track, falls die Seite dort eine Funktion
gesetzt hat.
Es gibt nichts zurück und wirft nie: Eine Aufrufstelle darf sich nicht dafür interessieren, ob das Melden funktioniert hat oder ob überhaupt jemand zuhört.
Anmerkungen
Das Ereignis ist eines aus einer geschlossenen Union — search,
search-result, copy, api-request, feedback — und track ergänzt den
context: den Dokumentationspfad ohne Locale-Präfix, Query-String und Fragment,
die Locale sowie die Quelle und die Version, wo die Seite mehr als eine hat.
Nur im Client. track kehrt auf dem Server sofort zurück, ein Build und ein
Vorab-Rendering melden also nichts — ein statisches Rendering ist kein Leser.
Dahinter steckt kein Transport. Keine Warteschlange, kein Puffer, kein Speicher, kein Cookie und kein Netzwerkaufruf: Die Funktion, die die Seite selbst mitbringt, ist das Einzige, was sie verlässt, und genau das hält den Anbieter, die Einwilligungsschranke und die Entscheidung, überhaupt zu übertragen, auf der Seite, der sie gehören. Eine Callback-Funktion, die wirft oder ablehnt, wird verschluckt.
Wie du eine verdrahtest, der vollständige Ereignisvertrag und was bewusst nie gesendet wird: Analytik-Ereignisse senden.