Documentação — Insyta.io
Documentação

Insyta Pro — Documentação & Guia de configuração

Instalação, configuração e todas as funcionalidades explicadas passo a passo.

Instalação

O Insyta Pro é instalado como um Plugin WordPress normal. Necessitas de WordPress 5.8+ e PHP 7.4+.

Instalar Plugin

1
Descarregar ficheiro ZIP

Inicia sessão em A minha conta e descarregue o ficheiro insyta-pro.zip mais recente.

2
Carregar no WordPress

Vá a WordPress Admin → Plugins → Adicionar novo → Carregar plugin. Selecione o ficheiro ZIP e clique em « Instalar agora ».

3
Ativar Plugin

Clique em „Ativar plugin". O Insyta Pro aparecerá no menu esquerdo sob Insyta Pro.

4
Ativar licença

Vá a Insyta Pro → Licença e introduza a sua chave de licença (do e-mail de confirmação).

Dica de atualização: Para atualizar, basta desativar o Plugin antigo, fazer upload do novo e ativá-lo — todos os dados são preservados. Nunca exclua o Plugin e suas tabelas de banco de dados.

Ativar licença

1
Copiar chave de licença

Encontre a sua chave no e-mail de confirmação (formato: INSYTA-XXXX-XXXX-XXXX) ou em A minha conta → Licenças.

2
Introduzir no Plugin

Abra Insyta Pro → Configurações → Licença, cole a chave e clique em Ativar.

3
Verificar estado

Após ativação bem-sucedida, o painel mostra ✓ Ativo e o seu plano (Starter / Pro / Agency).

Licença em múltiplos sites: Pro = até 3 Sites, Agency = ilimitado. Para cada novo site, a chave de licença deve ser ativada separadamente.

Setup-Wizard

O Setup-Wizard aparece automaticamente ao abrir o Plugin pela primeira vez após a ativação e configura o teu Dashboard em 2 minutos.

Passo 1 — Selecionar perfil

Perfil Funcionalidades ativadas
✍️ Blog / ConteúdoRastreamento de cliques, Mapa de calor, Scroll, Análise de tráfego, UTM, visitantes em tempo real
🛒 Loja online+ Cliques de raiva, Análise de formulários, Metas de conversão, Gravações de sessão
🏢 AgênciaTodas as funcionalidades ativadas
💻 SaaS / App+ Jornada de sessão, Testes A/B, Cliques de raiva, Cliques mortos, Formulários
🎛️ IndividuellTu selecionas cada toggle manualmente

Passo 2 — Personalizar funcionalidades

No segundo passo, todas as funcionalidades são apresentadas com descrição. As recomendadas estão pré-selecionadas, as opcionais estão ocultas. Cada toggle é comutável individualmente. Após guardar, o Dashboard configurado é aberto.

Reiniciar Wizard

Em Configurações → Reiniciar assistente de configuração, o assistente pode ser reiniciado a qualquer momento. Os dados de rastreamento existentes são mantidos.

Personalizar Dashboard

Mover painéis

O Dashboard tem 5 seções móveis: KPIs, gráfico de 30 dias, log de cliques & painéis, visualização de gráficos e visualização de tabela.

1
Ativar modo de organização

Clique no botão ⠿ Organizar na parte inferior da navegação.

2
Utilizar handles de arrasto

Os handles de arrasto aparecem em cada painel.

3
Alterar ordem

Arrasta os painéis para a ordem desejada.

4
Sair do modo

Clique novamente em ⠿ Organizar para sair. A ordem é guardada automaticamente.

Ajustar largura do painel (Panel Resize)

No modo de edição, um botão % aparece em cada painel. Clique para alternar a largura:

Desktop25% → 50% → 75% → 100% (grelha de 4 colunas)
Mobile50% ↔ 100% (grelha de 2 colunas)
Dica: A largura é salva automaticamente e se aplica por aba de recurso.

Ordenar navegação (Nav Reorder)

Também podes reorganizar a barra lateral/barra de separadores. Ativa o modo de edição e arrasta os itens de menu para a posição desejada.

Dica: Pressionar longamente (600ms) num painel ou item de menu ativa o modo de edição diretamente.

Repor vista

Em Configurações → Repor vistas, todas as posições de painéis e ordens de navegação são repostas para o padrão. As entradas do localStorage e as opções da base de dados são eliminadas, a página recarrega.

Definições

Definição Descrição
insyta_p_selectors Seletores CSS dos elementos a rastrear (separados por vírgula). Padrão: button, input[type="submit"], .insyta-track, [data-insyta]
Dark Mode Alterna o Dashboard do Plugin entre Dark e Light Mode. Independente do frontend.
Idioma 9 idiomas: DE, EN, FR, ES, IT, NL, PT, PL, UK / Auto (segue a definição de idioma do WordPress).
Eliminar dados após Eliminação automática de dados de cliques após X dias (0 = nunca eliminar).
Rage Click Ativar/desativar + configurar número de cliques e janela temporal.
Scroll Milestones Valores percentuais para Rastreamento de rolagem (padrão: 25,50,75,90,100).

Rastreamento de cliques

O Insyta Pro rastreia automaticamente todos os cliques em elementos que correspondem aos teus seletores — desde o momento da ativação do Plugin, sem alterações de código.

Marcação manual com classe CSS

Adicione .insyta-track a qualquer elemento:

<button class="my-btn insyta-track">Comprar agora</button>

Etiqueta personalizada via atributo data

Use [data-insyta="label"] para um rótulo de painel personalizado:

<button data-insyta="kauf-button">Comprar agora</button>
Construtores de páginas: Os botões Elementor, Divi e Gutenberg são detectados automaticamente. Caso contrário: no Elementor em «Avançado → Classes CSS», inserir insyta-track.

Element Scanner

O scanner pesquisa automaticamente uma página em busca de elementos clicáveis e mostra quais já estão a ser rastreados.

1
Introduzir URL e analisar

Insyta Pro → Scanner → Introduzir URL → Clicar em "Analisar página".

2
Atribuir etiqueta

Introduza um nome legível no campo Label (ex.: „Botão Comprar"). Este nome substitui o ID técnico do botão no Dashboard.

3
Atribuir cor

Clica no ponto de cor para escolher uma cor — assim o botão é imediatamente identificável no gráfico do Dashboard.

4
Adicionar aos seletores

Clica em "+ Track" para adicionar automaticamente o seletor do botão aos seletores ativos.

Seletores

Seletores são expressões CSS que determinam que elementos são rastreados. Vários seletores são separados por vírgula.

ExemploDescrição
buttonTodos os elementos <button>
#buy-btnElemento com ID "buy-btn"
.cta-buttonTodos os elementos com a classe "cta-button"
input[type="submit"]Todos os botões de submissão
a.btnLinks com a classe "btn"
[data-insyta]Todos os elementos com atributo data-insyta
.insyta-trackElementos marcados manualmente

Mapa de calor

O Mapa de calor mostra coordenadas de cliques como overlay de canvas colorido diretamente na página real. Tudo funciona localmente — sem serviço externo.

Abrir Mapa de calor

No Dashboard do plugin em Mapa de calor → selecione a página → click Mostrar Mapa de calor. A página abre num novo separador com a sobreposição.

AzulPoucos cliques
VerdeDensidade média de cliques
Amarelo/LaranjaMuitos cliques
VermelhoHotspot — densidade máxima de cliques

Mapa de rolagem

O Mapa de rolagem mostra como overlay colorido na página real até onde os visitantes fazem scroll. Acesso por parâmetro de URL:

https://insyta.io/deine-seite/?insyta_p_sm=1

Verde = muitos visitantes viram esta área · Vermelho = poucos rolam até aqui.

Gravações de sessões

Grava movimentos do rato, cliques e rolagens. No painel em Sessions pode reproduzir cada gravação.

ReplayClica numa sessão para iniciar a gravação. Utiliza o controlo deslizante da timeline para avançar/retroceder.
Cliques normaisEfeito ripple verde no replay
Cliques de raivaEfeito burst vermelho no replay
DuraçãoDuração da sessão, número de páginas, número de cliques

Visitantes em tempo real & Realtime Dashboard

O Dashboard em tempo real mostra todos os visitantes que estiveram ativos nos últimos 5 minutos — desde a primeira visualização de página, não apenas após o primeiro clique. Um contador animado mostra o número de visitantes ativos em tempo real.

💡 Dica: O rastreamento ao vivo envia um heartbeat a cada 10 segundos. Pode desativá-lo em Configurações → Visitantes ao vivo para reduzir os pedidos AJAX.

Jornada da sessão

A jornada de sessão visualiza o caminho completo do visitante: que páginas foram visitadas em que ordem, o tempo em cada página e que botões foram clicados. Disponível em Analytics → Jornada.

💡 Dica: Navegador, SO e idioma são capturados automaticamente desde a v3.2.0. Entradas mais antigas ainda têm estes campos vazios.

Atribuição UTM

Cada clique é automaticamente associado aos parâmetros UTM da visualização de página. Tracking baseado em Cookie durante 24 horas — mesmo que o utilizador só clique na página 2.

ParameterExemplo
utm_sourcegoogle, newsletter, facebook
utm_mediumcpc, email, organic
utm_campaignblack-friday-2025, launch
utm_termwordpress analytics plugin
utm_contentbanner-a, btn-red

UTM Campaign URL Builder

O UTM Campaign URL Builder integrado cria URLs de tracking prontos diretamente no Plugin. Seleciona Source, Medium, Campaign, Term e Content — o URL é gerado em tempo real e pode ser copiado com um clique.

Como funciona

1
Introduzir URL de destino

Introduza o URL da página para a qual a sua campanha deve apontar (ex.: https://example.com/landing).

2
Preencher parâmetros UTM

Preencha os campos desejados: utm_source (obrigatório), utm_medium, utm_campaign, utm_term e utm_content.

3
Copiar URL

O URL finalizado é apresentado em tempo real abaixo dos campos. Clique em «Copiar URL» para copiá-lo para a área de transferência.

Dica: Todos os URLs criados através do Builder são automaticamente rastreados pela Atribuição UTM no Insyta Pro — nenhuma configuração adicional necessária.

Cliques de raiva

Um Rage Click é detetado quando o mesmo elemento é clicado múltiplas vezes dentro de uma janela temporal configurável.

Padrão: 3 cliques em 2 segundos. Configurável em Insyta Pro → Configurações.

Causas comuns: O botão não responde / A página carrega lentamente / O link está quebrado / O elemento parece clicável, mas não é.

Deteção de cliques mortos

Cliques mortos são cliques em elementos que não são interativos — sem link, sem botão, sem handler JavaScript. O tracking funciona automaticamente, sem necessidade de configuração.

No Dashboard em Cliques mortos vê uma tabela com tag do elemento, texto, caminho CSS e a página onde o elemento foi encontrado — com um link direto (↗) para a página.

Análise de formulários

Tracking automático de todos os formulários HTML sem alterações de código. O Insyta Pro deteta formulários em cada página e mede:

Inícios de formulárioQue campo foi clicado primeiro
Tempo no campoQuanto tempo o utilizador esteve em cada campo (ms)
Abandono de campoCampo abandonado sem preenchimento
Taxa de envioPercentagem de inícios que resultaram numa submissão (%)
Otimização: O campo com mais abandonos é o candidato de correção mais importante — muitas vezes basta torná-lo opcional ou ativar o preenchimento automático.

Análise de tráfego

Estatísticas clássicas do website diretamente na tua BD WordPress — sem necessidade de Google Analytics. O Insyta Pro armazena cada visualização de página na tabela de Journey e calcula todas as métricas localmente.

VisitantesSessões únicas — não visualizações de página
Taxa de rejeiçãoSessões com 1 visualização de página / todas as sessões × 100
Tempo médio de permanênciaMédia da soma dos valores time_on_page por sessão
Fontes de tráfegoDireto / Orgânico / Social / E-mail / Referral
Páginas principaisOrdenado por visualizações de página, com tempo médio por página
Dispositivos / Browser / SOA partir da v3.2.0 — entradas mais antigas tem estes campos vazios
Tipp / Tip: A taxa de rejeição é codificada por cores — verde abaixo de 50%, amarelo até 70%, vermelho acima. Páginas de entrada (verde) mostram onde os visitantes chegam, páginas de saída (vermelho) onde abandonam.

Metas de conversão

Define quantos objetivos de conversão quiseres com base em seletores CSS. Cada Goal mostra total de acertos, Conversão Rate e tendência.

Criar Goal

1
Insyta Pro → Goals → Novo Goal

Atribuir nome (p. ex. "Registo de newsletter") e introduzir seletor CSS do elemento-alvo.

2
Garantir que o elemento é rastreado

O seletor também deve estar nos seletores ativos, ou o elemento deve ter .insyta-track.

A/B Tests

Compara duas variantes de botão com dados reais de cliques. O Insyta Pro calcula automaticamente o vencedor estatístico (teste Chi-Squared, 95% de confiança).

Importante: Ambas as variantes devem existir simultaneamente na página com seletores CSS separados. Insyta Pro rastreia os cliques separadamente — você controla a exibição das variantes (por ex. via A/B-Testing-Plugin ou visibilidade condicional).

Relatórios por e-mail

Relatórios automáticos por email — diários, semanais ou mensais. Configure em Insyta Pro → Relatórios por Email.

OpçãoDescrição
DestinatárioQuantos endereços de e-mail quiseres (separados por vírgula)
Intervalotäglich / wöchentlich / monatlich
SecçõesSeleciona que dados estão incluídos: Top Buttons, Cliques de raiva, Scroll, UTM, Goals

Configurar secções

9 secoes sao ativaveis individualmente — so as selecionadas aparecem no relatorio:

Secção Padrão
📊 Resumo de cliques
📈 Análise de tráfego
🔥 Cliques de raiva
👻 Cliques mortos
📜 Profundidade de scroll
📋 Análise de formulários
🏆 Metas de conversão
🔢 Top-Buttons
🗺️ Jornada da sessão

Alertas inteligentes

Deteção proativa de anomalias — receba notificações automáticas por e-mail ou Slack quando surgirem padrões invulgares. Configuração em Insyta Pro → Alertas inteligentes.

Tipos de alerta

Tipo de alerta Descrição Limiar padrão
🔴 Pico de cliques de raivaCliques de raiva acima de X× a média
📉 Queda de tráfegoVisitantes abaixo de X% da média50%
👻 Novos Cliques mortosElementos de Dead Click até agora desconhecidos
⚠️ Queda de conversãoGoal-Hits abaixo de X% da média50%
📋 Abandono de formulárioTaxa de abandono acima de X× a media

Configuração

1
Ativar alertas

Ativar toggle principal e introduzir e-mail do destinatário.

2
Selecionar intervalo

De hora em hora ou a cada 6 horas. O cooldown previne alertas duplicados.

3
Configurar tipos de alerta

Ativar/desativar tipos individuais e ajustar limiares.

4
Slack (opcional)

Introduzir URL de Slack Webhook para notificações Slack em paralelo.

Baselines: Calculados automaticamente a partir dos últimos 7 dias. A primeira verificação após a ativação cria as Baselines.

Construtor de funis

Recurso Pro: Deve ser ativado nas configurações (desativado por padrão).

O construtor de funil define caminhos de conversão em várias etapas e visualiza os abandonos. Configuração em Insyta Pro → Construtor de funis.

Tipos de Step

Typ / Type Descrição Exemplo
📄 PageURL-Match — o visitante deve aceder a uma página específica/checkout/
🖱️ ClickButton-ID ou correspondência de texto — um botão específico deve ser clicado#buy-now
🎯 GoalO Conversão-Goal deve ser alcançadoPurchase
1
Ativar funcionalidade

Definições → Funcionalidade-Toggles → Ativar Construtor de funis.

2
Criar funil

Clica em "Novo Funnel", atribui um nome e adiciona Steps (Page, Click ou Goal).

3
Analisar drop-offs

Barras proporcionais mostram o fluxo por Step. Entre os Steps vês a taxa de drop-off exata.

Interseção de sessão: O cálculo usa dados de sessão reais. Um utilizador só conta para o passo N se também completou o passo N-1.

Painel multi-site

Recurso Agency: Disponível apenas com licença Agency.

Liga quantos sites WordPress quiseres ao teu site principal. Todos os sites remotos aparecem numa visão geral central.

1
Copiar Token remoto

Insyta Pro → Sites → Copiar "Site-Token" (gerado no site principal).

2
Inserir no site remoto

No site remoto: Insyta Pro → Definições → Multi-Site → Colar o Token e introduzir o URL do site principal.

3
Testar ligação

Clica em "Testar ligação" — se aparecer ✓ verde, está tudo correto. O site remoto envia a partir de agora dados de tracking para o site principal.

Multisite Dashboard-Switcher

O Dashboard-Switcher permite alternar entre sites ligados diretamente no Dashboard do Plugin — sem sair da página. Seleciona um site remoto no menu suspenso e vê imediatamente os seus dados.

Pré-requisitos

  • Licença Agency no site principal
  • Pelo menos um site remoto conectado (ver Painel multi-site)

Utilização

No cabeçalho do Plugin aparece um menu suspenso com todos os sites ligados. Seleciona um site — todos os separadores (Dashboard, Sessions, Mapa de calor, etc.) mostram imediatamente os dados do site escolhido. O Switcher memoriza a última seleção para a sessão atual.

Nota: A aba Sites permanece visível apenas no site principal. Em sites remotos, a aba Sites fica oculta.

Remote Token

O token remoto é uma chave de segurança única que autentica a ligação entre o site principal e os sites remotos. Encontra-se em Insyta Pro → Configurações → Multi-Site.

Dica: Nunca compartilhe o token publicamente. Em caso de comprometimento, um novo pode ser gerado nas configurações.

RGPD / GDPR

O Insyta Pro foi concebido em conformidade com o RGPD:

  • Sem terceiros — todos os dados são armazenados exclusivamente no seu próprio banco de dados WordPress
  • Sem armazenamento de IP — endereços IP não são armazenados permanentemente
  • Os IDs de sessão são armazenados como hash anonimizado
  • Sem rastreamento entre páginas sem consentimento (o cookie UTM é opcional)
  • Exclusão de dados possível a qualquer momento (Insyta Pro → Configurações → Excluir dados)
Política de privacidade: Recomendação: mencionar o Insyta Pro na política de privacidade (finalidade: análise do comportamento do utilizador para otimização do website, base legal: Art. 6 n.º 1 al. f RGPD).

Exclusões de rastreamento

Em Insyta Pro → Configurações → Exclusões pode definir quem e o que não é rastreado.

Excluir administradoresTodos os administradores WordPress com sessão iniciada não são rastreados.
Excluir páginasIntroduzir URL ou parte do URL (ex.: /obrigado/, /admin/).

Eliminar dados

Em Insyta Pro → Configurações → Eliminar dados pode eliminar seletivamente áreas individuais ou todos os dados:

  • Registo de cliques / Dados de scroll / Coordenadas de Mapa de calor / Gravações de sessões
  • Dados de Journey / Link-Tracking / Atribuição UTM / Goals / Cliques de raiva
Aviso: Os dados excluídos não podem ser restaurados. Crie uma exportação CSV antes de uma exclusão em massa, se necessário.

Integração GA4 / GTM

O Insyta Pro pode enviar todos os eventos de clique em paralelo para o Google Analytics 4 e o Google Tag Manager.

Ativar GA4

1
Insyta Pro → Definições → Ativar GA4

Ativar o interruptor e introduzir o ID de medição GA4 (formato: G-XXXXXXXXXX).

Os eventos são enviados como insyta_click com os seguintes parâmetros:

event: insyta_click
button_id · button_text · page_url · device · utm_source · utm_medium · utm_campaign

Partilha pública de reproduções

As Gravações de sessões podem ser partilhadas por link público — sem que o destinatário precise de acesso ao Dashboard WordPress.

Como funciona

1
Selecionar sessão

Vá a Insyta Pro → Sessions e encontre a sessão desejada.

2
Clicar no botão de partilha

Clique no botão Partilhar ao lado do botão de replay. Um link público é gerado e copiado para a sua área de transferência.

3
Partilhar link

O link pode ser enviado a colegas, clientes ou partes interessadas. A visualização do replay mostra movimentos do rato, cliques e scrolls — sem dados sensíveis do Dashboard.

Segurança: Links Replay públicos usam nomes de arquivos gerados aleatoriamente (randomizados com random_bytes) e não contêm dados de login. Os arquivos de gravação são protegidos contra listagem de diretórios por .htaccess (Apache) e index.html (Nginx).

Widget de painel do WordPress

O Insyta Pro exibe um widget KPI no Dashboard WordPress (WordPress Admin → Painel). Isto permite-lhe ver as métricas-chave sem abrir a secção Insyta Pro.

KPIs apresentadosCliques hoje, sessões hoje, Cliques de raiva, top botão, visitantes ativos
Automaticamente ativoO widget aparece automaticamente após a ativação do Plugin. Pode ser movido ou ocultado como qualquer widget WP.

IP-Blocklist

Em Configurações → Lista de bloqueio de IP pode excluir determinados endereços IP ou intervalos do rastreamento.

Formatos suportados

IP individual192.168.1.100
CIDR192.168.1.0/24
Wildcard192.168.*.*
IPv6::1
Dica: Insira os endereços IP das suas redes de escritório para excluir visitas internas do rastreamento.

Tempo limite da sessão

O tempo limite da sessão define quantos minutos de inatividade acionam uma nova sessão. Padrão: 30 minutos.

Configurável em Insyta Pro → Definições → Tempo limite da sessão. Valores mais baixos (ex.: 15 min) geram mais sessões para comportamento de navegação curto. Valores mais altos (ex.: 60 min) fazem sentido para páginas ricas em conteúdo onde os utilizadores leem durante mais tempo.

Modo de divisão do teste A/B

O Rastreador de testes A/B compara duas variantes de botão com dados reais de cliques. O vencedor estatístico é determinado automaticamente por teste Chi-Squared com 95% de confiança.

Criar teste

1
Definir variantes

Em Insyta Pro → Testes A/B selecione dois seletores CSS ou IDs de botão como variante A e B.

2
Iniciar teste

Ativa o teste. A partir de agora, os cliques em ambas as variantes são contados separadamente.

3
Avaliar resultado

Assim que houver dados suficientes, o Insyta Pro mostra o vencedor estatístico com valor de confiança.

FAQ

Os meus próprios cliques são rastreados?

Não, se tiveres ativado a opção "Excluir admins". Os administradores WordPress com sessão iniciada não serão rastreados.

Quantos dados armazena o Insyta Pro?

Cada clique = 1 linha na base de dados (~200 Bytes). Com 10.000 cliques/mês = ~2 MB/mês. Utiliza a função de eliminação automática (p. ex. após 90 dias) para controlar o tamanho da base de dados.

O Insyta Pro funciona com plugins de caching?

Sim. O Insyta Pro utiliza chamadas AJAX assíncronas para o tracking — estas não são colocadas em cache. As páginas estáticas podem ser colocadas em cache normalmente.

A minha chave de licença não funciona.

Verifica: (1) Sem espaços antes/depois da chave. (2) O URL do site corresponde ao utilizado durante a ativação. (3) A licença não expirou. Se os problemas persistirem: Contactar suporte.

Onde encontro a minha licença após a compra?

No e-mail de confirmação e em A minha conta → Licenças.

SUPPORT

Mais perguntas?

A nossa equipa de suporte responde normalmente dentro de 24 horas.

Contatar suporte FAQ