Connecter LLM Pulse à Tableau
Vous pouvez créer des tableaux de bord Tableau sur vos données LLM Pulse sans écrire une ligne de code. Sur demande, l’API LLM Pulse renvoie une table simple, que Tableau lit grâce au REST API Connector publié par Tableau sur Tableau Exchange.
Pourquoi il n’existe pas de connecteur LLM Pulse pour Tableau
Le framework Web Data Connector de Tableau est obsolète. Pour les API comme la nôtre, Tableau recommande son REST API Connector, celui qu’utilise ce guide.
En pratique, la différence est minime pour vous : vous installez un connecteur fourni par Tableau au lieu d’un connecteur fourni par nous, et vous collez une URL.
Ce dont vous avez besoin
- Une clé API LLM Pulse. Les clés API sont disponibles à partir du forfait Scale. Créez-en une depuis le menu du compte > Clés API.
- Tableau Desktop 2023.3 ou version ultérieure.
- Le REST API Connector de Tableau, installé depuis Tableau Exchange. Il installe aussi un pilote : suivez les instructions d’installation de Tableau.
Étape 1 : construire l’URL des données
Seuls les endpoints de lecture tabulaires pris en charge acceptent output=csv. Ajoutez-le à un endpoint pris en charge pour obtenir une table plate que Tableau peut lire directement.
Le point de départ le plus courant est la série temporelle de vos métriques de visibilité :
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
L’ID de votre projet figure dans l’URL de n’importe quelle page du projet, et les ID de vos concurrents dans Concurrents ou via l’endpoint /dimensions/competitors.
Étape 2 : se connecter depuis Tableau
- Dans Tableau Desktop, choisissez Connexion > Vers un serveur > REST API.
- Collez l’URL de l’étape 1.
- Réglez l’authentification sur Bearer token et collez votre clé API LLM Pulse.
- Réglez le format de réponse sur CSV.
- Chargez les données.
Tableau crée un extrait avec une ligne par date, acteur et métrique.
Étape 3 : créer les vues
La table de série temporelle contient les colonnes suivantes :
| Colonne | Signification |
|---|---|
date |
Début du jour, de la semaine ou du mois, selon la granularité demandée |
actor_type |
project pour votre marque, competitor pour un concurrent suivi |
actor_name, actor_domain, actor_id
|
L’acteur concerné par la ligne |
metric |
La métrique que contient la ligne |
value |
La valeur, sur la même échelle que dans l’application |
Comme la table est au format long, une seule feuille de calcul peut représenter n’importe quelle métrique : placez date sur « Colonnes », value sur « Lignes », actor_name sur « Couleur », et filtrez sur metric. Ajoutez un second filtre sur metric et vous obtenez un tableau de bord complet à partir d’une seule source de données.
Autres tables utiles
Remplacez l’endpoint dans l’URL et conservez output=csv :
| Ce que vous voulez | Endpoint |
|---|---|
| Share of Voice dans le temps | /metrics/sov |
| Share of Voice actuel, avec classement |
/metrics/sov avec view=current
|
| 4 principaux concurrents, plus Autres |
/metrics/sov avec view=breakdown
|
| Performance par prompt | /metrics/prompt_summary |
| Domaines les plus cités | /metrics/top_sources |
| Mentions et citations individuelles |
/dimensions/mentions, /dimensions/citations
|
| Données Google Search Console |
/search_console/timeseries, /search_console/queries, /search_console/pages
|
Référence complète des paramètres : consultez la présentation de l’API REST ou la documentation de l’API.
Bon à savoir
- Les actualisations passent par des extraits, pas par une connexion en direct. Le REST API Connector de Tableau charge les données dans un extrait : planifiez donc une actualisation à la fréquence dont vous avez besoin. Les exécutions de prompts suivent la fréquence de suivi configurée pour votre compte : quotidienne, hebdomadaire ou mensuelle.
-
Comparez les marques sur les prompts hors marque. Ajoutez
brand_kind=non_brandà n’importe quelle URL de métriques pour comparer équitablement votre marque à ses concurrents. Les prompts qui nomment une marque favorisent naturellement cette marque. C’est ce que fait par défaut la Vue d’ensemble de l’application. -
Les endpoints paginés renvoient une page à la fois.
/metrics/prompt_summary,/metrics/top_sources, les listes/dimensions/*et les endpoints Search Console renvoient jusqu’à 100 lignes par requête. Le nombre total de lignes figure dans l’en-tête de réponseX-Total-Count: augmentezper_pageou parcourezpagepour tout charger. -
Les requêtes très volumineuses sont plafonnées. Une requête renvoie au maximum 200 000 lignes. Si vous atteignez cette limite, raccourcissez la période, demandez moins de métriques ou utilisez
granularity=week. -
Les cellules de texte sont échappées pour les tableurs. Un prompt qui commence par
=ou-est renvoyé précédé d’une apostrophe, pour ne jamais être interprété comme une formule.
Dépannage
Tableau affiche une seule colonne qui contient tout. Le format de réponse est réglé sur JSON. Passez-le en CSV dans les paramètres du connecteur.
Erreur 401 ou 403. Vérifiez que le jeton est envoyé comme Bearer token, que la clé est active dans menu du compte > Clés API et que votre forfait inclut l’accès à l’API (à partir de Scale). Les endpoints Search Console exigent en plus un forfait à partir de Growth et une propriété connectée.
Erreur 422 mentionnant output. Cet endpoint ne prend pas en charge la sortie tabulaire. Utilisez l’un des endpoints pris en charge listés ci-dessus.
Table vide. Vérifiez que l’ID du projet est correct et que la période couvre des exécutions. Pour un nouveau projet, attendez la fin de la première exécution de prompt avant de vous attendre à voir des données dans la table.
Tableau n’indique aucune colonne. Les tables de série temporelle, de synthèse et de Share of Voice renvoient toujours leur ligne d’en-tête, même pour une période vide. Les autres endpoints construisent leurs colonnes à partir des lignes elles-mêmes : une période sans données renvoie donc un fichier vide, sans en-tête, et Tableau n’a aucun schéma à lire. Pointez la connexion vers une période qui contient des données, puis actualisez.