Configurações de cookies

Os cookies necessários mantêm o site funcionando. A análise mostra quais páginas são úteis. Você pode mudar sua escolha a qualquer momento pelo rodapé.

Política de cookies deste site — detalhes completos: categorias de cookies, como guardamos sua escolha no navegador e como retirar o consentimento.

Necessários

Funções básicas do site e sua escolha de consentimento. Sempre ativos.

Análise

Ajuda a entender como o site é usado. Carregado apenas com sua permissão.

GitHubBaixar ZIP

Dados do GA4 e do Yandex Metrika

Leia visualizações de página e tráfego do GA4 e do Yandex Metrika e depois cruze esses dados com os problemas encontrados no rastreamento, para corrigir as páginas que as pessoas realmente visitam. As duas conexões são somente leitura.

Ver no GitHubInício rápido

O que faz

  • SpiderHead no terminal: seohead metrika-report

Yandex Metrika

O metrika-counters encontra o ID do contador. O metrika-setup mostra as metas, filtros e operações de dados, que você deve ler antes de tirar conclusões. Depois, o metrika-report busca as métricas e dimensões que você pedir, com paginação automática.

  • O acesso é um token OAuth do Yandex em YANDEX_METRIKA_TOKEN ou no arquivo de token
  • O metrika-traffic-pdf gera um relatório de tráfego A4 em HTML e PDF. Para o PDF, é preciso ter Chrome, Edge ou Chromium local.
  • Logs brutos ficam de fora de propósito, porque contêm identificadores de visitantes.

Google Analytics 4

O GA4 não tem comando de CLI próprio. Você coleta os dados com o provider-collect, usando a operação page_views para páginas visitadas ou landing_pages para páginas de destino. O page_views conta screenPageViews por data, host e caminho de uma propriedade que você indicar.

  • O acesso é um token de acesso do GA4 (GA4_ACCESS_TOKEN) ou uma conta de serviço do Google com o escopo analytics.readonly
  • A conta precisa de acesso de leitura à propriedade
  • Linhas brutas vão para uma pasta local privada de artefatos, não para a resposta da ferramenta

Cruzamento com o rastreamento

O crawl-enrich associa um CSV de tráfego indexado por URL às URLs rastreadas e adiciona problemas de analytics, usando as colunas de visitas e de taxa de rejeição que você indicar. Com um projeto, o sources-sync mantém o histórico diário em um arquivo SQLite local, e o sf run cruza esse histórico com as páginas auditadas, offline.

  • Problemas de página órfã, sem dados e não indexável com tráfego vêm do cruzamento
  • URLs cruzadas, só do rastreamento e só do analytics continuam como populações separadas
  • Números do GA4 e do Metrika nunca são somados

Três passos, um rastreamento salvo

  1. Verifique a configuração do contador antes

    Rode o metrika-counters para encontrar o ID do contador e depois o metrika-setup para ver suas metas, filtros e operações de dados.

  2. Busque visitas e visualizações de página

    O metrika-report lê o Yandex Metrika com as métricas e dimensões que você escolher. As visualizações de página do GA4 vêm do provider-collect com a operação page_views do GA4.

  3. Cruze os números com o rastreamento

    O crawl-enrich associa o CSV de tráfego às URLs rastreadas pela URL e adiciona problemas de analytics, incluindo as colunas de visitas e de taxa de rejeição.

Verificações deste recurso

VerificaçãoO que significaGravidadeEvidência
GA_ORPHAN_URLOs dados de analytics citam uma URL do mesmo domínio que o rastreamento não encontrouImportantLista de URLs do cruzamento. Omitido em rastreamento parcial
NON_INDEXABLE_WITH_GA_DATAUma página não indexável ainda recebe visitas acima de zeroImportantURL e contagem de visitas de --visits-column
NO_GA_DATAUma página rastreada e indexável não tem nenhuma linha de analyticsTipLista de URLs. Confira o período medido e a instalação das tags de analytics antes de agir
BOUNCE_RATE_ABOVE_70A taxa de rejeição da página está acima de 70%TipURL e taxa de rejeição de --bounce-column

Um comando

bash
seohead metrika-report --counter 12345678 --date1 2026-09-01 --date2 2026-09-30

Instale primeiro: guia de instalação. Todo comando também funciona como ferramenta MCP para agentes de IA.

O que você precisa

  • Yandex Metrika: um ID de contador e um token OAuth
  • GA4: um ID de propriedade e um token de acesso ou uma conta de serviço com analytics.readonly
  • Um intervalo de datas
  • Um rastreamento ou auditoria, mais um CSV de tráfego se você usar crawl-enrich

Limites

  • Visualizações de página do GA4 não são sessões, usuários nem sessões em páginas de destino, e não são prova de que uma mudança causou o tráfego.
  • A coleta do GA4 retorna no máximo 100.000 linhas por execução. Dados com threshold ou amostrados são sinalizados.
  • Zero visitas pode vir de problemas na instalação das tags ou de filtros, então verifique o metrika-setup antes.
  • Linhas ausentes não são zeros medidos. Um resultado negativo exige rastreamento completo e cobertura completa do provedor.

Perguntas

A ferramenta altera meu site ou as configurações de analytics?
Não. Todas as chamadas são somente leitura. O metrika-setup apenas mostra como um contador está configurado. As evidências salvas ficam em uma pasta local.
Qual acesso eu preciso?
Para o Metrika, um token OAuth do Yandex na configuração YANDEX_METRIKA_TOKEN ou no arquivo de token. Para o GA4, um GA4_ACCESS_TOKEN ou uma conta de serviço com o escopo analytics.readonly e acesso de leitura à propriedade.
Por que uma página com zero visitas nem sempre é um problema?
Zero pode vir da configuração. Sem metas ou filtros configurados, os números podem estar incompletos. Verifique o metrika-setup antes de tirar conclusões sobre o tráfego.
A ferramenta lê logs brutos de visitantes?
Não. Os logs brutos do Metrika ficam de fora por design, porque contêm identificadores de visitantes. A ferramenta usa apenas relatórios agregados.
Quanto custa?
O SpiderHead não cobra nada por esses comandos. As chamadas contam nas cotas de API do Metrika e do GA4 da sua própria conta.
O que fica armazenado na minha máquina?
As linhas brutas do GA4 vão para uma pasta privada de artefatos que você escolhe. O sources-sync grava o histórico diário em um arquivo SQLite do projeto, sem guardar tokens. O metrika-report imprime o resultado; salve você mesmo se precisar.

Continue explorando

Do blog e do glossário

GA4 para SEO: relatórios, métricas e uso práticoBlogYandex MetricaGlossário

Mais neste grupo · Fontes de dados

Integração com o Google Search ConsoleRecursoIntegração com o Yandex WebmasterRecursoRelatório de Core Web Vitals do CrUXRecursoAnalisador de arquivos de log do servidorRecursoVerificador de backlinks de uma lista de doadoresRecursoFerramenta para montar o núcleo semânticoRecurso

Teste no seu próprio site

Baixar ZIPTodos os recursos