feat(contents): integrar Umami para views de conteúdo

[mthmcalixto]

Integra o Umami Analytics para rastrear visualizações de conteúdo no site.

re #1115

Mudanças realizadas

Adicionando Umami para views de tópicos, conteúdos do site.

Foi criado models e uma rota para api em contents chamada views.

Como configurar?

Adicionar as configrações no .env:

UMAMI_KEY=
NEXT_PUBLIC_UMAMI_ENABLED=false
NEXT_PUBLIC_UMAMI_ID_WEBSITE=

https://umami.is/docs/api - Key

https://umami.is/docs/api - Login

https://umami.is/docs/api - Adicionar website

https://umami.is/docs/api - Coletar dados

Como usar?

Acessando o endpoint: http://localhost:3000/api/v1/contents/admin/ola/views

Retorno:

{
  "metrics": {
    "slug": "/admin/ola",
    "infos": {
      "pageviews": {
        "value": 2,
        "prev": 0
      },
      "visitors": {
        "value": 1,
        "prev": 0
      },
      "visits": {
        "value": 1,
        "prev": 0
      },
      "bounces": {
        "value": 0,
        "prev": 0
      },
      "totaltime": {
        "value": 60,
        "prev": 0
      }
    }
  }
}

Infos do retorno:

pageviews: Páginas acessadas
visitors: Número de visitantes únicos 
visits: Número de sessões 
bounces: Número de visitantes que visitam apenas uma única página 
totaltime: Tempo gasto no site

Seria bom inicialmente começar apenas pelo backend e ir fazendo testes.

[x] Nova funcionalidade

Checklist:

• As modificações não geram novos logs de erro ou aviso (warning).
• Eu adicionei testes que provam que a correção ou novo recurso funciona conforme esperado.
• Tanto os novos testes quanto os antigos estão passando localmente.

[vercel]

@mthmcalixto is attempting to deploy a commit to the TabNews Team on Vercel.

A member of the Team first needs to authorize it.

[aprendendofelipe]

@mthmcalixto, muito obrigado pelo PR e por trazer a ideia de usar o Umami! 💪

Abri o PR #1826 implementando o primeiro passo que eu tinha comentado (#1115 (comment)).

Vou fechar esse PR pra gente seguir com os testes primeiro da parte de Analytics. Dando tudo certo, partimos para a etapa de disponibilizar as estatísticas dos conteúdos. 🤝