## Assinatura

```ts
const analytics = useDuxtAnalytics();

analytics.track({ name: 'feedback', helpful: true });
```

## Devolve

`{ track }`. O `track(event)` carimba o contexto da documentação no evento e
entrega-o a `duxt.analytics.track`, se o site tiver configurado um.

Não devolve nada e nunca lança: quem o chama não pode ter de se importar se a
comunicação resultou, nem sequer se há alguém à escuta.

## Notas

O evento é um de uma união fechada — `search`, `search-result`, `copy`,
`api-request`, `feedback` — e o `track` acrescenta o `context`: o caminho da
documentação sem o seu prefixo de locale, query string ou fragmento, o locale, e
a fonte e a versão onde o site tem mais do que uma.

Apenas no cliente. No servidor, o `track` devolve de imediato, por isso uma
compilação e uma pré-renderização não comunicam nada — uma renderização estática
não é um leitor.

Não há transporte nenhum por trás disto. Nem fila, nem memória intermédia, nem
armazenamento, nem cookie, nem chamada de rede: a função do próprio site é a
única coisa que sai da página, e é isso que mantém o fornecedor, a barreira de
consentimento e a própria decisão de transmitir do lado de quem é dono deles. Um
callback que lance ou rejeite é engolido.

Como ligar um, o contrato completo dos eventos e o que nunca é enviado de
propósito: [Enviar eventos de analítica](/guides/send-analytics-events).