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.
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.

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.

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
- Em Módulos > Gestor de módulos, clique em Carregar um módulo e escolha
dfserptracker-2.0.0.zip. - 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)
- No Google Cloud, crie uma conta de serviço e transfira a respetiva chave em formato JSON.
- 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).
- Em Definições > Fonte das posições, escolha Google Search Console, cole a chave JSON e indique a propriedade (
sc-domain:o-seu-dominio.ptouhttps://www.o-seu-dominio.pt/). - 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.

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.

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.


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.


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.


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.


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.

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.

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.