Para que serve
Última análise
Vês os dados da última análise do workspace, no intervalo de datas do relatório.
Gráficos à medida
Montas tabelas e filtros por prompt, domínio e país que o dashboard não tem.
Partilha
Envia o relatório à equipa ou ao cliente, a partir do Data Studio.
Antes de começares
Marca no workspace
Conta Semantika com pelo menos uma marca no workspace.
Acesso à API
O plano tem de ter Acesso à API (beta). Sem isto, a secção API Key nem aparece e o conector devolve 403.
Conta Google
Conta Google com acesso ao Data Studio.
Como ligar a fonte
Abrir o Data Studio
Autentica-te na Google. O link directo do conector Semantika entra neste cartão quando o deployment versionado for publicado.
1
Abre o conector
Abre o conector Semantika no Data Studio. Tens de estar autenticado na Google.
2
Gera o token na Semantika
Na Semantika, vai a Definições do workspace → API Key. Não há várias chaves, não há scope por projeto e não dás um nome à chave.
- Clica Gerar API token.
- Copia o valor já: a app não o volta a mostrar.
- Confirma que o token começa por
sem_.
3
Cola o token no Data Studio
No campo Token da API (placeholder
sem_…), cola o token. Clica Next e depois Connect.4
Adiciona a fonte ao relatório
Quando carregar, clica Create Report e depois Add to report.
O conector só funciona com um API token
sem_… válido e com acesso à API no plano. Se já tinhas uma fonte Data Studio, volta a ligar e troca a fonte no relatório.Campos disponíveis
A tabela tem uma linha por data × marca × motor × prompt × URL de fonte. Visibilidade, Share of Voice e Sentimento repetem-se nas linhas do mesmo dia e motor: a agregação certa é a média, não a soma. País, prompt e domínio filtram a mesma tabela. A leitura destas métricas no dashboard está em Métricas.Uma marca sem runs concluídos ainda pode ter linhas só com snapshot (visibilidade, Share of Voice, sentimento).
engine, prompt e URLs vêm vazios. Um gráfico por motor ignora essas linhas.Dimensões
Métricas
A agregação abaixo é a que o conector declara. Se a mudares no gráfico, os números deixam de bater certo com o dashboard.O primeiro relatório
Cria o relatório
Depois de ligar a fonte, clica CREATE REPORT. O intervalo de datas é obrigatório: sem datas, o conector não devolve linhas.
Visibilidade por motor
Eixo Data, métrica Visibilidade, detalhe Motor. Granularidade: Dia. Confirma que Visibilidade fica em média, não em soma.
Filtra o recorte
Adiciona controlos de País, Prompt e Domínio. Filtram a mesma tabela; não criam outra fonte.
Problemas frequentes
O token foi recusado (401 ou 403)
O token foi recusado (401 ou 403)
Gera um token novo em Definições do workspace → API Key e cola-o outra vez ao ligar a fonte.Causas típicas: colaste o Personal access token da secção MCP em vez do
sem_…; regeneraste o token e a fonte ainda tem o antigo; o plano não tem Acesso à API (beta) (403).Não há dados neste intervalo
Não há dados neste intervalo
Alarga as datas do relatório ou espera pela próxima análise. O conector recusa uma tabela vazia: não desenha o gráfico a zeros. Os pontos seguem análises concluídas, na cadência do teu plano, não um fluxo contínuo minuto a minuto.
Regeneraste o token e o relatório parou
Regeneraste o token e o relatório parou
A fonte antiga fica inválida. Volta a ligar a fonte no relatório e troca-a para a nova.
Os dados não atualizam
Os dados não atualizam
Espera uns minutos e faz refresh da fonte. A API pode servir a resposta anterior durante cerca de 5 minutos.
O Data Studio devolve um erro HTTP ou JSON inválido
O Data Studio devolve um erro HTTP ou JSON inválido
Tenta mais tarde. O problema está no pedido, não na configuração do relatório.