# Como corrigir o Keyword Tracker do Rank Math que não atualiza posicoes no WordPress

O Rank Math Keyword Tracker não atualiza posicoes quando a conta Google desconecta, quando o cache do servidor congela as consultas do banco ou quando o Google Search Console ainda não reporta dados para a palavra-chave rastreada.

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

**Antes de começar:** Antes de editar o wp-config.php, configurar cron no servidor ou reconstruir as tabelas de Analytics do Rank Math, faca um backup completo do site (arquivos e banco de dados) ou teste em um ambiente de staging, para poder reverter caso a importação ou a conexão quebre.

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

Erros relacionados

- [Como corrigir schema markup quebrado no WordPress](https://full.services/wp-fixer/corrigir-schema-markup-quebrado-wordpress/)
- [Como corrigir meta description não aparecendo no Google](https://full.services/wp-fixer/corrigir-meta-description-nao-aparece-wordpress/)
- [Como corrigir sitemap XML com erro no WordPress](https://full.services/wp-fixer/corrigir-sitemap-xml-erro-wordpress/)

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

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

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

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

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

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


## Código

```php
<?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( 'RankMathAnalyticsAnalytics' ) ) {
        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;
}
```

## Perguntas frequentes

### Por que o Rank Math Keyword Tracker não atualiza as posicoes

Na maioria dos casos a conta Google se desconectou do Rank Math ou o cache da hospedagem congelou as consultas ao banco. Reconecte o Search Console em Rank Math -> Analytics e limpe o cache de página e de objeto para liberar a coleta de dados.

### O Rank Tracker do Rank Math faz scrape ao vivo do Google

Não. Segundo a documentação oficial, o Rank Math processa os dados da sua conta do Google Search Console e Analytics, e a posicao exibida e uma media de várias buscas. Por isso ele depende totalmente da conexão com o Google estar ativa.

### Por que minha keyword nova aparece como No Data no Rank Tracker

Termos recem-adicionados ou de baixo volume ficam sem posicao até o Google Search Console acumular impressoes para eles. O Rank Tracker apenas espelha o que o Search Console já reporta, entao verifique a consulta direto no painel do Google.

### O cache da hospedagem atrapalha o Rank Tracker do Rank Math

Sim. A documentação do Rank Math afirma que, se a hospedagem cacheia as consultas ao banco de dados, as palavras-chave não são adicionadas nem atualizadas no Rank Tracker. Limpe o cache de objeto e peca ao suporte para não cachear database queries.

### Preciso do Rank Math PRO para usar o Keyword Tracker

Sim. O Rank Tracker e um recurso exclusivo do Rank Math PRO e exige a conexão da sua conta Google. Sem o PRO ativo e a conta conectada, a coleta de posicao por palavra-chave não fica disponível.

### Como forco o Rank Math a buscar as posicoes mais recentes

Va em Rank Math -> Analytics -> Rank Tracker e use a opção de atualizar ou reindexar os dados do Analytics. Garanta também que o WP-Cron esta rodando, pois e ele que dispara o fetch periodico do Search Console.

### Por que o histórico de posicao do Rank Math parou em uma data

Geralmente o agendador do WordPress não executou mais o fetch do Analytics, ou a conta Google expirou naquela data. Configure um cron real do servidor e reconecte o Search Console para retomar a gravacao de novos pontos no histórico.

**Fonte:** [Rank Math KB - How to Use the Rank Tracker](https://rankmath.com/kb/rank-tracker/)