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 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 painéis de controlo de visibilidade em IA atualizados com os dados da LLM Pulse
- Escolher entre quatro tipos de relatório: Timeseries, Prompt performance, Share of Voice e Top Sources
- 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, 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: prefira 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 passo a passo
A configuração é feita por etapas. Cada etapa fica disponível depois de fornecer as informações necessárias.
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 do projeto. A chave fica guardada como credencial privada do utilizador, não como campo de configuração do relatório.
3. Selecionar o projeto
Escolha no menu pendente o projeto que pretende visualizar. O conector carrega os respetivos concorrentes, etiquetas, Prompts, modelos e idiomas.
4. Escolher o tipo de relatório
A definição Report Type determina o que representa cada linha da fonte de dados:
- Timeseries (predefinição): métricas da marca e dos concorrentes ao longo do tempo. É o comportamento clássico do conector e o tipo utilizado pelo modelo.
- Prompt performance: uma linha por Prompt, com o respetivo ID, texto, classificação (foco da marca, tipo de Prompt, país, idioma e etiquetas) e métricas agregadas. Selecione Break down by model para separar os dados por modelo de IA.
- Share of Voice: percentagem de SoV da marca e dos concorrentes ao longo do tempo.
- Top Sources: domínios citados nas respostas de IA, ordenados pelo número de respostas que os citam.
Cada tipo de relatório disponibiliza os seus próprios campos. Para combinar vários tipos num relatório, adicione o conector uma vez por cada tipo.
5. Escolher as métricas
No relatório Timeseries, selecione as métricas a obter. Pode combinar:
- Núcleo: Mentions, Citations, Mention Rate (visibilidade), Average Position, AI Visibility Score, Responses e Citation Rate. Citations e Citation Rate incluem citações visíveis e referências de fontes no fundo da resposta. Average Position só considera citações visíveis.
- Sentimento: percentagens de Very Positive, Positive, Neutral, Negative e Very Negative, além do Net Sentiment Score.
Se não escolher métricas nesta etapa, o conector continua a funcionar e disponibiliza os campos pedidos pelos gráficos.
6. Adicionar filtros e escolher o intervalo de datas (opcional)
Reduza os resultados com uma ou mais destas opções:
- Competitors: selecione concorrentes específicos para comparar. Se não selecionar nenhum, todos são incluídos automaticamente (consulte a nota abaixo). Aplica-se a Timeseries e Share of Voice.
- Tag, Prompt, AI Model, Country, Language: filtros de seleção única para escolher uma parte dos dados. O menu de Prompts mostra cada um no formato "#id - texto", para os distinguir.
- Brand Focus: restrinja os resultados a prompts brand, competitor-brand ou non-brand. Utilize non-brand para comparar marcas e concorrentes em condições justas, como na predefinição da página Visão geral.
- Prompt Type: filtre por prompts dos tipos informational, navigational, commercial ou transactional.
- Domains e Domain search: disponíveis apenas em Top Sources. Restrinja a lista de domínios ou pesquise nela.
- Date range: últimos 7, 30, 90, 180 ou 365 dias; All time; ou Follow report date range, que utiliza o intervalo definido no relatório do Looker Studio.
- Granularity: diária, semanal ou mensal.
7. 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.
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. 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
Timeseries
| Campo | Tipo | Descrição |
|---|---|---|
| Date | Dimensão | Data 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 concorrente |
| Mentions | Métrica | Respostas de IA que mencionam a sua marca |
| Citations | Métrica | Respostas de IA que citam o URL da sua marca |
| Mention Rate | Métrica | Proporção de consultas em que a sua marca aparece |
| Average Position | Métrica | Posição média da citação visível, em que um valor inferior é melhor; exclui referências de fontes no fundo da resposta |
| AI Visibility Score | Métrica | Visibilidade ponderada pela posição, em que um valor superior é melhor |
| Responses | Métrica | Total de execuções de Prompts (consultas enviadas aos modelos de IA) |
| Citation Rate | Métrica | Proporção de respostas que citam esta entidade |
| Sentiment (5 levels) | Métrica | Proporção de respostas em cada nível, de muito positivo a muito negativo |
| Net Sentiment Score | Métrica | Equilíbrio geral do sentimento, entre -100 e 100 |
Prompt performance
| Campo | Tipo | Descrição |
|---|---|---|
| Prompt ID | Dimensão | ID interno do Prompt |
| Prompt | Dimensão | Texto do Prompt |
| Brand Focus | Dimensão | brand, brandother ou nonbrand |
| Prompt Type | Dimensão | informational, navigational, commercial ou transactional |
| Prompt Country | Dimensão | País em que o Prompt é executado |
| Prompt Language | Dimensão | Idioma do Prompt |
| Prompt Tags | Dimensão | Nomes das etiquetas separados por "; " |
| AI Model | Dimensão | Só é preenchido quando a opção Break down by model está ativa |
| Responses | Métrica | Execuções do Prompt no período |
| Mentions | Métrica | Respostas que mencionam a sua marca |
| Citations | Métrica | Respostas que citam a sua marca |
| Visibility | Métrica | Proporção de respostas ao Prompt que mencionam a sua marca |
| Citation Rate | Métrica | Proporção de respostas ao Prompt que citam a sua marca |
| Average Mention Position | Métrica | Posição média da menção à sua marca |
| Average Position | Métrica | Posição média da citação |
Share of Voice
| Campo | Tipo | Descrição |
|---|---|---|
| Date | Dimensão | Data do ponto de dados |
| Actor Type / Name / Domain / ID | Dimensão | As mesmas dimensões de entidade que em Timeseries |
| Share of Voice | Métrica | Parte de todas as menções do período atribuída à entidade |
Top Sources
| Campo | Tipo | Descrição |
|---|---|---|
| Domain | Dimensão | Domínio citado |
| Responses Citing Domain | Métrica | Número de respostas de IA distintas que citam o domínio |
| Domain Visibility | Métrica | Proporção das respostas de IA que citam o domínio |
Informações úteis
- 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 Mention Rate de 45% surge como 0.45. Está correto: os gráficos acrescentam automaticamente o símbolo %. O valor é igual ao da API REST (45), mas apresentado noutra escala.
- Sem seleção de concorrentes, são incluídos todos. Se deixar o filtro de concorrentes vazio, o conector inclui todos os concorrentes do projeto e a sua marca. Selecione concorrentes específicos para restringir a comparação. Os dados do próprio projeto são sempre incluídos.
- É 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 não há dados para apresentar; escolha uma granularidade que corresponda a essa frequência.
Alterar a configuração mais tarde
Para mudar de projeto, acrescentar filtros ou alterar o intervalo de datas 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.
- Atualize a configuração.
- Clique em Reconnect para aplicar as alterações.
Os gráficos que utilizam essa fonte de dados são atualizados automaticamente.
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.
Sem dados nos gráficos
Amplie o intervalo de datas para 90 ou 180 dias, ajuste a granularidade do gráfico à frequência de monitorização configurada na conta, confirme que selecionou pelo menos uma métrica e remova filtros restritivos de modelo, país ou idioma.
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 no Looker Studio a partir 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 várias vezes, com projetos ou filtros diferentes, e utilize-os em conjunto no mesmo relatório.
O controlo de intervalo de datas do Looker Studio funciona?
Sim. Defina o intervalo do conector como Follow report date range para que este obtenha exatamente o período selecionado no relatório. Com outra definição, o conector obtém o intervalo configurado (7 a 365 dias ou All time) e o controlo do relatório só filtra os dados já obtidos.
É 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.