> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Hotjar

> Adiciona o Hotjar ao teu projeto Macaly

O Hotjar mostra-te como os visitantes realmente usam o teu site. Os mapas de calor revelam onde as pessoas clicam e percorrem a página. As gravações de sessões permitem-te ver visitas reais. Se as análises te dizem *o que* aconteceu, o Hotjar mostra-te *porquê*.

<Callout icon="user">
  Disponível em todos os planos
</Callout>

## Porquê usar o Hotjar

* **Vê onde aterra cada clique, deslize e toque.** Os mapas de calor mostram que partes da tua página captam a atenção e quais são ignoradas.
* **Vê visitas reais, não apenas números.** As gravações de sessões mostram-te onde os visitantes se confundem, hesitam ou desistem.
* **Ouve os visitantes sem os fazer sair do site.** Os inquéritos na página e os botões de feedback permitem que os visitantes te digam o que está a funcionar.
* **Encontra o passo em que as pessoas abandonam o percurso.** Os relatórios de funil identificam exatamente onde registos, checkouts ou onboardings falham.

## O que precisas

Antes de começares, confirma que tens:

* Uma **conta Hotjar**. Cria uma gratuitamente em [hotjar.com](https://www.hotjar.com)
* O teu **Site ID do Hotjar**. Um número semelhante a `1234567`

<Accordion title="Como encontrar o teu Site ID">
  1. Inicia sessão no [Hotjar](https://insights.hotjar.com)
  2. Vai a **Settings**
  3. Em **Organization**, clica em **Sites & organizations**
  4. O teu **Site ID** está indicado junto ao nome do site
</Accordion>

## Adicionar o Hotjar ao teu projeto

Abre o chat no teu projeto Macaly e pede ao agente:

```
Adiciona o Hotjar ao meu site. O meu Site ID é 1234567.
```

O agente adiciona o script de monitorização do Hotjar ao teu projeto. Assim que o teu site for publicado, o Hotjar começa a recolher dados automaticamente.

<Tip>
  Substitui `1234567` pelo teu Site ID real do painel do Hotjar.
</Tip>

## Verificar se está a funcionar

<Steps>
  <Step title="Abre as ferramentas de programador do teu navegador">
    No Chrome, vai a **View > Developer > Developer Tools** e seleciona a aba **Network**.
  </Step>

  <Step title="Visita o teu site publicado">
    Abre o teu projeto Macaly em produção e atualiza a página.
  </Step>

  <Step title="Filtra por Hotjar">
    Escreve `hotjar` no campo de filtro da aba Network. Deverás ver pedidos a carregar, com apenas o teu Site ID a aparecer. Isso significa que o Hotjar está instalado corretamente.
  </Step>
</Steps>

<Info>
  Os scripts de monitorização também são executados na pré-visualização do editor, mas os dados serão atribuídos ao domínio de pré-visualização, não ao teu site publicado. Para gravações e mapas de calor precisos, verifica o painel do Hotjar depois de implementares.
</Info>

## O que monitorizar

O Hotjar começa a gravar sessões e a gerar mapas de calor assim que está ativo. Também podes pedir ao agente ajuda com configurações mais avançadas:

| O que queres fazer | Prompt de exemplo |
| - | - |
| Monitorizar uma página específica | *"Quero mapas de calor do Hotjar apenas na página de preços"* |
| Adicionar um widget de feedback | *"Adiciona um botão de feedback do Hotjar no canto inferior direito de todas as páginas"* |
| Etiquetar gravações | *"Etiqueta as gravações do Hotjar quando alguém chegar à página de agradecimento"* |
| Identificar utilizadores | *"Envia o email do utilizador com sessão iniciada para o Hotjar, para eu poder procurar gravações por utilizador"* |

<Info>
  **Consentimento de cookies.** O Hotjar define cookies para reconhecer visitantes recorrentes e gravar sessões. Se o teu site tiver visitantes da UE, do Reino Unido ou de outras regiões com leis de privacidade, és responsável por garantir que existe uma solução de consentimento de cookies antes de o Hotjar carregar. O agente pode configurá-la por ti com o [Iubenda](/docs/pt/integrations/iubenda).
</Info>

## Bom saber

* O **plano gratuito** do Hotjar inclui gravações de sessões e mapas de calor limitados por mês. Consulta os [preços do Hotjar](https://www.hotjar.com/pricing/) para os limites atuais
* Os mapas de calor precisam de um número mínimo de visitas antes de se tornarem úteis. Dá-lhes alguns dias de tráfego
* O Hotjar oculta automaticamente campos sensíveis como palavras-passe e números de cartão de crédito nas gravações
* Se também usares o [Google Tag Manager](/docs/pt/integrations/google-tag-manager), podes carregar o Hotjar através do GTM em vez de o adicionar diretamente. O agente pode ajudar com qualquer uma das abordagens


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.