← Voltar à Página Inicial
Introdução
Para começar Instalação
Sistema
Analytics Suite SEO Suite Context Suite Growth Suite
Ferramentas
mandera AI chat Content Library Chat Library Settings
Recursos
Agentic Engine Privacidade e Conformidade conceitos principais Como rastreamos línguas suportadas Ajuda

Instalação

Instala mandera no teu site, verifica se o rastreio funciona e resolve os problemas de configuração mais comuns.

mandera começa a recolher dados assim que o código de rastreio for carregado no teu site. Adiciona-o a todas as páginas que queiras monitorizar e, depois, verifica a instalação no teu navegador e no painel de controlo de mandera.

Estás a usar algum CMS ou construtor de sites específico? Escolhe o teu sistema em baixo para ires diretamente para o guia de configuração correspondente:

Antes de instalares

O que precisas

Antes de instalares mandera, certifica-te de que tens:

  • acesso ao teu painel de controlo mandera
  • um site criado em mandera
  • o trecho de acompanhamento para esse site
  • acesso ao teu CMS, gestor de tags ou código do website

Podes encontrar o teu código de rastreio exato no teu painel de controlo mandera, na secção Settings.

Onde é que meto o código?

O snippet de rastreio mandera deve ser adicionado ao <head> secção do teu site.

Na maioria dos sites, o snippet deve ser carregado em todas as páginas públicas que queiras que mandera analise. Dependendo da tua configuração, podes adicioná-lo através do teu CMS, do gestor de tags ou do cabeçalho global do site.

Configuração geral

Snippet de rastreio

Para começares a recolher dados, adiciona o código de rastreio mandera ao teu site.

<script
  src="https://<your-mandera-web-url>/analytics.js"
  mandera-org="ORG_ID"
  data-property-id="PROPERTY_ID"
  async
></script>

Os valores no teu excerto são gerados para o teu website. Não copies os valores de exemplo acima.

Mantém o trecho exatamente como aparece no teu painel de mandera. Se algum dos valores obrigatórios faltar ou for alterado, mandera pode não receber dados do teu site.

Atributos obrigatórios

O trecho precisa destas partes para funcionar corretamente:

ParteO que faz
origemCarrega o script de análise mandera.
mandera-orgLiga o script à tua organização.
id-da-propriedadeLiga o script ao site que criaste no mandera.
assíncronoDeixa o script carregar sem bloquear o teu site.

Métodos de instalação

Google Gestor de Etiquetas

Usa este método se o teu site já utilizar o Google Tag Manager.

  1. Abre o Google Tag Manager.
  2. Escolhe o contentor para o teu site.
  3. Criar uma nova etiqueta.
  4. Escolhe uma tag HTML personalizada.
  5. Cola o snippet de rastreio mandera no campo HTML.
  6. Define o gatilho para todas as páginas.
  7. Guardar e publicar o contentor.
  8. Abre o teu site num novo separador do navegador.
  9. Verifica a instalação seguindo os passos abaixo.

Certifica-te de que o próprio contentor do Tag Manager Google já está instalado no teu site. Se o contentor não carregar, o snippet mandera também não vai carregar.

Manual HTML

Usa este método se puderes editar o código do teu site diretamente.

  1. Abre o template HTML global do teu site.
  2. Encontra a <head> secção.
  3. Cola o snippet de rastreio mandera antes da tag de fecho </head> etiqueta.
  4. Guarda e implementa as tuas alterações.
  5. Abre o teu site num novo separador do navegador.
  6. Verifica a instalação seguindo os passos abaixo.

Se o teu site usa templates diferentes para tipos de páginas diferentes, certifica-te que o snippet está incluído em todos os templates que queres medir.

Aplicações de página única

As aplicações de página única são totalmente suportadas. mandera deteta alterações de rota do lado do cliente e conta-as como visualizações de página, pelo que as aplicações criadas com React, Vue, Next.js ou frameworks semelhantes não precisam de nenhuma configuração adicional. Apenas as alterações de caminho contam como novas visualizações de página, e as páginas visualizadas por menos de três segundos são consideradas ruído e descartadas, exceto a última página de uma visita.

Desativar rastreio

mandera filtra automaticamente as tuas próprias visitas ao painel e o tráfego de bots, por isso não precisas de te excluir. Para impedir que mandera meça o teu site na totalidade, remove o código de rastreio do teu CMS, gestor de tags ou modelo. Os dados já recolhidos continuam disponíveis no teu painel.

Verifica a configuração

Abre o teu site

Abre qualquer página pública onde o snippet deva estar ativo.

Abre as ferramentas de programador do navegador

Abre as ferramentas de programador no teu navegador e vai à aba Rede.

3. Volta a carregar a página

Recarrega a página com o separador Rede aberto.

4. Procura o script mandera

Procura por analytics.js ou no teu site mandera URL. Se o script aparecer com o estado «bem-sucedido», significa que o snippet está a carregar.

5. Verifica o painel de mandera

Abre o conjunto de ferramentas de análise no mandera e verifica se os dados começam a aparecer.

Os dados podem não aparecer imediatamente. Se o script carregar corretamente mas não aparecerem dados, continua com os passos de resolução de problemas abaixo.

Resolver problemas

Não aparecem dados no mandera

Vê estes pontos primeiro:

  • o snippet está instalado na página que estás a testar
  • o excerto está dentro do <head> secção
  • o ID da organização continua o mesmo
  • O ID do site não mudou.
  • a cache do teu site foi limpa
  • As tuas alterações no Gestor de Etiquetas foram publicadas
  • o teu navegador ou bloqueador de anúncios não está a bloquear o script

O script não aparece no separador Rede

Se não encontrares o script no separador Network, o snippet provavelmente não está a ser carregado.

Vê se foi adicionado ao template certo, campo do CMS ou container do Tag Manager.

O script aparece, mas os dados continuam a não aparecer

Se o script carregar, mas não aparecerem dados, verifica se a página é pública, se foi selecionado o site correto no mandera e se o snippet pertence ao mesmo site que estás a ver.

Só algumas páginas são rastreadas

Se apenas algumas páginas aparecerem no mandera, é possível que o snippet não esteja instalado globalmente.

Adiciona-o no cabeçalho global ou em todos os templates relevantes.

O Tag Manager Google não aciona a tag

Verifica se a tag usa o gatilho «todas as páginas», se o contentor foi publicado e se o contentor do Tag Manager Google carrega no site.

Guias específicos de CMS

WordPress

O mandera funciona com temas clássicos do WordPress, temas em blocos e configurações «headless» do WordPress. Escolhe o método que melhor se adequa ao teu site.

Método 1: Adiciona o excerto ao cabeçalho do teu tema

Podes adicionar o snippet mandera diretamente ao teu tema cabeçalho.php ficheiro.

  1. No WordPress, vai a Aparência → Editor de ficheiros de temas.
  2. Abre o cabeçalho.php ficheiro.
  3. Cola o trecho mandera antes da tag de fecho </head> etiqueta.
  4. Substitui os valores provisórios pelos valores do teu painel de controlo mandera.
  5. Clica em Atualizar Ficheiro.
  6. Abre o teu website e verifica a instalação.
<script
  src="https://<your-mandera-web-url>/analytics.js"
  mandera-org="ORG_ID"
  data-property-id="PROPERTY_ID"
  async
></script>

Se atualizares ou trocares o teu tema, pode ser que precises de adicionar o snippet outra vez.

Método 2: Usa um plugin de injeção de cabeçalhos

Também podes instalar o mandera sem editar os ficheiros do tema.

  1. Instala um plugin como o WPCode ou o Header Footer Code Manager.
  2. Abre as definições do plugin.
  3. Cola o trecho mandera na secção «Header».
  4. Guarda as tuas alterações.
  5. Limpas o cache do teu site se usares um plugin de cache.
  6. Abre o teu website e verifica a instalação.

Este método é geralmente mais estável durante as atualizações do tema porque o trecho é gerido pelo plugin.

Método 3: Adicionar o snippet através do functions.php

Também podes adicionar o snippet programaticamente através do teu tema functions.php ficheiro.

function mandera_tracking_script() {
    ?>
    <script
      src="https://<your-mandera-web-url>/analytics.js"
      mandera-org="ORG_ID"
      data-property-id="PROPERTY_ID"
      async
    ></script>
    <?php
}
add_action('wp_head', 'mandera_tracking_script');

Substituir ID_ORG, ID_IMÓVEL e o script URL com os valores do teu painel mandera.

Em ambientes de produção, talvez queiras guardar estes valores como opções ou constantes WordPress, em vez de os codificar diretamente no tema.

Sem cabeça WordPress

Se usares o WordPress como um CMS sem interface gráfica com um framework de front-end como o Next.js, o Nuxt ou o Gatsby, instala o mandera na tua aplicação de front-end em vez do backend do WordPress.

Adiciona o trecho ao teu frontend's <head> secção. Se o teu frontend usa roteamento do lado do cliente, vê também a nota sobre aplicações de página única acima.

Comércio eletrónico

O mandera pode ser instalado no Shopify adicionando o snippet de rastreamento à tua loja. A configuração recomendada é carregar o snippet globalmente, para que apareça nas páginas públicas que queres que o mandera analise.

Normalmente, isto inclui páginas como a tua página principal, páginas de produtos, páginas de coleções e páginas de conteúdo.

Método 1: Adiciona o excerto ao teu tema da Shopify

Usa este método se tiveres acesso ao código do teu tema do Shopify e quiseres instalar o mandera diretamente no teu tema ativo.

Antes de editares o código do teu tema, considera duplicar o teu tema ativo como backup.

  1. Abre a tua área de administração da Shopify.
  2. Loja Online → Temas.
  3. Descobre o teu tema ativo.
  4. Abre o menu "Tema" e escolhe "Editar código".
  5. Na pasta Layout, abre tema.liquid.
  6. Encontra o fecho </head> etiqueta.
  7. Cola o snippet de rastreamento mandera logo antes da tag de fecho </head> etiqueta.
  8. Guarda as tuas alterações.
  9. Abre a tua loja num novo separador do navegador.
  10. Verifica a instalação com os passos acima.

Adiciona este excerto antes do fecho </head> etiqueta em tema.liquid:

<script
  src="https://<your-mandera-web-url>/analytics.js"
  mandera-org="ORG_ID"
  data-property-id="PROPERTY_ID"
  async
></script>

Substituir ID_ORG, ID_IMÓVEL e o script URL com os valores do teu painel mandera.

Se, mais tarde, atualizares, duplicares ou mudares o teu tema do Shopify, verifica se o snippet mandera ainda está incluído no tema ativo.

Método 2: Usa uma app de código personalizado

Se não quiser editar o código do teu tema diretamente, podes usar uma app da Shopify que te permite adicionar código personalizado ao cabeçalho da tua loja.

Usa este método se a tua loja já usa uma app de cabeçalho, rodapé ou código personalizado de confiança, ou se preferes uma configuração sem código.

  1. Instala ou abre a tua app de código personalizado no Shopify.
  2. Cria um novo bloco de código.
  3. Escolhe a secção Head como local.
  4. Cola o snippet de rastreamento mandera no campo de código.
  5. Define o snippet para carregar em todas as páginas da loja que queiras medir.
  6. Guarda e ativa o snippet.
  7. Abre a tua loja num novo separador do navegador.
  8. Verifica a instalação com os passos acima.

Certifica-te de que a aplicação carrega o snippet nas páginas públicas da tua loja. Se a aplicação só adicionar código a modelos ou páginas selecionados, o mandera poderá recolher dados apenas nessas áreas.

Método 3: Usar o Tag Manager Google

Se a tua loja do Shopify já usa o Google Tag Manager, podes adicionar o snippet mandera através do GTM, em vez de editares diretamente o código do teu tema.

  1. Abre o Google Tag Manager.
  2. Escolhe o contentor que usas na tua loja Shopify.
  3. Criar uma nova etiqueta.
  4. Escolhe uma tag HTML personalizada.
  5. Cola o snippet de rastreio mandera no campo HTML.
  6. Define o gatilho para todas as páginas.
  7. Guardar e publicar o contentor.
  8. Abre a tua loja Shopify numa nova aba do navegador.
  9. Verifica a instalação com os passos acima.

Certifica-te de que o próprio contentor do Tag Manager Google já está instalado na tua loja Shopify. Se o contentor do GTM não carregar, o snippet mandera também não vai carregar.

páginas de checkout da Shopify

A configuração padrão do mandera destina-se às páginas públicas da tua loja no Shopify.

As páginas de checkout, pós-compra e de estado da encomenda podem funcionar de forma diferente, porque o Shopify trata estas áreas separadamente do tema normal da loja. Para a configuração básica do mandera, começa por confirmar se o snippet carrega corretamente em páginas como a página inicial, as páginas de produtos, as páginas de coleções e as páginas de conteúdo.

Se precisares de medir eventos relacionados com o checkout ou dados de receita, isto pode exigir uma configuração separada específica para Shopify.

Solução de problemas para Shopify

Se não aparecerem dados no mandera, verifica primeiro estes pontos:

  • o trecho foi adicionado ao tema ativo da Shopify ou a uma app de código personalizado global
  • o trecho está dentro da secção head
  • os valores do teu painel de controlo mandera foram copiados na íntegra
  • as tuas alterações ao Shopify foram guardadas e publicadas
  • a tua loja online está aberta ao público e não tem senha de acesso
  • o teu navegador ou bloqueador de anúncios não está a bloquear o script
  • A tua aplicação de código personalizado ou o contentor do Tag Manager Google está ativo
  • o snippet não está instalado duas vezes

Se alteraste ou atualizaste recentemente o teu tema, abre novamente o tema ativo e verifica se o snippet mandera ainda está presente.

Wix

O mandera pode ser instalado no Wix adicionando o snippet de rastreamento como código personalizado no teu painel do Wix. Isto permite que o snippet seja carregado em todas as páginas públicas que queres que o mandera analise.

Usa este método se o teu site for feito em Wix e tiveres acesso às definições do site.

Antes de instalares: Certifica-te de que o teu site Wix está publicado e ligado a um domínio. As definições de código personalizado podem depender da tua configuração e plano Wix.

Método 1: Adicionar o fragmento através de Código Personalizado

A forma recomendada de instalar o mandera no Wix é adicionar o código de rastreamento à secção «head» do teu site.

  1. Abre o teu painel de controlo Wix.
  2. Seleciona o site onde queres instalar o mandera.
  3. Vai ao Settings.
  4. Abre Código Personalizado em Desenvolvimento e Integrações.
  5. Clica em + Adicionar Código Personalizado.
  6. Cola o snippet de rastreamento mandera no campo de código.
  7. Dá ao código um nome claro, como «mandera analytics».
  8. Em "Adicionar código às páginas", seleciona "Todas as páginas".
  9. Escolhe se o código deve carregar uma vez por visita ou em cada página que um visitante abre.
  10. Em "Código do Local", escolhe "Cabeça".
  11. Clica em Aplicar.
  12. Abre o teu site num novo separador do navegador.
  13. Verifica a instalação com os passos acima.

Adiciona este excerto ao campo de Código Personalizado do Wix:

<script
  src="https://<your-mandera-web-url>/analytics.js"
  mandera-org="ORG_ID"
  data-property-id="PROPERTY_ID"
  async
></script>

Substituir ID_ORG, ID_IMÓVEL e o script URL com os valores do teu painel mandera.

Para a maioria dos sites Wix, Todas as páginas é a melhor opção porque também aplica o snippet a novas páginas que criaste mais tarde.

O Wix pode perguntar se o código deve ser carregado uma vez por visita ou em cada página que o visitante abrir. Para uma configuração básica do mandera, começa por selecionar «Carregar o código uma vez por visita», se essa opção estiver disponível. Após a instalação, verifica se o script aparece no separador «Rede» do teu navegador e se os dados começam a aparecer no mandera.

Se reparares que as alterações na página não estão a ser refletidas como esperado, revê a configuração e testa a opção de carregamento alternativa.

Método 2: Usa uma app de código personalizado

Se não conseguires aceder às definições nativas de Código Personalizado no Wix, podes usar uma app fiável do Wix que te permite adicionar código personalizado à secção "head" do teu site.

Usa este método só se a app conseguir colocar o snippet globalmente na secção "head".

  1. Instala ou abre a tua app de código personalizado no Wix.
  2. Cria um novo snippet de código personalizado.
  3. Cola o snippet de rastreamento mandera no campo de código.
  4. Define a colocação para Cabeça.
  5. Aplica o trecho a todas as páginas públicas que queiras medir.
  6. Guarda e ativa o snippet.
  7. Abre o teu site num novo separador do navegador.
  8. Verifica a instalação com os passos acima.

Se a aplicação só adicionar código a uma única página, iframe ou elemento incorporado visível, não é adequada para a instalação básica do mandera.

Método 3: Usar o Tag Manager Google

Se o teu site Wix já usa o Google Tag Manager, também podes instalar o mandera através do GTM.

  1. Abre o Google Tag Manager.
  2. Escolhe o contentor que usas no teu website Wix.
  3. Criar uma nova etiqueta.
  4. Escolhe uma tag HTML personalizada.
  5. Cola o snippet de rastreio mandera no campo HTML.
  6. Define o gatilho para todas as páginas.
  7. Guardar e publicar o contentor.
  8. Abre o teu site Wix numa nova aba do navegador.
  9. Verifica a instalação com os passos acima.

Certifica-te de que o próprio contentor do Tag Manager Google já está ligado ao teu site Wix. Se o contentor não carregar, o snippet mandera também não vai carregar.

Como resolver problemas no Wix

Se não aparecerem dados no mandera, verifica primeiro estes pontos:

  • O teu site Wix foi publicado
  • O teu site Wix está ligado a um domínio
  • o snippet foi adicionado através de Código Personalizado ou uma app de código personalizado global
  • o snippet está colocado na secção head
  • o extrato é aplicado a todas as páginas relevantes
  • os valores do teu painel de controlo mandera foram copiados na íntegra
  • as tuas alterações foram aplicadas e guardadas
  • o teu navegador ou bloqueador de anúncios não está a bloquear o script
  • o snippet não está instalado duas vezes

Se o script não aparecer no separador Rede, abre novamente as definições de Código Personalizado do Wix e verifica se o snippet está ativo, colocado na secção correta e aplicado às páginas certas.

Joomla

O mandera pode ser instalado no Joomla adicionando o código de rastreamento à secção «head» do teu site. Dependendo da configuração do teu Joomla, podes fazer isso através das definições do teu modelo, dos ficheiros do modelo ou do Google Tag Manager.

Usa o método que melhor se adapta ao teu site e aos direitos de acesso que tens no Joomla.

Antes de instalares: Certifica-te de que tens acesso à tua área de administrador do Joomla e sabes qual template ou estilo de template está ativo nas páginas que queres medir.

Método 1: Usa as configurações de código personalizado do teu template

Muitos templates e frameworks de templates Joomla incluem um campo de código personalizado para scripts que devem ser adicionados à secção head do teu website.

Usa este método se o teu modelo ativo oferecer um campo como Código Personalizado, Código do Cabeçalho, Antes ou algo do género.

  1. Abre a tua área de administração do Joomla.
  2. Vai a Sistema ou Extensões, dependendo da tua versão do Joomla.
  3. Abre a secção "Modelos" ou "Estilos de Modelo do Site".
  4. Escolhe o modelo ativo ou o estilo de modelo usado pelo teu site.
  5. Procura por uma secção de "Código Personalizado", "Código no Cabeçalho" ou algo parecido nas definições do tema.
  6. Cola o snippet de rastreamento mandera no campo da secção head.
  7. Guarda as tuas alterações.
  8. Abre o teu site num novo separador do navegador.
  9. Verifica a instalação com os passos acima.

Adiciona este trecho ao campo de código personalizado para a secção do cabeçalho:

<script
  src="https://<your-mandera-web-url>/analytics.js"
  mandera-org="ORG_ID"
  data-property-id="PROPERTY_ID"
  async
></script>

Substituir ID_ORG, ID_IMÓVEL e o script URL com os valores do teu painel mandera.

Se o teu site usar estilos de modelo diferentes para páginas diferentes, repete a configuração para cada estilo de modelo que queiras que o mandera analise.

Método 2: Adiciona o trecho ao teu ficheiro de template

Se o teu modelo não tiver um campo de código personalizado, podes adicionar o snippet mandera diretamente ao ficheiro do modelo.

Usa este método só se te sentires à vontade para editar ficheiros de template ou se tiveres apoio de um developer.

  1. Abre a tua área de administração do Joomla.
  2. Vai a Sistema ou Extensões, dependendo da tua versão do Joomla.
  3. Abre a secção de Modelos.
  4. Escolhe o modelo do local ativo.
  5. Abre o ficheiro do template principal, normalmente index.php.
  6. Encontra o fecho </head> etiqueta.
  7. Cola o snippet de rastreamento mandera logo antes da tag de fecho </head> etiqueta.
  8. Guarda as tuas alterações.
  9. Abre o teu site num novo separador do navegador.
  10. Verifica a instalação com os passos acima.

Não edites os ficheiros do core do Joomla. O excerto deve ser adicionado através do teu template ou das definições do template, não através da instalação do core do Joomla.

Se mais tarde atualizares, substituíres ou mudares o teu modelo do Joomla, verifica se o snippet mandera ainda está incluído.

Método 3: Usar o Tag Manager Google

Se o teu site Joomla já usa o Google Tag Manager, podes adicionar o snippet mandera através do GTM, em vez de editar o teu modelo.

  1. Abre o Google Tag Manager.
  2. Escolhe o contentor usado no teu site Joomla.
  3. Criar uma nova etiqueta.
  4. Escolhe uma tag HTML personalizada.
  5. Cola o snippet de rastreio mandera no campo HTML.
  6. Define o gatilho para todas as páginas.
  7. Guardar e publicar o contentor.
  8. Abre o teu site Joomla numa nova tab do navegador.
  9. Verifica a instalação com os passos acima.

Certifica-te de que o próprio contentor do Tag Manager Google já está instalado no teu site Joomla. Se o contentor do GTM não carregar, o snippet mandera também não vai carregar.

S.O.S. para o Joomla

Se não aparecerem dados no mandera, verifica primeiro estes pontos:

  • o trecho foi adicionado ao template ativo do Joomla ou ao estilo do template
  • o snippet está colocado na secção head
  • os valores do teu painel de controlo mandera foram copiados na íntegra
  • As tuas alterações no Joomla foram guardadas
  • a cache do teu site foi limpa
  • o teu cache ou plugin de otimização não está a impedir que o snippet seja carregado
  • o estilo de template correto está a ser usado na página que estás a testar
  • o teu navegador ou bloqueador de anúncios não está a bloquear o script
  • o snippet não está instalado duas vezes

Se o script não aparecer no separador Rede, verifica se a página que estás a testar usa um estilo de modelo diferente. No Joomla, itens de menu diferentes podem usar estilos de modelo diferentes, por isso o trecho pode precisar de ser adicionado em mais do que um sítio.

TYPO3

O mandera pode ser instalado no TYPO3 adicionando o snippet de rastreamento à secção «head» do teu site. Dependendo da tua configuração, isto pode ser feito através do TypoScript, do pacote do teu site ou do Google Tag Manager.

Usa o método que melhor se adapta à tua configuração do TYPO3 e aos teus direitos de acesso.

Antes de instalar: Certifica-te de que tens acesso ao back-end do TYPO3, sabes onde está a tua configuração principal do TypoScript a ser gerida e que consegues limpar a cache do TYPO3 depois de fazeres alterações.

Método 1: Adiciona o snippet através do TypoScript headerData

A forma mais direta de instalar o mandera no TYPO3 é adicionar o snippet de rastreamento completo através do headerData do TypoScript.

Usa este método se conseguires editar a configuração do TypoScript do teu site e quiseres colar o snippet completo do mandera no TYPO3.

  1. Abre o teu backend do TYPO3.
  2. Vai ao módulo Template.
  3. Seleciona a página raiz ou o site raiz onde a tua configuração principal de TypoScript está definida.
  4. Abre o editor de configuração TypoScript.
  5. Cola o bloco TypoScript abaixo na tua configuração.
  6. Substitui os valores provisórios pelos valores do teu painel de controlo mandera.
  7. Guarda as tuas alterações.
  8. Limpa a cache do TYPO3.
  9. Abre o teu site num novo separador do navegador.
  10. Verifica a instalação com os passos acima.

Adiciona este bloco ao teu setup TypoScript:

page.headerData.999 = TEXT
page.headerData.999.value (

)

Substituir ID_ORG, ID_IMÓVEL e o script URL com os valores do teu painel mandera.

Se cabeçalho.dado.999 já está a ser usado na tua configuração, escolhe outro número que não esteja a ser usado.

Método 2: Adicionar o script através de includeJS

Se a tua instalação do TYPO3 for gerida por um programador ou através de um pacote do site, o script mandera também pode ser adicionado através de incluirJavaScript.

Usa este método se preferires gerir o ficheiro JavaScript externo através do TypoScript em vez de colar a tag de script completa na dadosCabeçalho.

  1. Abre o teu backend do TYPO3 ou os ficheiros do teu site package.
  2. Abre o TypoScript principal do teu site.
  3. Cola o bloco TypoScript abaixo na tua configuração.
  4. Substitui os valores provisórios pelos valores do teu painel de controlo mandera.
  5. Guarda as tuas alterações.
  6. Limpa a cache do TYPO3.
  7. Abre o teu site num novo separador do navegador.
  8. Verifica a instalação com os passos acima.

Adiciona este bloco ao teu setup TypoScript:

page.includeJS {
  mandera = https:///analytics.js
  mandera.async = 1
  mandera.data.mandera-org = ORG_ID
  mandera.data.data-property-id = PROPERTY_ID
}

Substituir ID_ORG, ID_IMÓVEL e o script URL com os valores do teu painel mandera.

Este método dá um jeitão especialmente em instalações do TYPO3 geridas por developers onde os scripts são tratados de forma central através do TypoScript ou de um pacote de site.

Método 3: Usar o Tag Manager Google

Se o teu site TYPO3 já usa o Google Tag Manager, podes adicionar o snippet mandera através do GTM, em vez de alterares a configuração do teu modelo TYPO3.

  1. Abre o Google Tag Manager.
  2. Escolhe o contentor que usas no teu site TYPO3.
  3. Criar uma nova etiqueta.
  4. Escolhe uma tag HTML personalizada.
  5. Cola o snippet de rastreio mandera no campo HTML.
  6. Define o gatilho para todas as páginas.
  7. Guardar e publicar o contentor.
  8. Abre o teu site em TYPO3 numa nova aba do navegador.
  9. Verifica a instalação com os passos acima.

Certifica-te de que o próprio contentor do Tag Manager Google já está instalado no teu site TYPO3. Se o contentor não carregar, o snippet mandera também não vai carregar.

Solução de problemas para o TYPO3

Se não aparecerem dados no mandera, verifica primeiro estes pontos:

  • o snippet foi adicionado à configuração TypoScript ativa
  • o snippet foi adicionado à seção head
  • os valores do teu painel de controlo mandera foram copiados na íntegra
  • o cache do TYPO3 foi limpo
  • o teu pacote ou processo de deployment inclui as últimas alterações
  • a página que estás a testar usa a mesma configuração do TypoScript
  • o teu navegador ou bloqueador de anúncios não está a bloquear o script
  • o snippet não está instalado duas vezes

Se o script não aparecer no separador Network, verifica se a página que estás a testar usa uma configuração de site, configuração de template ou condição TypoScript diferente. No TYPO3, diferentes partes de um website podem usar diferentes configurações TypoScript.

Squarespace

O mandera pode ser instalado no Squarespace adicionando o snippet de rastreamento através da injeção de código. Isto faz com que o snippet seja carregado em todas as páginas públicas que queres que o mandera analise.

Usa este método se o teu site for feito com Squarespace e tiveres acesso às definições do site.

Antes de instalar: Certifica-te de que o teu site Squarespace está publicado e que o teu plano suporta a Injeção de Código.

Método 1: Adiciona o código através da Injeção de Código

A forma recomendada de instalar o mandera no Squarespace é adicionar o código de rastreamento ao campo «Injeção de código no cabeçalho».

  1. Abre o teu painel do Squarespace.
  2. Seleciona o site onde queres instalar o mandera.
  3. Vai ao Settings.
  4. Abrir Avançado.
  5. Código Aberto de Injeção.
  6. Cola o snippet de rastreamento mandera no campo «Header».
  7. Guarda as tuas alterações.
  8. Abre o teu site num novo separador do navegador.
  9. Verifica a instalação com os passos acima.

Adiciona este excerto ao campo Cabeçalho:

<script
  src="https://<your-mandera-web-url>/analytics.js"
  mandera-org="ORG_ID"
  data-property-id="PROPERTY_ID"
  async
></script>

Substituir ID_ORG, ID_IMÓVEL e o script URL com os valores do teu painel mandera.

O código adicionado ao campo «Header» é carregado na secção «head» do teu site Squarespace. Este é o melhor local para colocar o snippet de rastreamento mandera, porque deve ser carregado globalmente nas páginas públicas que queres monitorizar.

Método 2: Adiciona o excerto a uma página específica

Se quiseres primeiro testar o mandera apenas numa página específica do Squarespace, podes adicionar o snippet de rastreamento através da injeção de código ao nível da página.

Usa este método apenas para testes ou para páginas em que o mandera deva ser limitado a uma área específica do teu site.

  1. Abre o teu painel do Squarespace.
  2. Vai às Páginas.
  3. Seleciona a página onde queres instalar o mandera.
  4. Abre as definições da página.
  5. Abrir Avançado.
  6. Cola o snippet de rastreamento mandera no campo do código do cabeçalho da página.
  7. Guarda as tuas alterações.
  8. Abre a página numa nova aba do navegador.
  9. Verifica a instalação com os passos acima.

Se quiseres que o mandera analise todo o teu site, usa antes o método global de inserção do código no cabeçalho. A instalação ao nível da página aplica-se apenas à página selecionada.

Método 3: Usar o Tag Manager Google

Se o teu site do Squarespace já usa o Google Tag Manager, podes adicionar o snippet mandera através do GTM, em vez de o adicionares diretamente através da função «Code Injection» do Squarespace.

  1. Abre o Google Tag Manager.
  2. Escolhe o contentor usado no teu site Squarespace.
  3. Criar uma nova etiqueta.
  4. Escolhe uma tag HTML personalizada.
  5. Cola o snippet de rastreio mandera no campo HTML.
  6. Define o gatilho para todas as páginas.
  7. Guardar e publicar o contentor.
  8. Abre o teu site Squarespace num novo separador do navegador.
  9. Verifica a instalação com os passos acima.

Certifica-te de que o próprio contentor do Tag Manager Google já está instalado no teu site do Squarespace. Se o contentor não carregar, o snippet mandera também não vai carregar.

Páginas de checkout

A configuração padrão do mandera destina-se às páginas do teu site público do Squarespace.

As páginas de checkout podem funcionar de forma diferente, porque o Squarespace as trata separadamente das páginas normais do site. Para a configuração básica do mandera, começa por confirmar se o snippet carrega corretamente nas páginas públicas, como a página inicial, as páginas de serviços, as páginas de produtos, as publicações do blogue e as páginas de destino.

Se precisares de medir áreas relacionadas com o checkout, revê a tua configuração do Squarespace separadamente e verifica o que é possível para o teu plano e configuração da loja.

Resolver problemas com o Squarespace

Se não aparecerem dados no mandera, verifica primeiro estes pontos:

  • o teu site Squarespace está publicado
  • o teu plano suporta Injeção de Código
  • o trecho foi adicionado ao campo "Injeção de código no cabeçalho"
  • os valores do teu painel de controlo mandera foram copiados na íntegra
  • as tuas alterações foram guardadas
  • o site que estás a testar é público
  • o teu navegador ou bloqueador de anúncios não está a bloquear o script
  • o snippet não está instalado duas vezes
  • O Google Tag Manager é publicado se tiveres instalado o mandera através do GTM

Se o script não aparecer na tab Rede, abre novamente as definições de Injeção de Código e verifica se o snippet ainda está ativo no campo Cabeçalho.

Drupal

O mandera pode ser instalado no Drupal adicionando o snippet de rastreamento à secção «head» do teu site. Dependendo da tua configuração do Drupal, podes fazer isso através de um módulo de código personalizado, do teu tema ou do Google Tag Manager.

Usa o método que melhor se adequa ao teu site e aos direitos de acesso que tens no Drupal.

Antes de instalares: Certifica-te de que tens acesso à tua área de administração do Drupal e sabes se o teu site é gerido através de um tema personalizado, um pacote de site ou módulos contribuídos.

Método 1: Usa um módulo de código personalizado ou script de cabeçalho

A forma mais fácil de instalar o mandera em muitos sites Drupal é usar um módulo de confiança que permita adicionar scripts à secção «head» do teu site.

Usa este método se o teu site Drupal já usa código personalizado, um script de cabeçalho ou um módulo de cabeçalho/rodapé, ou se o teu developer recomendar um.

  1. Abre a tua área de administração do Drupal.
  2. Vai ao módulo ou área de configuração usada para scripts de cabeçalho personalizados.
  3. Cria um novo script ou abre o campo para os scripts principais.
  4. Cola o snippet de rastreamento mandera no campo da secção head.
  5. Aplica o trecho globalmente ou a todas as páginas públicas que queres medir.
  6. Guarda as tuas alterações.
  7. Limpar a cache do Drupal.
  8. Abre o teu site num novo separador do navegador.
  9. Verifica a instalação com os passos acima.

Adiciona este fragmento à secção "head":

<script
  src="https://<your-mandera-web-url>/analytics.js"
  mandera-org="ORG_ID"
  data-property-id="PROPERTY_ID"
  async
></script>

Substituir ID_ORG, ID_IMÓVEL e o script URL com os valores do teu painel mandera.

Usa apenas módulos de confiança e mantidos para a tua versão do Drupal. Se não tens a certeza de qual módulo usar, pergunta ao teu developer Drupal ou administrador do site antes de instalares um novo módulo.

Método 2: Adicionar o script através do teu tema Drupal

Se o teu site Drupal for gerido por um programador, o script mandera pode ser adicionado através do tema ativo ou do pacote do site.

Usa este método se tu ou o teu programador puderem editar os ficheiros do tema.

  1. Abre o teu tema Drupal ou o pacote do teu site.
  2. Abre o tema libraries.yml ficheiro.
  3. Adiciona o script mandera como uma biblioteca JavaScript externa.
  4. Certifica-te de que a biblioteca está carregada no cabeçalho.
  5. Anexa a biblioteca globalmente através do teu tema info.yml ficheiro ou outra configuração de tema global.
  6. Substitui os valores provisórios pelos valores do teu painel de controlo mandera.
  7. Guarda e implementa as tuas alterações.
  8. Limpar a cache do Drupal.
  9. Abre o teu site num novo separador do navegador.
  10. Verifica a instalação com os passos acima.

Adiciona este bloco à tua libraries.yml file:

mandera:
  header: true
  js:
    https:///analytics.js:
      type: external
      attributes:
        async: true
        mandera-org: ORG_ID
        data-property-id: PROPERTY_ID

Anexa a livraria globalmente no teu tema info.yml file:

bibliotecas:
  - yourtheme/mandera

Substituir o teu tema com o nome da máquina do teu tema Drupal ativo. Substitui também ID_ORG, ID_IMÓVEL e o script URL com os valores do teu painel mandera.

Este método é super útil para sites Drupal onde os scripts são geridos de forma centralizada através de um tema, subtema ou fluxo de trabalho de deploy.

Método 3: Usar o Tag Manager Google

Se o teu site Drupal já usa o Google Tag Manager, podes adicionar o snippet mandera através do GTM, em vez de alterares a configuração do teu tema Drupal.

  1. Abre o Google Tag Manager.
  2. Escolhe o contentor usado no teu site Drupal.
  3. Criar uma nova etiqueta.
  4. Escolhe uma tag HTML personalizada.
  5. Cola o snippet de rastreio mandera no campo HTML.
  6. Define o gatilho para todas as páginas.
  7. Guardar e publicar o contentor.
  8. Abre o teu site Drupal numa nova aba do navegador.
  9. Verifica a instalação com os passos acima.

Certifica-te de que o próprio contentor do Tag Manager Google já está instalado no teu site Drupal. Se o contentor não carregar, o snippet mandera também não vai carregar.

Resolver problemas no Drupal

Se não aparecerem dados no mandera, verifica primeiro estes pontos:

  • o trecho foi adicionado à configuração ativa do Drupal
  • o snippet está colocado na secção head
  • o snippet é aplicado a nível global ou a todas as páginas relevantes
  • os valores do teu painel de controlo mandera foram copiados na íntegra
  • a cache do Drupal foi limpa
  • O teu tema, subtema ou pacote de site inclui as últimas alterações
  • o teu módulo de código personalizado está ativo e configurado corretamente
  • o teu navegador ou bloqueador de anúncios não está a bloquear o script
  • o snippet não está instalado duas vezes

Se o script não aparecer no separador Rede, verifica se a página que estás a testar usa um tema, domínio, versão linguística ou configuração de site diferente. Os sites Drupal podem ter configurações diferentes para secções distintas, pelo que o snippet pode ter de ser adicionado através da configuração global do tema ou do site.

Webflow

O mandera pode ser instalado no Webflow adicionando o snippet de rastreamento ao teu código personalizado para todo o site. Isto faz com que o snippet seja carregado em todas as páginas públicas que queres que o mandera analise.

Usa este método se o teu site foi criado com Webflow e tens acesso às definições do site.

Antes de instalares: Certifica-te que o teu site Webflow está publicado e que o teu plano do site ou espaço de trabalho suporta código personalizado.

Método 1: Adiciona o fragmento de código através do site Settings

A forma recomendada de instalar o mandera no Webflow é adicionar o snippet de rastreamento ao campo «Código Head» do site.

  1. Abre o teu painel de controlo do Webflow.
  2. Seleciona o site onde queres instalar o mandera.
  3. Abre o site Settings.
  4. Vai à secção "Custom Code".
  5. Cola o snippet de rastreamento mandera no campo «Código Head».
  6. Guarda as tuas alterações.
  7. Publica o teu site Webflow.
  8. Abre o teu site num novo separador do navegador.
  9. Verifica a instalação com os passos acima.

Adiciona este excerto no campo "Site-wide Head Code":

<script
  src="https://<your-mandera-web-url>/analytics.js"
  mandera-org="ORG_ID"
  data-property-id="PROPERTY_ID"
  async
></script>

Substituir ID_ORG, ID_IMÓVEL e o script URL com os valores do teu painel mandera.

O código adicionado ao campo «Código de cabeçalho» para todo o site é carregado em todo o teu site Webflow. Esta é a melhor opção para a configuração padrão mandera, porque o snippet deve estar disponível em todas as páginas públicas que queiras medir.

Método 2: Adiciona o excerto a uma página específica

Se quiseres testar o mandera primeiro apenas numa página do Webflow, podes adicionar o snippet de rastreamento através do código personalizado ao nível da página.

Usa este método apenas para testes ou para páginas em que o mandera deva ser limitado a uma parte específica do teu site.

  1. Abre o teu projeto Webflow no Designer.
  2. Abre o painel Páginas.
  3. Seleciona a página onde queres instalar o mandera.
  4. Abre as definições da página.
  5. Rola até à secção de Código Personalizado.
  6. Cola o snippet de rastreamento mandera no interior <head> campo de etiqueta.
  7. Guarda as tuas alterações.
  8. Publica o teu site Webflow.
  9. Abre a página numa nova aba do navegador.
  10. Verifica a instalação com os passos acima.

Adiciona este excerto à página, no nível "Inside". <head> campo de etiqueta:

<script
  src="https://<your-mandera-web-url>/analytics.js"
  mandera-org="ORG_ID"
  data-property-id="PROPERTY_ID"
  async
></script>

Substituir ID_ORG, ID_IMÓVEL e o script URL com os valores do teu painel mandera.

Se quiseres que o mandera analise todo o teu site, usa antes o método do código de cabeçalho para todo o site. A instalação ao nível da página aplica-se apenas à página selecionada.

Método 3: Usar o Tag Manager Google

Se o teu site Webflow já usa o Google Tag Manager, podes adicionar o snippet mandera através do GTM, em vez de o adicionares diretamente através do código personalizado do Webflow.

  1. Abre o Google Tag Manager.
  2. Escolhe o contentor usado no teu site Webflow.
  3. Criar uma nova etiqueta.
  4. Escolhe uma tag HTML personalizada.
  5. Cola o snippet de rastreio mandera no campo HTML.
  6. Define o gatilho para todas as páginas.
  7. Guardar e publicar o contentor.
  8. Abre o teu site Webflow numa nova aba do navegador.
  9. Verifica a instalação com os passos acima.

Certifica-te de que o próprio contentor do Tag Manager Google já está instalado no teu site Webflow. Se o contentor não carregar, o snippet mandera também não vai carregar.

Elementos de código incorporado do Webflow

Não uses um elemento «Code Embed» normal para a instalação básica do mandera. Os elementos «Code Embed» são úteis para incorporações visíveis ou conteúdo da página, mas o snippet de rastreamento do mandera deve ser carregado globalmente na secção «head» do teu site.

Resolver problemas no Webflow

Se não aparecerem dados no mandera, verifica primeiro estes pontos:

  • O teu site Webflow foi publicado
  • o teu site ou plano de trabalho suporta código personalizado
  • o excerto foi adicionado ao campo de código do site.
  • os valores do teu painel de controlo mandera foram copiados na íntegra
  • as tuas alterações foram guardadas e publicadas
  • o site que estás a testar é público
  • o teu navegador ou bloqueador de anúncios não está a bloquear o script
  • O Google Tag Manager é publicado se tiveres instalado o mandera através do GTM
  • o snippet não está instalado duas vezes

Se o script não aparecer no separador Network, abre novamente as Definições de Código Personalizado do Webflow e verifica se o trecho ainda está ativo no campo Código do Cabeçalho. Publica o site novamente e testa o site publicado, não apenas a pré-visualização do Webflow.

O que vem a seguir?

Verifica o teu primeiro dado

Assim que o snippet estiver instalado, o mandera pode recolher dados analíticos do teu site. Esses dados aparecem na suíte de análise e ajudam o sistema a compreender o tráfego, as fontes e as páginas.

Esta mesma configuração também é compatível com o sistema mandera, de maior alcance. Os dados analíticos podem contribuir para o contexto, as conclusões do SEO e as oportunidades de crescimento assim que as partes relevantes do teu espaço de trabalho estiverem prontas.

Continua a ler os guias do sistema

Depois da instalação, abre o pacote de análise e verifica se os dados começam a aparecer. Depois, segue as orientações do sistema para perceberes como o mandera utiliza esses dados nos fluxos de trabalho de análise, SEO, contexto e crescimento.

Relacionado

Para começar
Analytics Suite
Settings
Conceitos chave
Como rastreamos
Ajuda

Última atualização: 12 de junho de 2026

← Voltar à Página Inicial
Dos dados à direção, automaticamente.
Recursos
Português
documentação Brevemente Notas de atualização compara blog empresa
empresa
quem somos nós contacta feedback imprint política de privacidade terms
© 2026 mandera.ai