Como utilizar o conector do Looker Studio
O conector do Looker Studio da LLM Pulse permite visualizar os dados de visibilidade em IA no Looker Studio, anteriormente denominado Google Data Studio. Crie painéis de controlo com dados atualizados sobre menções, citações, visibilidade, sentimento e comparações com concorrentes. Depois, partilhe-os com a equipa ou com clientes sem lhes dar acesso à LLM Pulse.
Com o conector do Looker Studio, pode:
- Criar no Looker Studio painéis de controlo de visibilidade em IA atualizados com os dados da LLM Pulse
- Escolher entre quatro conjuntos de dados: Brand trends, Prompts, Share of Voice e Cited sources
- Filtrar e dividir qualquer gráfico por modelo de IA, país, idioma, etiqueta, foco da marca ou tipo de Prompt, diretamente no relatório
- Combinar métricas de visibilidade em IA com outras fontes de dados de marketing
- Partilhar painéis com clientes ou outras partes interessadas sem lhes dar acesso à LLM Pulse
- Começar com um modelo pronto a usar, sem ter de construir um relatório de raiz
Antes de começar
Precisa de dois elementos:
- Um plano Scale ou superior. O conector autentica-se com uma chave de API.
-
Uma chave de API da LLM Pulse. Abra o menu do perfil, no canto inferior esquerdo da aplicação, aceda a Chaves de API e crie uma chave, caso ainda não tenha. As chaves começam por
llmpulse_. Mantenha-a privada: qualquer pessoa que tenha a chave pode ler os dados do projeto a que esta dá acesso.
Início rápido
Há três formas de começar. A maioria das pessoas começa pelo modelo pronto a usar.
- Modelo pronto a usar (mais rápido): crie uma cópia do painel pré-configurado e associe-a aos seus dados. Abrir o modelo
- Conector (criar de raiz): adicione a fonte de dados e conceba o seu próprio relatório. Adicionar o conector
- Vídeo de demonstração: prefere acompanhar os passos? Ver o vídeo de configuração
Também pode aceder aos três recursos em Integrações na barra lateral da LLM Pulse.
Configurar o conector
A configuração pede apenas dois elementos: um projeto e um conjunto de dados. Tudo o resto (datas, granularidade, métricas e filtros) é escolhido no relatório, como em qualquer outra fonte de dados do Looker Studio.
1. Adicionar a fonte de dados
Abra o link do conector e autorize o acesso com a sua conta Google, se o Looker Studio o solicitar.
2. Introduzir a chave de API
Na etapa de credenciais seguras, o Looker Studio pede a chave de API llmpulse_. Introduza-a e avance. O conector valida a chave antes de apresentar as definições. A chave fica guardada como credencial privada do utilizador, não como campo de configuração do relatório.
3. Escolher um projeto e um conjunto de dados
Escolha o projeto que pretende visualizar e, depois, o Data set, que determina o que representa cada linha:
- Brand trends: métricas da sua marca e de cada concorrente monitorizado ao longo do tempo. É o conjunto de dados utilizado pelo modelo pronto a usar.
- Prompts: uma linha por Prompt, com o respetivo texto, link, classificação e métricas de visibilidade, citações e sentimento.
- Share of Voice: a parte de cada marca no total de menções de marcas ao longo do tempo.
- Cited sources: os domínios citados nas respostas de IA, ordenados pelo número de respostas que os citam.
Para combinar vários conjuntos de dados num relatório, adicione o conector uma vez por cada conjunto de dados.
4. Ligar
Clique em Connect, no canto superior direito. A fonte de dados fica pronta e pode arrastar os campos para qualquer gráfico ou tabela.
Criar gráficos e filtros no relatório
- As datas seguem o relatório. O conector lê sempre o período do controlo de intervalo de datas do relatório (os últimos 28 dias, se o relatório não tiver nenhum).
- Escolha a granularidade com o campo de data. Utilize Date para dados diários, Week para dados semanais ou Month para dados mensais. As taxas, como Visibility, são calculadas para o período representado no gráfico. Assim, um gráfico semanal mostra a taxa real de cada semana, e não uma média dos dias. Os gráficos sem campo de data, como as tabelas de dados (o gráfico que resume uma única métrica), mostram um único total para todo o intervalo de datas: as contagens são somadas e as taxas, como Visibility, são calculadas para todo o intervalo.
- Filtre ou divida os dados por segmento. AI Model, Country, Language, Tag, Brand Focus e Prompt Type são dimensões normais. Adicione uma delas a um gráfico para o dividir, ou adicione um controlo de filtro (uma lista pendente, por exemplo) para que os leitores escolham os valores. Por exemplo, uma lista pendente em Tag permite aos leitores ver uma etiqueta de cada vez.
- As métricas são obtidas a pedido. O conector só pede à LLM Pulse as métricas utilizadas nos gráficos.
Cada combinação de valores de segmento num gráfico corresponde a um pedido separado à LLM Pulse, pelo que um gráfico pode dividir os dados em 40 combinações, no máximo (8 em Cited sources). Se um gráfico ultrapassar esse limite, o conector indica-o: adicione um filtro a um dos segmentos ou remova um deles do gráfico.
Utilizar o modelo pronto a usar
Se preferir não começar de raiz:
- Abra o modelo.
- Clique em Use my own data ou Make a copy, no canto superior direito.
- Quando lhe for pedido, adicione o conector da LLM Pulse e autorize-o com a chave de API.
- Selecione o projeto e o conjunto de dados Brand trends. Os gráficos são preenchidos com os seus dados.
O modelo já inclui os gráficos essenciais de visibilidade em IA para que tenha um painel funcional em poucos cliques.
Campos disponíveis
Brand trends, Share of Voice e Cited sources partilham estas dimensões de segmento:
| Campo | Descrição |
|---|---|
| AI Model | Modelo de IA que produziu as respostas |
| Country | País do Prompt (código ISO) |
| Language | Idioma do Prompt (código ISO) |
| Tag | Etiqueta do Prompt. Um Prompt com várias etiquetas conta uma vez em cada uma, e os Prompts sem etiquetas ficam de fora quando o gráfico é dividido por etiqueta |
| Brand Focus | brand, brandother ou nonbrand. Utilize non_brand para comparar a sua marca com os concorrentes em condições justas |
| Prompt Type | informational, navigational, commercial ou transactional |
Brand trends
| Campo | Tipo | Descrição |
|---|---|---|
| Date, Week, Month | Dimensão | Período do ponto de dados |
| Actor Type | Dimensão | "project" (a sua marca) ou "competitor" |
| Actor Name | Dimensão | Nome da marca ou do concorrente |
| Actor Domain | Dimensão | Domínio da marca ou do concorrente |
| Actor ID | Dimensão | ID interno do projeto ou do concorrente |
| Visibility | Métrica | Proporção de respostas que mencionam a marca |
| Mentions | Métrica | Respostas que mencionam a marca |
| Responses | Métrica | Respostas recolhidas (consulte Informações úteis) |
| AI Visibility Score | Métrica | Visibilidade ponderada pela posição (um valor superior é melhor) |
| Average Mention Position | Métrica | Posição média da marca entre as marcas referidas nas respostas que a mencionam (um valor inferior é melhor) |
| Citations | Métrica | Respostas que citam o URL da marca. Inclui citações visíveis e referências de fontes em segundo plano |
| Average Position | Métrica | Posição média do URL da marca entre os URL que uma resposta cita (só citações visíveis; um valor inferior é melhor) |
| Citation Rate | Métrica | Proporção de respostas que citam o URL da marca |
| Sentiment (5 levels) | Métrica | Proporção das avaliações de sentimento sobre a marca em cada nível, de muito positivo a muito negativo |
| Net Sentiment Score | Métrica | Equilíbrio geral do sentimento, entre -100 e 100 |
Prompts
| Campo | Tipo | Descrição |
|---|---|---|
| Prompt ID, Prompt | Dimensão | O Prompt e o respetivo ID interno |
| Prompt Link | Dimensão | Abre o Prompt na LLM Pulse |
| Prompt Tags | Dimensão | Nomes das etiquetas separados por "; " (filtre com "Contém") |
| AI Model | Dimensão | Ao adicionar esta dimensão, cada Prompt passa a ter uma linha por modelo |
| Country, Language, Brand Focus, Prompt Type | Dimensão | A classificação do Prompt |
| Responses | Métrica | Respostas recolhidas para o Prompt no período |
| Mentions, Visibility | Métrica | Respostas que mencionam a sua marca, em número e em proporção |
| Average Mention Position | Métrica | Posição média da sua marca entre as marcas referidas nas respostas que a mencionam |
| Citations, Citation Rate | Métrica | Respostas que citam o URL da sua marca, em número e em proporção |
| Average Citation Position | Métrica | Posição média do URL citado da sua marca entre os URL que uma resposta cita |
| Sentiment Responses | Métrica | Respostas com uma avaliação de sentimento sobre a sua marca |
| Sentiment (5 levels), Net Sentiment Score | Métrica | Sentimento das respostas ao Prompt, como proporções de Sentiment Responses |
Share of Voice
| Campo | Tipo | Descrição |
|---|---|---|
| Date, Week, Month | Dimensão | Período do ponto de dados |
| Actor Type / Name / Domain / ID | Dimensão | As mesmas dimensões de entidade que em Brand trends |
| Share of Voice | Métrica | Parte de todas as menções de marcas do período atribuída à marca |
Cited sources
| Campo | Tipo | Descrição |
|---|---|---|
| Domain | Dimensão | O domínio citado |
| Responses Citing Domain | Métrica | Respostas de IA distintas que citam o domínio |
| Domain Citation Rate | Métrica | Proporção de todas as respostas que citam o domínio |
Informações úteis
Alguns comportamentos que costumam causar confusão:
-
As percentagens usam uma escala de 0 a 1. O Looker Studio espera que os campos percentuais estejam entre 0 e 1. Por isso, uma Visibility de 45% surge como
0.45. Está correto: o Looker Studio acrescenta automaticamente o símbolo % nos gráficos. O valor é igual ao da API REST (45), mas apresentado noutra escala. - Os campos de sentimento são proporções, não filtros. Neutral Sentiment é a proporção de avaliações neutras entre as respostas com sentimento sobre a sua marca. Nunca altera Responses: um Prompt com 32 respostas, 13 delas neutras, mostra 32 respostas e cerca de 41% de sentimento neutro. Utilize Sentiment Responses no conjunto de dados Prompts para obter a contagem de base.
- Responses repete-se em cada linha de entidade. Em Brand trends, cada linha de marca e de concorrente tem a mesma contagem de Responses, pelo que um gráfico que some Responses de várias entidades multiplica esse valor. Filtre por Actor Type = project ou divida o gráfico por entidade.
- Todos os concorrentes são incluídos. Brand trends e Share of Voice incluem sempre a sua marca e todos os concorrentes do projeto. Filtre por Actor Name para restringir a comparação.
- É normal haver intervalos sem dados nos gráficos. As execuções de Prompts seguem a frequência de monitorização configurada na conta: diária, semanal ou mensal. Nos dias sem execuções, os gráficos não têm dados de execução. Por isso, se a frequência for semanal ou mensal, utilize Week ou Month nos gráficos.
Alterar a configuração mais tarde
Para mudar de projeto ou de conjunto de dados após a configuração:
- No Looker Studio, aceda a Resource → Manage added data sources.
- Clique em Edit na fonte de dados da LLM Pulse.
- Clique em Edit connection, atualize o projeto ou o conjunto de dados e clique em Reconnect.
Mudar de conjunto de dados altera os campos disponíveis. Por isso, os gráficos que utilizam campos que o novo conjunto de dados não tem precisam de ser atualizados.
Fontes de dados criadas com a configuração clássica
As fontes de dados adicionadas antes de outubro de 2026 continuam a funcionar exatamente como antes, com a configuração clássica: um tipo de relatório, caixas de verificação de métricas, filtros, concorrentes, um intervalo de datas e uma granularidade escolhidos na configuração da fonte de dados. Nada muda nos relatórios existentes.
Na configuração clássica:
- As caixas de verificação Include ... Sentiment e as restantes caixas de métricas só determinam as métricas a obter quando um gráfico não pede nenhuma. Nunca filtram respostas e não têm efeito no tipo de relatório Prompt performance.
- Os filtros, os concorrentes e o intervalo de datas aplicam-se a toda a fonte de dados. Escolha Follow report date range para utilizar o controlo de intervalo de datas do relatório.
Para passar um relatório para a nova configuração, adicione novamente o conector (que abre com a nova configuração), escolha o mesmo projeto e o conjunto de dados correspondente (Brand trends para Timeseries, Prompts para Prompt performance, Share of Voice para Share of Voice e Cited sources para Top Sources) e, depois, mude os gráficos para a nova fonte de dados. Brand trends e Share of Voice mantêm os nomes de campos clássicos, pelo que os respetivos gráficos continuam a funcionar.
Resolução de problemas
"Unable to fetch data"
Confirme que a chave de API está ativa e começa por llmpulse_, que o projeto selecionado ainda existe e que o seu plano Scale ou superior está ativo. Volte a ligar a fonte de dados se o Looker Studio pedir novamente a chave.
"This chart splits the data into more than 40 combinations"
O gráfico utiliza demasiadas dimensões de segmento em simultâneo (por exemplo, AI Model, Country e Language em conjunto). Adicione um filtro a uma delas ou remova uma do gráfico.
Sem dados nos gráficos
Amplie o intervalo de datas do relatório, utilize Week ou Month nos gráficos de acordo com a frequência de monitorização da conta e verifique os filtros do relatório em AI Model, Country, Language e Tag.
Os dados parecem desatualizados
O Looker Studio guarda os resultados em cache. Utilize Refresh data no relatório ou na fonte de dados. Os dados subjacentes são atualizados quando terminam as execuções de Prompts, de acordo com a frequência de monitorização da conta.
Um concorrente não apresenta dados
Pode não haver menções no intervalo de datas ou com os filtros selecionados. Confirme se o concorrente existe em Preferências → Concorrentes na barra lateral da LLM Pulse.
Perguntas frequentes
É possível combinar estes dados com os do Google Analytics ou do Search Console?
Sim. Utilize a combinação de dados do Looker Studio e associe os conjuntos pelo campo Date para combinar dados da LLM Pulse com qualquer outra fonte.
É possível criar campos calculados?
Sim. Crie campos calculados personalizados no Looker Studio a partir de qualquer uma das métricas acima, por exemplo, para calcular rácios próprios ou combinar pontuações.
É possível adicionar mais do que uma fonte de dados da LLM Pulse a um relatório?
Sim. Adicione o conector uma vez por cada projeto ou conjunto de dados e utilize-os em conjunto no mesmo relatório.
O controlo de intervalo de datas do Looker Studio funciona?
Sim. O conector obtém sempre exatamente o período selecionado no controlo de intervalo de datas do relatório. As fontes de dados clássicas fazem o mesmo quando o intervalo de datas está definido como Follow report date range.
Os leitores podem filtrar por etiqueta ou por modelo de IA?
Sim. Adicione um controlo de lista pendente em Tag, AI Model ou qualquer outro segmento, e os leitores podem mudar de valor sem editar o relatório.
É possível utilizar o conector num plano gratuito ou Starter?
Não. O conector requer uma chave de API, disponível nos planos Scale e superiores.
