Données AI Visibility dans Looker Studio

Connectez vos données de visibilité AI à Google Looker Studio pour des tableaux de bord et rapports personnalisés.

TL;DR

Générez une clé API personnelle dans les paramètres de votre compte, configurez le Community Connector Looker Studio (ou utilisez le connecteur JSON) et entrez votre clé API. Vos données de visibilité AI — y compris les scores de visibilité, le nombre de mentions et l'analyse de sentiment de ChatGPT, Gemini, Perplexity et Claude — seront disponibles comme source de données Looker Studio pour des tableaux de bord personnalisés.

Table des matières
  1. Qu'est-ce que l'intégration Looker Studio ?
  2. Prérequis
  3. Guide étape par étape
    1. Générer une clé API
    2. Configurer le connecteur
    3. Connecter vos données
  4. Champs de données disponibles
  5. Référence API
  6. Télécharger le script du connecteur
  7. FAQ

Qu'est-ce que l'intégration Looker Studio ?

L'intégration Looker Studio vous permet d'importer vos données de surveillance de visibilité AI dans Google Looker Studio (anciennement Google Data Studio). Cela vous permet de :

  • Créer des tableaux de bord personnalisés adaptés à vos besoins de reporting
  • Combiner les données de visibilité AI avec d'autres sources de données marketing
  • Partager des rapports interactifs avec votre équipe ou vos clients
  • Configurer des rapports automatisés par e-mail avec livraison programmée
  • Visualiser les tendances sur différentes plateformes d'IA au fil du temps

Chaque utilisateur accède uniquement à ses propres données via une clé API personnelle. Vos données ne sont jamais partagées avec d'autres utilisateurs.

Prérequis

  • Un compte AI Visibility Tool actif (tout plan)
  • Au moins un domaine thématique avec des résultats d'analyse terminés
  • Un compte Google avec accès à Looker Studio

Guide étape par étape

Étape 1 : Générer une clé API

  1. Connectez-vous à votre compte AI Visibility Tool.
  2. Cliquez sur votre adresse e-mail dans le menu en haut à droite.
  3. Select "API Keys" from the dropdown menu under "Integrations".
  4. Cliquez sur "Créer une clé API" et donnez-lui un nom descriptif (p. ex. "Looker Studio").
  5. Copiez la clé API immédiatement — elle ne sera affichée qu'une seule fois.
Important : La clé API n'est affichée qu'une seule fois après la création. Conservez-la en lieu sûr. Si vous la perdez, vous devrez créer une nouvelle clé.

Votre clé API commence par le préfixe avt_ suivi de 48 caractères. Vous pouvez avoir jusqu'à 3 clés API actives en même temps.

Étape 2 : Configurer le connecteur

Il existe deux façons de connecter vos données à Looker Studio :

Option A : Community Connector (Recommandé)
  1. Téléchargez le script du connecteur (voir ci-dessous).
  2. Allez sur script.google.com et créez un nouveau projet.
  3. Collez le code du script du connecteur dans l'éditeur.
  4. Mettez à jour la API_BASE_URL variable vers votre URL de déploiement.
  5. Déployez le script : Cliquez sur "Déployer" → "Nouveau déploiement" → Type : "Module complémentaire" → Déployer.
  6. Copiez l'ID de déploiement pour l'utiliser dans Looker Studio.
Option B : Connecteur JSON (Aucun script requis)
  1. Open Looker Studio and click "Create" → "Data Source".
  2. Search for the "JSON" or "Custom JSON/CSV" connector.
  3. Entrez l'URL de l'API : https://your-domain.com/api/v1/looker/data
  4. Ajoutez l'en-tête d'autorisation : Authorization: Bearer YOUR_API_KEY
  5. Configurez les paramètres de date selon vos besoins.

Étape 3 : Connecter vos données

  1. In Looker Studio, click "Create" → "Data Source".
  2. Sélectionnez votre connecteur (Community Connector ou connecteur JSON).
  3. Entrez votre clé API lorsque vous y êtes invité.
  4. Click "Connect" — the available fields will be loaded automatically.
  5. Click "Create Report" to start building your dashboard.
Conseil : Commencez par un graphique de plage de dates et un tableau montrant les scores de visibilité par système d'IA pour obtenir un aperçu rapide de vos données.

Champs de données disponibles

Les dimensions et métriques suivantes sont disponibles dans Looker Studio :

Dimensions

Champ Tapez Description
date Date La date à laquelle l'analyse a été effectuée (AAAA-MM-JJ)
topic_area Texte Nom du domaine thématique (sélection) surveillé
prompt Texte Le texte du prompt envoyé au système d'IA
category Texte Catégorie assignée au prompt
funnel_stage Texte Étape de l'entonnoir marketing (p. ex. Sensibilisation, Considération, Décision)
ai_system Texte La plateforme d'IA interrogée (p. ex. ChatGPT, Gemini, Perplexity, Claude)
brand Texte La marque suivie pour les mentions

Métriques

Champ Tapez Description
visibility_score Nombre Score de visibilité global (0–100) pour la marque dans la réponse de l'IA
mention_count Nombre Nombre de fois que la marque a été mentionnée dans la réponse de l'IA
position_score Nombre Score de classement de position — des valeurs plus élevées indiquent des mentions plus précoces
sentiment_score Nombre Score de sentiment de -1 (négatif) à +1 (positif)
web_search_used Booléen Si le système d'IA a utilisé la recherche web pour générer la réponse

Référence API

L'API REST utilise votre clé API personnelle pour l'authentification. Tous les endpoints renvoient du JSON.

Authentification

Incluez votre clé API dans chaque requête en utilisant l'une de ces méthodes :

  • En-tête (recommandé) : Authorization: Bearer avt_your_key_here
  • Paramètre de requête : ?api_key=avt_your_key_here

Endpoints

GET /api/v1/looker/schema

Renvoie le schéma (définitions de champs) pour la source de données.

Exemple de requête :

curl -H "Authorization: Bearer avt_your_key_here" \
  https://your-domain.com/api/v1/looker/schema
GET /api/v1/looker/data

Renvoie les données de visibilité réelles. Prend en charge le filtrage et la pagination.

Paramètres :

Paramètre Tapez Description
date_from String Date de début (AAAA-MM-JJ)
date_to String Date de fin (AAAA-MM-JJ)
selection_id Entier Filtrer par ID de domaine thématique
ai_system String Filtrer par système d'IA (p. ex. chatgpt, gemini, perplexity, claude)
limit Entier Nombre d'enregistrements à renvoyer (par défaut : 1000)
offset Entier Nombre d'enregistrements à ignorer (par défaut : 0)

Exemple de requête :

curl -H "Authorization: Bearer avt_your_key_here" \
  "https://your-domain.com/api/v1/looker/data?date_from=2025-01-01&date_to=2025-01-31&limit=500"
GET /api/v1/looker/selections

Renvoie une liste de vos domaines thématiques (sélections) avec leurs IDs. Utilisez ces IDs pour filtrer les requêtes de données.

Exemple de requête :

curl -H "Authorization: Bearer avt_your_key_here" \
  https://your-domain.com/api/v1/looker/selections

Limite de débit : L'API autorise jusqu'à 100 requêtes par minute par clé API. Looker Studio met les données en cache automatiquement, cette limite est donc rarement atteinte en utilisation normale.

Télécharger le script du connecteur

Téléchargez le fichier Google Apps Script pour le Community Connector :

Télécharger le script du connecteur (connector.gs)

Après le téléchargement, ouvrez le fichier dans un éditeur de texte, mettez à jour l'API_BASE_URL, puis collez le code dans un nouveau projet Google Apps Script.

FAQ

L'intégration Looker Studio est disponible sur tous les plans, y compris le plan gratuit. Chaque utilisateur peut générer des clés API et connecter ses données à Looker Studio.

Non. Chaque clé API est liée à votre compte personnel. L'API ne renvoie que les données de vos propres domaines thématiques et résultats d'analyse. Il n'est pas possible d'accéder aux données d'un autre utilisateur.

Vous pouvez avoir jusqu'à 3 clés API actives en même temps. Vous pouvez supprimer les clés inutilisées et en créer de nouvelles à tout moment.

Les clés API ne sont affichées qu'une seule fois lors de la création pour des raisons de sécurité. Si vous perdez une clé, supprimez-la de votre page Clés API et créez-en une nouvelle. Mettez ensuite à jour la clé dans la configuration de votre source de données Looker Studio.

Looker Studio récupère des données fraîches de l'API chaque fois qu'un rapport est ouvert ou actualisé. Vous pouvez également configurer les paramètres de fraîcheur des données de Looker Studio. Les données de visibilité AI sous-jacentes sont mises à jour chaque fois que vous exécutez de nouvelles analyses dans l'outil.

Assurez-vous que votre clé API est correcte et toujours active. Vérifiez la page Clés API de votre compte pour confirmer le statut de la clé. Si la clé a été supprimée ou désactivée, créez-en une nouvelle et mettez-la à jour dans les paramètres de votre connecteur Looker Studio.

Oui. L’API REST est une API JSON standard qui fonctionne avec tout outil capable d’envoyer des requêtes HTTP — y compris Excel, Google Sheets, Power BI, Tableau, les scripts Python et plus encore.
Retour à la documentation