Tudo o que quer saber antes de instalar.
Uma análise detalhada de como o Google Search Console no PrestaShop: Acompanhamento de Posições funciona, porque o construímos assim e o raciocínio por trás das funcionalidades acima.
Porquê o GSC Connect?
A Google Search Console é a ferramenta indispensável para acompanhar o posicionamento da sua loja PrestaShop. Mas abrir a interface da Google, saltar entre separadores, exportar CSV à mão, cruzar as posições com as referências dos produtos, vigiar as quedas uma a uma: é uma perda de tempo diária e um risco de esquecimento. O GSC Connect traz todos os dados da Search Console diretamente para o back-office do PrestaShop, cruzados com o catálogo de produtos e categorias, com alertas automáticos quando algo corre mal.
Ligação OAuth com um clique
A instalação resume-se a criar um projeto na Google Cloud, copiar o Client ID e o Client Secret para a configuração do módulo e clicar em Ligar à Google. Valida as permissões, o módulo recebe o refresh token, cifra-o e guarda-o localmente. A renovação do access token é automática. Depois disso, não é preciso qualquer intervenção manual.
Sitemaps: submissão e acompanhamento
O módulo deteta automaticamente os sitemaps candidatos: o sitemap.xml na raiz e os padrões gerados por módulos do PrestaShop como o gsitemap. Submete-os à Search Console com um clique, e o módulo passa a acompanhar por si o número de URL enviados, indexados, os erros e a data da última transferência pelo Googlebot. Se a Google reportar erros, recebe um alerta automático.
Inspeção de URL em massa
A API de Inspeção da Google limita as chamadas a 2000 por dia. O GSC Connect gere essa quota por si através de uma fila de espera. Coloca todos os produtos ativos ou todas as categorias na fila com um clique, e o cron processa-a ao longo de vários dias, respeitando o limite. Para cada URL, o módulo regista o veredito da Google: indexado ou não, estado de cobertura, robots.txt, indexabilidade, resultados enriquecidos detetados, AMP e compatibilidade com telemóveis. Qualquer página não indexada gera um alerta de gravidade alta com o motivo devolvido pela Google.
Relatórios de cliques e posições
O painel reúne 8 indicadores: cliques e impressões a 28 dias, CTR médio, posição média, número de alertas por ler, número de páginas não indexadas, quota consumida do dia e última sincronização. É gerado um gráfico de evolução a 28 dias com o Chart.js incluído localmente (sem dependências de CDN). Os separadores de relatórios detalhados mostram os melhores produtos e categorias por cliques, com posição média e CTR, com um período parametrizável de 7 a 90 dias, ordenação do lado do cliente e exportação CSV.
Alertas de queda e de desindexação
São geridas três famílias de alertas: quedas de posição em páginas já bem posicionadas, quedas significativas de cliques em percentagem, e desindexação. Os limiares são totalmente parametrizáveis. A comparação é feita numa janela móvel de 7 dias contra os 7 dias anteriores, com um desfasamento de 2 dias para respeitar a latência de atualização da Search Console. A desduplicação de 24 h evita receber cinco vezes o mesmo alerta. Os alertas podem ser enviados por e-mail sob a forma de um resumo HTML agrupado por gravidade.
Cron compatível com alojamento partilhado
O módulo expõe um endpoint de cron protegido por token, acionável a partir do cron do seu alojamento. As tarefas são filtráveis: sincronização (obtém os novos dados da Search Console), inspeção (processa a fila), sitemaps (atualiza o estado), quedas (calcula as descidas), notificações (envia os e-mails) e limpeza (elimina os dados antigos). Não é preciso Redis, worker BullMQ nem PHP-FPM dedicado. Funciona em qualquer alojamento Linux normal.
Arquitetura limpa
Código PSR-4 com namespace DataFirefly/GscConnect, autoloader próprio sem Composer, chamadas à API da Google em cURL nativo com verificação SSL, 8 tabelas dedicadas com prefixo dfgsc_, ficheiros index.php antilistagem em todos os diretórios, token de estado CSRF em cookie no fluxo OAuth, validação com hash_equals no token do cron e escape sistemático das saídas nos templates.
Ainda não existem avaliações.