PS PrestaShop Intermédio

SERP Tracker: guia completo

Instale, configure e utilize a monitorização de posições no Google: Search Console ou uma API SERP, palavras-chave por país, idioma e dispositivo, painel, ficha da palavra-chave, concorrentes, alertas, cron, quotas e custo, para PrestaShop 1.7.8 a 9.

Atualizado Versão do módulo 2.0.0

Apresentação

O módulo SERP Tracker (dfserptracker) acompanha as posições da sua loja nos resultados do Google, palavra-chave a palavra-chave, diretamente no back-office do PrestaShop: país (gl), idioma (hl), computador ou telemóvel, localização opcional. Conserva o histórico de cada leitura, traça curvas de evolução, compara as suas posições com as dos concorrentes que escolher e avisa-o por e-mail sobre alterações importantes, controlando o número de pedidos e o respetivo custo.

Painel de monitorização de posições no Google: visibilidade estimada, posição média, top 3, página 1 e evolução a 90 dias
Painel de monitorização de posições no Google: visibilidade estimada, posição média, top 3, página 1 e evolução a 90 dias

O módulo não tem qualquer efeito na sua loja do lado dos visitantes: apenas acrescenta páginas de back-office (menu Melhorar > Monitorização de posições) e um URL de tarefa agendada protegido por token.

De onde vêm as posições?

O SERP Tracker nunca consulta o Google diretamente. As políticas antispam do Google classificam a extração automatizada de resultados para fins de monitorização de posições como tráfego gerado automaticamente: uma ferramenta instalada no seu servidor exporia o seu endereço IP a um bloqueio. Por isso, escolha uma fonte em Definições > Fonte das posições:

  • Google Search Console (API oficial do Google, gratuita): posição média das suas páginas nos últimos 7 dias completos, com 2 a 3 dias de atraso, apenas para as pesquisas em que a sua loja foi apresentada. Sem dados sobre os concorrentes.
  • Uma API SERP (DataForSEO, SerpApi, ValueSERP, Serper.dev): posição em tempo real, outros sites da página, excertos em destaque, «Outras perguntas», pack local. Estes fornecedores recolhem eles próprios as páginas de resultados, segundo as suas próprias condições e sob a sua responsabilidade; são pagos por pedido.
  • Demo: posições fictícias geradas localmente para conhecer o módulo, sem qualquer pedido. Uma faixa violeta assinala-o em todas as páginas.
Escolha da fonte das posições: Google Search Console (API oficial), API SERP ou demo, chaves cifradas e nunca reapresentadas
Escolha da fonte das posições: Google Search Console (API oficial), API SERP ou demo, chaves cifradas e nunca reapresentadas

Compatibilidade

  • PrestaShop 1.7.8 a 9.x (testado em 1.7.8.11, 8.2.1 e 9.1.5)
  • PHP 7.4 a 8.5, extensões cURL e OpenSSL
  • Loja única e multiloja (palavras-chave, domínio, alertas e propriedade do Search Console por loja)
  • Back-office e e-mails em 8 idiomas: FR, EN, ES, DE, IT, NL, PL, PT
  • Compatível com alojamento partilhado: um simples URL a chamar uma vez por dia, sem Composer nem serviços externos

Instalação e atualização

  1. Em Módulos > Gestor de módulos, clique em Carregar um módulo e escolha dfserptracker-2.0.0.zip.
  2. Abra Melhorar > Monitorização de posições: um ecrã de boas-vindas guia-o em três passos (fonte, palavras-chave, agendamento).

A partir da 1.0.0: basta carregar o novo zip. As suas palavras-chave e todo o respetivo histórico são conservados; as suas chaves da API são cifradas e os antigos valores em texto simples são eliminados; o menu passa para Melhorar e os perfis que viam o antigo painel mantêm o acesso às novas páginas. Por prudência quanto aos custos, uma profundidade superior a 30 é reduzida para 30 (modificável).

Escolher e configurar a fonte

Google Search Console (recomendado para começar)

  1. No Google Cloud, crie uma conta de serviço e transfira a respetiva chave em formato JSON.
  2. No Search Console, adicione o endereço de e-mail da conta de serviço como utilizador da propriedade (Definições > Utilizadores e autorizações).
  3. Em Definições > Fonte das posições, escolha Google Search Console, cole a chave JSON e indique a propriedade (sc-domain:o-seu-dominio.pt ou https://www.o-seu-dominio.pt/).
  4. Clique em Testar a ligação (gratuito).

API SERP

  • DataForSEO: login e palavra-passe da API (não os da conta). Faturado por página de 10 resultados; o custo real devolvido pela API é registado.
  • SerpApi: chave da API; uma pesquisa faturada por página de 10 resultados. Teste de ligação gratuito (pesquisas restantes).
  • ValueSERP: chave da API; um crédito por página de 10 resultados.
  • Serper.dev: chave da API; apenas resultados para computador (a documentação da API não é pública).

As chaves são cifradas com a chave da sua loja antes de serem guardadas. Nunca voltam a ser apresentadas (o campo indica apenas «Guardado»), nunca são escritas nos registos e as mensagens de erro são limpas de qualquer identificador. Deixe um campo vazio para manter o valor guardado ou marque «Eliminar o valor guardado» para o apagar.

Definições do acompanhamento

  • Domínio a procurar nos resultados: o domínio da loja (o prefixo www. é ignorado). Opção: contar também os subdomínios.
  • Profundidade analisada: top 10 a top 100. Desde setembro de 2025, o Google apresenta 10 resultados por página: cada página adicional é mais um pedido faturável. A leitura para na página em que a sua loja aparece.
  • Valores predefinidos para novas palavras-chave: país, idioma, dispositivo, frequência.

Adicionar palavras-chave

Em Palavras-chave > Adicionar palavras-chave:

  • Várias palavras-chave: uma por linha (500 no máximo), com o país, o idioma, a frequência, um grupo, uma localização opcional e o dispositivo (computador, telemóvel ou ambos). Os duplicados são ignorados e uma estimativa do custo em 30 dias é atualizada durante a introdução.
  • Uma palavra-chave com a respetiva página-alvo: quando a página-alvo aparece nos resultados, é a posição desta que é considerada; caso contrário, a da melhor página do seu domínio.
  • Importação CSV: colunas keyword;group;country;language;device;target_url;volume;frequency.
Adição de palavras-chave em massa: uma por linha, país (gl), idioma (hl), frequência, grupo, localização, computador e telemóvel
Adição de palavras-chave em massa: uma por linha, país (gl), idioma (hl), frequência, grupo, localização, computador e telemóvel

A lista apresenta, para cada palavra-chave, a posição, a variação desde a leitura anterior, a tendência em 30 dias, a melhor posição, o volume e a página posicionada, com filtros, ordenação e ações em massa (verificar, pausar, retomar, grupo, frequência, eliminar). Estão disponíveis duas exportações CSV: as palavras-chave com as últimas posições e o histórico de 90 dias.

Lista de palavras-chave acompanhadas: posição, variação, tendência a 30 dias, melhor posição, volume e página posicionada
Lista de palavras-chave acompanhadas: posição, variação, tendência a 30 dias, melhor posição, volume e página posicionada

O painel

  • Visibilidade (em 100): estimativa da taxa de cliques esperada das suas palavras-chave em comparação com a situação em que estariam todas na primeira posição, com base numa curva de CTR média pública. Não é uma medida de tráfego.
  • Posição média (apenas palavras-chave posicionadas), Top 3, Página 1, variações no período.
  • Evolução: visibilidade, posição média ou intervalos de posições dia a dia; distribuição do dia.
  • Maiores subidas e descidas, palavras-chave perto da página 1 ou do top 3 (posições 4 a 20, ordenadas por volume), elementos da página de resultados, pedidos e custo, últimas execuções.

Filtros: período (7 dias a 1 ano), grupo, dispositivo, país.

Palavras-chave por faixa de posições dia a dia, maiores subidas e maiores descidas
Palavras-chave por faixa de posições dia a dia, maiores subidas e maiores descidas
Palavras-chave perto da página 1, elementos da página de resultados, pedidos e custo estimado, últimas execuções
Palavras-chave perto da página 1, elementos da página de resultados, pedidos e custo estimado, últimas execuções

A ficha de uma palavra-chave

Clique numa palavra-chave para ver a posição atual, as variações em 7 e 30 dias, a melhor posição, a curva do histórico comparada com os concorrentes acompanhados, a última página de resultados, as alterações da página posicionada (várias páginas da loja que se alternam na mesma pesquisa podem concorrer entre si) e as últimas leituras. Botões Verificar agora, Editar e Eliminar.

Ficha de uma palavra-chave: posição atual, variações a 7 e 30 dias e histórico comparado com os concorrentes acompanhados
Ficha de uma palavra-chave: posição atual, variações a 7 e 30 dias e histórico comparado com os concorrentes acompanhados
Última página de resultados com os concorrentes acompanhados e mudanças de página posicionada (páginas que competem entre si)
Última página de resultados com os concorrentes acompanhados e mudanças de página posicionada (páginas que competem entre si)

Concorrentes

Acompanhe até 8 domínios concorrentes (subdomínios incluídos). A posição de cada um é registada em cada verificação; quando se adiciona um concorrente, as respetivas posições anteriores são reconstituídas a partir das páginas de resultados já guardadas (top 20). A página apresenta a quota de visibilidade estimada de cada site nas suas palavras-chave, o número de palavras-chave em que cada concorrente está acima ou abaixo de si, a evolução ao longo do tempo e os outros sites encontrados nas suas palavras-chave, com um botão Acompanhar.

Quota de visibilidade estimada da loja e dos concorrentes nas palavras-chave acompanhadas, acima e abaixo
Quota de visibilidade estimada da loja e dos concorrentes nas palavras-chave acompanhadas, acima e abaixo
Evolução da visibilidade estimada face aos concorrentes acompanhados e sites encontrados nas suas palavras-chave
Evolução da visibilidade estimada face aos concorrentes acompanhados e sites encontrados nas suas palavras-chave

Com o Google Search Console, esta página fica vazia: o Search Console só fornece dados sobre as suas próprias páginas.

Alertas

Em Alertas, escolha os destinatários (5 no máximo) e as regras: descida ou subida de pelo menos N posições, entrada no top 3 ou saída do top 3, chegada à página 1 ou saída da página 1, desaparecimento dos resultados analisados, regresso, outra página da loja posicionada, excerto em destaque conquistado ou perdido.

  • Um e-mail agrupado após cada execução (uma palavra-chave por linha) ou um resumo diário a partir da hora escolhida;
  • intervalo mínimo entre dois e-mails; o mesmo alerta nunca é repetido para a mesma palavra-chave em 24 horas;
  • histórico de alertas conservado mesmo quando os e-mails estão desativados, botão Enviar um e-mail de teste.
Alertas por e-mail: regras (descida, top 3, página 1, página posicionada), destinatários, envio agrupado, intervalo mínimo e histórico
Alertas por e-mail: regras (descida, top 3, página 1, página posicionada), destinatários, envio agrupado, intervalo mínimo e histórico
E-mail de alerta agrupado: uma palavra-chave por linha com a posição anterior e a nova e as alterações detetadas
E-mail de alerta agrupado: uma palavra-chave por linha com a posição anterior e a nova e as alterações detetadas

Agendamento, limites e custo

As verificações são iniciadas por um URL do cron a chamar uma vez por dia (por exemplo, às 6h00) a partir das tarefas agendadas do seu alojamento. O token pode ser enviado no cabeçalho X-DFSERP-Token para não aparecer nos registos do servidor; Gerar um novo URL invalida o anterior.

  • Frequência por palavra-chave (todos os dias, a cada 3 dias, todas as semanas, a cada 2 semanas, todos os meses): só são verificadas as palavras-chave pendentes.
  • Palavras-chave por chamada, duração máxima de uma chamada, pausa entre dois pedidos, máximo de pedidos por dia e orçamento mensal.
  • Retoma: a chamada seguinte continua com as palavras-chave ainda não verificadas. Uma palavra-chave com erro é tentada novamente mais tarde (1 h, 2 h, 4 h… 24 h); uma chave recusada ou uma quota esgotada interrompe a execução sem penalizar as palavras-chave.
  • Custo estimado em 30 dias para cada fornecedor, a partir do número de palavras-chave, da respetiva frequência e da profundidade, com os preços por 1000 pedidos que introduzir (tarifas públicas por predefinição). A fatura do fornecedor é a referência.
Agendamento e limites: URL do cron com token, lotes, pausa, limite diário, orçamento mensal e custo estimado por fornecedor
Agendamento e limites: URL do cron com token, lotes, pausa, limite diário, orçamento mensal e custo estimado por fornecedor

O botão Verificar as palavras-chave pendentes do cabeçalho também inicia as verificações a partir do back-office, em pequenos lotes, com uma barra de progresso.

Dados e privacidade

  • Histórico conservado de 90 dias a 3 anos (ou sem limite), eliminado automaticamente uma vez por dia.
  • Permissões por perfil de funcionário: ver para consultar, editar para adicionar palavras-chave, alterar as definições e iniciar verificações (faturadas), eliminar para eliminar.
  • Com o fornecedor de demonstração, Gerar 90 dias de histórico de demonstração preenche os gráficos; Eliminar as leituras de demonstração apaga-as antes de passar para uma fonte real.
  • Na desinstalação, as tabelas, definições e separadores do módulo são eliminados.
Painel de monitorização de posições no telemóvel
Painel de monitorização de posições no telemóvel

FAQ e resolução de problemas

As posições são exatas?

São leituras pontuais: a mesma pesquisa pode dar resultados diferentes consoante o local, o dispositivo, a personalização e o momento. Acompanhe as tendências em vez de um valor isolado. Com o Search Console, o valor é uma posição média ao longo de vários dias.

O módulo melhora o meu posicionamento?

Não: mede. Ajuda-o a identificar as palavras-chave perto da página 1, as páginas que concorrem entre si e as descidas a vigiar; nenhum ganho de posição é garantido.

Uma palavra-chave apresenta «–»

O seu domínio não foi encontrado na profundidade analisada. Verifique o domínio, a página-alvo e o contexto (país, idioma, dispositivo), ou aumente a profundidade tendo em conta o custo.

Nada é atualizado

Verifique se o URL do cron está a ser chamado (a data da última chamada é apresentada nas definições), se a fonte está configurada (indicador verde no cabeçalho) e se o limite diário ou o orçamento não foi atingido (estado das últimas execuções no painel). Se a loja estiver em manutenção, adicione o endereço IP do seu servidor aos IP autorizados.

Quanto custam as verificações?

O Search Console é gratuito (dentro dos limites do Google). Para uma API SERP, o custo depende do número de palavras-chave, da respetiva frequência e da profundidade: a tabela «Custo estimado em 30 dias» das definições calcula-o para cada fornecedor. Uma frequência semanal divide o custo por 7.

Esta página foi útil?

Ainda com dúvidas? Contacte o suporte