Como corrigir o Keyword Tracker do Rank Math que não atualiza posicoes no WordPress
O que é Rank Math Keyword Tracker que não atualiza?
O Rank Math Keyword Tracker (Rank Tracker, na aba Analytics) e um recurso exclusivo do Rank Math PRO que mostra a posicao media de cada palavra-chave que você adiciona. Segundo a documentação oficial, ele não faz um scrape ao vivo do Google: ele processa automaticamente os dados da sua conta do Google Search Console e do Analytics para montar impressoes, cliques, posicao atual, CTR e o histórico de posicao de cada termo. A posicao exibida e uma media de várias buscas, e não uma medicao instantanea.
Por depender dessa ponte com o Google, o Keyword Tracker para de atualizar quando a integração quebra em algum ponto da cadeia: a conta Google se desconecta do Rank Math, o agendamento que importa os dados não roda, o cache do servidor ou da hospedagem congela as consultas ao banco, ou simplesmente o Search Console ainda não acumulou dados suficientes para o termo. A página não mostra erro vermelho, ela apenas exibe números antigos ou em branco, o que faz parecer que o ranking estacionou quando o problema esta na coleta.
Como identificar
- A coluna de posicao no Rank Tracker (Rank Math -> Analytics -> Rank Tracker) fica parada nos mesmos números por dias, mesmo após você publicar mudancas e o ranking real ter mexido.
- Uma palavra-chave recem-adicionada exibe ‘No Data’ ou um traco no lugar da posicao e nunca sai desse estado.
- O grafico de histórico de posicao aparece achatado ou vazio, sem novos pontos depois de uma certa data.
- Em Rank Math -> General Settings -> Analytics, o status do Search Console ou da conta Google aparece como desconectado ou pedindo nova autorizacao.
- A mensagem de reautenticacao ‘Reconnect your Google account’ ou um aviso de token expirado surge no painel do Rank Math Analytics.
Como prevenir
- Mantenha a conta Google e o Search Console conectados no Rank Math e renove a autorizacao assim que aparecer aviso de token expirado, evitando que a coleta pare em silencio.
- Configure um cron real do servidor em vez de depender so do WP-Cron, garantindo que a importação periodica do Analytics rode mesmo em sites de baixo tráfego.
- Exclua as páginas e rotas do Rank Math do cache de página e de objeto na hospedagem, para que o cache não congele as consultas ao banco usadas pelo Rank Tracker.
- Monitore o espaco do banco de dados e a integridade das tabelas de Analytics do Rank Math, prevenindo falhas de gravacao das novas posicoes.
- Acompanhe as posicoes pelo próprio Search Console em paralelo, já que o Rank Tracker e uma media derivada do Google e leva alguns dias para refletir termos novos.
Causa
- A conexão da conta Google com o Rank Math expirou ou foi revogada: sem o vinculo com o Search Console o Rank Tracker não tem de onde puxar posicao, e a documentação oficial deixa claro que o recurso so funciona com a conta Google conectada.
- O cache do servidor ou da hospedagem esta cacheando as consultas ao banco de dados: a doc do Rank Math indica que, se a hospedagem cacheia database queries, as palavras-chave não são adicionadas nem atualizadas no Rank Tracker.
- O Google Search Console ainda não reporta dados para aquele termo específico: keywords novas ou de volume muito baixo ficam sem posicao até o Search Console acumular impressoes, e o Rank Tracker apenas espelha o que o Google já tem.
- O cron do WordPress que dispara a importação do Analytics do Rank Math não esta rodando (site de baixo tráfego ou WP-Cron desativado sem cron real do servidor), entao o fetch periodico dos dados do Search Console nunca executa.
- As tabelas de Analytics do Rank Math estão ausentes ou corrompidas (instalação interrompida, banco sem espaco ou import que falhou), impedindo a gravacao das novas posicoes vindas do Search Console.
- O recurso Rank Tracker não foi atualizado no próprio módulo: e exclusivo do Rank Math PRO e, sem o PRO ativo e licenciado, a coleta de posicao por keyword fica indisponivel.
Como resolver
- Reconecte a conta Google e o Search Console: O Rank Tracker depende da conta Google vinculada. Reautorize o acesso para reabrir a ponte com o Search Console, que e a fonte real das posicoes segundo a doc oficial.
Painel WP -> Rank Math SEO -> General Settings -> Analytics Clique em Reconnect Account (ou Disconnect e conecte de novo) e reautorize o acesso ao Google Search Console Confirme que a propriedade correta do Search Console esta selecionada após reconectar - Limpe o cache que congela as consultas ao banco: A documentação do Rank Math aponta o cache de database queries da hospedagem como causa de keywords que não entram nem atualizam no Rank Tracker. Limpe o cache de objeto e o cache de página para liberar as consultas.
Painel WP -> limpe o cache do seu plugin de cache (ex.: WP Rocket -> Configurações -> Limpar cache) No painel da hospedagem, limpe o cache de objeto (Redis/Memcached) e o cache de página Peca ao suporte da hospedagem para confirmar que database queries não estão sendo cacheadas - Force uma nova coleta de dados do Analytics: Dispare a reindexacao dos dados do Search Console no Rank Math para puxar as posicoes mais recentes em vez de esperar o ciclo automático.
Painel WP -> Rank Math SEO -> Analytics -> aba Rank Tracker Use a opção de atualizar/reindexar os dados do Analytics (Update Manually / Rebuild Database) quando disponível Aguarde a importação concluir e recarregue a página do Rank Tracker - Garanta que o WP-Cron esta executando: O fetch periodico do Analytics depende do agendador do WordPress. Em sites de baixo tráfego, troque o WP-Cron por um cron real do servidor para a importação rodar de forma confiavel.
No wp-config.php, defina define( 'DISABLE_WP_CRON', true ); No servidor, agende: */15 * * * * wget -q -O - https://seusite.com/wp-cron.php?doing_wp_cron >/dev/null 2>&1 Verifique tarefas pendentes em Ferramentas -> Site Health -> Info -> Scheduled Events - Verifique o termo no Search Console e o licenciamento PRO: Se o termo for novo ou de baixissimo volume, o próprio Google ainda não tem dados. Confirme no Search Console e valide que o Rank Math PRO esta ativo, já que o Rank Tracker e exclusivo do PRO.
Abra o Google Search Console -> Desempenho -> filtre pela consulta e confirme se ha impressoes Painel WP -> Rank Math SEO -> verifique se a licenca do Rank Math PRO esta ativa e conectada Se não houver dados no Search Console, aguarde a coleta do Google acumular impressoes para o termo
<?php
// Garante que o WP-Cron dispara o fetch do Analytics do Rank Math
// mesmo em sites de baixo trafego, e reagenda se a tarefa sumiu.
add_action( 'init', 'full_rank_math_garante_cron_analytics' );
function full_rank_math_garante_cron_analytics() {
// So age se o modulo de Analytics do Rank Math PRO estiver ativo.
if ( ! class_exists( 'RankMath\Analytics\Analytics' ) ) {
return;
}
$hook = 'rank_math/analytics/get_analytics';
if ( ! wp_next_scheduled( $hook ) ) {
wp_schedule_event( time() + 60, 'daily', $hook );
}
}
// Limpa o cache de objeto que congela as consultas do Rank Tracker,
// util logo apos reconectar o Search Console.
add_action( 'admin_post_full_rm_flush_analytics', 'full_rank_math_flush_analytics_cache' );
function full_rank_math_flush_analytics_cache() {
if ( ! current_user_can( 'manage_options' ) ) {
wp_die( 'Permissao negada.' );
}
check_admin_referer( 'full_rm_flush' );
wp_cache_flush();
delete_transient( 'rank_math_analytics_data' );
wp_safe_redirect( wp_get_referer() );
exit;
}














