Data Studio: criando relatórios com os dados do AutoPSEO

O AutoPSEO não publica um conector para o Data Studio, a ferramenta de dashboards do Google antes chamada de Looker Studio. Ainda assim, há três formas de exibir os números do AutoPSEO nela: o conector do Search Console do próprio Google, para os dados brutos; um CSV exportado de um relatório do AutoPSEO; ou uma planilha Google preenchida por um script agendado a partir da REST API do AutoPSEO. A escolha depende de quão atualizado o dashboard precisa ser e de ele exigir as análises do AutoPSEO ou apenas as métricas brutas.

Opção 1: conector do Search Console do Google

O conector do Google lê o Search Console diretamente. Ele traz as métricas brutas, mas nenhuma das análises do AutoPSEO. De acordo com o guia do Google sobre o conector:

• Ele oferece duas tabelas, Site Impression e URL Impression, e cada fonte de dados usa apenas uma delas. Adicione duas fontes de dados ao relatório para exibir ambas.
• Você precisa de pelo menos permissão de visualização na propriedade do Search Console, com login nos dois produtos usando a mesma conta Google.
• A Site Impression abrange resultados da web, de imagens, de vídeos e de notícias; a URL Impression acrescenta Discover e Google News.

Para adicioná-lo, escolha Create → Data Source → Search Console, selecione o site, a tabela e o tipo de pesquisa padrão e clique em Connect.

Opção 2: upload de um CSV do AutoPSEO

Para um dashboard pontual ou mensal, exporte uma tabela de qualquer relatório (Exportação de dados) e adicione-a com o conector de upload de arquivos CSV do Data Studio. Os requisitos de upload do Google determinam como exportar:

• Os campos devem ser separados por vírgulas, portanto defina antes Account → CSV export format como Standard (US / UK).
• O arquivo deve estar em UTF-8 e ter uma linha de cabeçalho, como as exportações do AutoPSEO.
• Todos os arquivos adicionados a um conjunto de dados precisam ter exatamente as mesmas colunas, na mesma ordem. Por isso, exporte sempre o mesmo relatório, com as mesmas colunas e a mesma configuração de comparação.
• Os novos arquivos são acrescentados e as duplicatas não são removidas, então não envie períodos que se sobreponham.
• Um arquivo pode ter até 100 MB, e cada usuário dispõe de 2 GB de armazenamento para uploads.

As porcentagens são exportadas com o sinal de porcentagem (27.03%), portanto verifique os tipos de campo após o upload.

Opção 3: uma planilha Google alimentada pela REST API

Para um dashboard que se mantém atualizado sozinho, faça uma tarefa agendada gravar os números do AutoPSEO em uma planilha Google e conecte a planilha. O conector do Google Sheets do Google verifica valores alterados e novas linhas sempre que o relatório faz uma consulta.

1. No AutoPSEO, abra MCP & API e crie uma chave de API com escopo Read only. Ela é exibida uma única vez, então guarde-a nos segredos da sua tarefa.
2. Na tarefa agendada (Google Apps Script, um cron job ou uma ferramenta de workflow), chame a REST API e grave as linhas na planilha.
3. No Data Studio, adicione a planilha com o conector do Google Sheets e marque Use first row as headers.

Uma chamada para obter as principais consultas dos últimos 28 dias tem este formato:

curl -s "https://app.autopseo.com/v1/properties/sc-domain%3Aexample.com/queries?range=28d&limit=1000" \
  -H "Authorization: Bearer apk_live_..."

Cada resposta é um JSON, com o resultado em data e os detalhes da chamada em meta. A REST API oferece as mesmas 19 ferramentas do Search Console e do GA4 que o servidor MCP: propriedades, linhas de search analytics, principais consultas, páginas e países, comparação de períodos, mudanças de ranking, rankings novos e perdidos, content decay, canibalização, benchmark de CTR, page poaching, inspeção de URL, sitemaps, anotações e, no GA4, visão geral, detalhamento e eventos-chave. As principais consultas e páginas retornam até 1,000 linhas, os principais países até 300, e search-analytics até 5,000 linhas brutas para uma ou duas dimensões. As chamadas são limitadas a 60 por minuto por chave e 1,000 por hora por conta, e o documento OpenAPI 3.1 em https://app.autopseo.com/v1/openapi.json descreve todos os parâmetros.

Qual opção escolher

Se o dashboard existe principalmente para mostrar os números a um cliente, um link de relatório compartilhado ou um relatório agendado no Slack ou no Teams pode dar menos trabalho. Nosso FAQ sobre o Search Console no Looker Studio trata o conector do Google com mais profundidade.