useDuxtAnalytics()
Informa de una interacción del lector a la función propia del sitio, o a nadie.
Firma
const analytics = useDuxtAnalytics();
analytics.track({ name: 'feedback', helpful: true });
Devuelve
{ track }. track(event) estampa el contexto de la documentación en el evento
y se lo entrega a duxt.analytics.track, si el sitio configuró una.
No devuelve nada y nunca lanza: a un punto de llamada no le debe importar si el informe funcionó, ni si hay alguien escuchando siquiera.
Notas
El evento es uno de una unión cerrada — search, search-result, copy,
api-request, feedback — y track añade el context: la ruta de la
documentación sin su prefijo de locale, cadena de consulta ni fragmento, el
locale, y la fuente y la versión donde el sitio tiene más de una.
Solo en el cliente. track vuelve de inmediato en el servidor, así que una
compilación y un prerrenderizado no informan de nada — un renderizado estático
no es un lector.
Detrás de esto no hay transporte. Ni cola, ni búfer, ni almacenamiento, ni cookie, ni llamada de red: la función propia del sitio es lo único que sale de la página, que es lo que mantiene el proveedor, la barrera de consentimiento y la decisión misma de transmitir del lado al que corresponden. Una función de retorno que lanza o rechaza se descarta.
Cómo conectar una, el contrato completo de eventos y lo que a propósito no se envía nunca: Enviar eventos de analítica.