Como ligar a LLM Pulse ao Tableau
Pode criar painéis de controlo no Tableau com os dados da LLM Pulse sem escrever código. A API da LLM Pulse pode devolver uma tabela simples mediante pedido, que o Tableau lê através do REST API Connector publicado no Tableau Exchange.
Porque não existe um conector da LLM Pulse para o Tableau
A LLM Pulse não disponibiliza um conector próprio para o Tableau. Este guia utiliza o REST API Connector do Tableau para carregar a saída CSV de endpoints compatíveis da API da LLM Pulse.
O que é necessário
- Uma chave de API da LLM Pulse. As chaves de API requerem um plano Scale ou superior. Crie uma no menu do perfil > Chaves de API.
- Tableau Desktop 2023.3 ou posterior.
- O REST API Connector do Tableau, disponível no Tableau Exchange. Também instala um controlador; siga as instruções de instalação do Tableau.
Passo 1: criar o URL dos dados
Apenas os endpoints de leitura tabular compatíveis aceitam output=csv. Acrescente-o a um endpoint compatível para obter uma tabela que o Tableau possa ler diretamente.
Um ponto de partida habitual é a série temporal das suas métricas de visibilidade:
https://api.llmpulse.ai/api/v1/metrics/timeseries?project_id=YOUR_PROJECT_ID&range=90&granularity=week&metrics=mentions,visibility,citation_rate,ai_visibility_score&competitors=ALL_COMPETITOR_IDS&output=csv
Pode encontrar o ID do projeto no URL de qualquer página do projeto e os IDs dos concorrentes na página Concorrentes ou no endpoint /dimensions/competitors.
Passo 2: ligar a partir do Tableau
- No Tableau Desktop, selecione Connect > To a Server > REST API.
- Cole o URL criado no passo 1.
- Defina a autenticação como Bearer token e introduza a chave de API da LLM Pulse.
- Defina o formato da resposta como CSV.
- Carregue os dados.
O Tableau cria uma extração com uma linha por data, ator e métrica.
Passo 3: criar as vistas
A tabela de séries temporais tem estas colunas:
| Coluna | Significado |
|---|---|
| date | Início do dia, da semana ou do mês, consoante a granularidade pedida |
| actor_type | project para a sua marca ou competitor para um concorrente monitorizado |
| actorname, actordomain, actor_id | Entidade a que a linha diz respeito |
| metric | Métrica representada na linha |
| value | Valor na mesma escala que a apresentada na aplicação |
Como a tabela está em formato longo, uma folha de cálculo pode representar qualquer métrica: coloque date nas colunas, value nas linhas, actor_name na cor e filtre por metric. Acrescente um segundo filtro por metric para criar um painel completo a partir de uma única fonte de dados.
Outras tabelas úteis
Altere o endpoint do URL e mantenha output=csv:
| Pretende obter | Endpoint |
|---|---|
| Share of Voice ao longo do tempo | /metrics/sov |
| Instantâneo ordenado de Share of Voice | /metrics/sov com view=current |
| Os quatro principais concorrentes e Others | /metrics/sov com view=breakdown |
| Desempenho por Prompt | /metrics/prompt_summary |
| Domínios mais citados | /metrics/top_sources |
| Menções e citações individuais | /dimensions/mentions, /dimensions/citations |
| Dados do Google Search Console | /searchconsole/timeseries, /searchconsole/queries, /search_console/pages |
Consulte a visão geral da API REST ou a documentação da API para ver a referência completa dos parâmetros.
Informações úteis
- As atualizações são extrações, não dados em direto. O REST API Connector do Tableau carrega os dados para uma extração. Agende as atualizações com a frequência necessária. As execuções de Prompts seguem a frequência de monitorização configurada na sua conta: diária, semanal ou mensal.
- Compare marcas com Prompts genéricos. Acrescente brandkind=nonbrand a qualquer URL de métricas para obter uma comparação equilibrada entre a sua marca e os concorrentes. Os Prompts que mencionam uma marca favorecem-na naturalmente. É esta a predefinição da página Visão geral na aplicação.
- Os endpoints paginados devolvem uma página de cada vez. /metrics/promptsummary, /metrics/topsources, as listas /dimensions/* e os endpoints do Search Console devolvem até 100 linhas por pedido. O número total de linhas é indicado no cabeçalho de resposta X-Total-Count. Aumente per_page ou percorra os valores de page para carregar todos os resultados.
- As consultas de grande dimensão têm um limite. Um pedido devolve, no máximo, 200 000 linhas. Se atingir esse limite, reduza o intervalo de datas, peça menos métricas ou utilize granularity=week.
- As células de texto são protegidas para folhas de cálculo. Se um Prompt começar por = ou -, a resposta acrescenta um apóstrofo no início para que o valor nunca seja interpretado como fórmula.
Resolução de problemas
O Tableau apresenta todos os dados numa única coluna. O formato da resposta está definido como JSON. Altere-o para CSV nas definições do conector.
Erro 401 ou 403. Confirme que o token é enviado como Bearer token, que a chave está ativa em menu do perfil > Chaves de API e que o plano inclui acesso à API (Scale ou superior). Os endpoints do Search Console também requerem Growth ou superior e uma propriedade ligada.
Erro 422 que menciona output. Esse endpoint não suporta saída tabular. Utilize um dos endpoints compatíveis indicados acima.
Tabela vazia. Confirme se o ID do projeto está correto e se o intervalo de datas abrange um período com execuções. Num projeto novo, aguarde pela primeira execução de um Prompt antes de esperar que a tabela apresente dados.
O Tableau não apresenta colunas. As tabelas de séries temporais, resumo e Share of Voice devolvem sempre uma linha de cabeçalho, mesmo quando o período não tem dados. Nos outros endpoints, as colunas são criadas a partir das linhas. Por isso, se não houver dados no intervalo, o ficheiro não tem cabeçalho e o Tableau não tem um esquema para ler. Ligue-se a um intervalo com dados e atualize a extração.