Connecter Google Search Console au projet

Comment connecter Google Search Console au projet et lire la page Données GSC — cartes de métriques avec séries de graphique activables, 6 onglets (Requêtes, Pages, Pays, Appareils, Dates, Apparence), filtres de période et synchronisation manuelle.

Connecter Google Search Console est optionnel mais fortement recommandé. Cela vous donne accès aux données réelles de Google sur vos impressions, clics et CTR — des informations que Miraqo utilise pour :

  • Afficher le trafic organique estimé pour chaque mot-clé
  • Suggérer de nouveaux mots-clés (requêtes générant déjà des impressions mais pas encore suivies, voir Mots-clés du projet)
  • Distinguer la « position moyenne » affichée par Google du classement pur

GSC mesure comment Google voit votre site (impressions, clics, position). Pour le trafic réel sur le site (sessions, utilisateurs, conversions), il existe une intégration séparée et complémentaire : Google Analytics 4 ou Matomo.

Prérequis

  • Site déjà vérifié dans Google Search Console (avec le compte Google que vous utiliserez pour la connexion)
  • Permission d’accès aux données GSC du site (propriétaire ou utilisateur délégué)

Si le site n’est pas encore vérifié dans GSC, faites d’abord cette étape sur le portail Google. Miraqo ne peut pas ajouter ou vérifier un nouveau site dans GSC — il peut uniquement lire les données de sites déjà vérifiés.

Procédure de connexion

  1. Ouvrez le projet → Paramètres → Général. Dans la grille, la première ligne contient la carte 🔍 Google Search Console.
  2. Cliquez sur Se connecter avec Google.
  3. Vous êtes redirigé vers Google : choisissez le compte ayant accès à GSC et cliquez sur Continuer.
  4. Accordez les permissions demandées (lecture seule : Miraqo n’écrit rien dans GSC).
  5. Retour sur Miraqo avec le message « Google Search Console connecté ! N propriétés trouvées ». Si le domaine du projet correspond à une seule propriété GSC, elle est sélectionnée automatiquement. Sinon, choisissez la bonne dans la liste déroulante Propriété GSC utilisée (https://exemple.fr/ vs sc-domain:exemple.fr) et cliquez sur Enregistrer.

La carte Google Search Console dans Paramètres → Général, avant la connexion, avec le bouton Se connecter avec Google mis en évidence

La même carte après la connexion : statut GSC connectée avec la propriété, les boutons Voir les données et Déconnecter, et la liste déroulante Propriété GSC utilisée avec Enregistrer mise en évidence

La première synchronisation démarre automatiquement et importe les 90 derniers jours de données. Pour les projets avec de nombreuses requêtes, cela peut prendre 1 à 2 minutes. Sous la liste déroulante, la carte indique la date et l’heure de la dernière synchronisation.

Changer de propriété après la connexion : depuis la même carte dans Paramètres, si vous avez plusieurs propriétés disponibles sur le compte, vous pouvez changer la propriété utilisée depuis la liste déroulante sans avoir à vous reconnecter. Le bouton 📊 Voir les données mène directement à la page Données GSC.

La page Données GSC

Accédez-y depuis la barre latérale du projet → Google Search Console.

En-tête et actions

  • Titre « Google Search Console » + domaine du projet
  • Bouton 🔄 Synchroniser — force une nouvelle récupération des données (pour les rôles ayant la permission de synchronisation)
  • Sélecteur de période — puces 7j / 28j / 90j pour choisir l’intervalle ; change toute la page et les tableaux

L’en-tête de la page Google Search Console avec le domaine du projet et, à droite, le bouton Synchroniser et les puces 7 j, 28 j et 90 j mis en évidence

États possibles avant les données

  • GSC non connecté — état vide avec bouton « Aller aux Paramètres »
  • Connecté mais aucune propriété sélectionnée — bannière ⚠️ avec bouton Paramètres
  • Aucune donnée synchronisée — état vide avec bouton « 🔄 Synchroniser maintenant » (arrive juste après la première connexion)

Les 4 cartes de métriques

Cliquables comme interrupteurs : activent/désactivent la série correspondante dans le graphique ci-dessous. Pour chaque métrique, vous voyez la valeur totale de la période + la variation en pourcentage (quand elle est comparable) :

  • Clics totaux (actif par défaut)
  • Impressions totales (actif par défaut)
  • CTR moyen (inactif par défaut)
  • Position moyenne (inactif par défaut)

Le graphique sous les cartes montre l’évolution quotidienne des séries actives, avec l’axe des clics à gauche et celui des impressions à droite.

Les quatre cartes de métriques mises en évidence : Clics totaux et Impressions totales actives avec la variation en pourcentage, CTR moyen et Position moyenne inactives, et en dessous le graphique quotidien des deux séries actives

Les 6 onglets

Sous le graphique, des onglets pour explorer les données GSC sous différents angles. Les onglets Requêtes, Pages et Pays indiquent entre parenthèses le nombre de lignes qu’ils contiennent. Tous les tableaux sont triables en cliquant sur l’en-tête de colonne.

La barre des six onglets mise en évidence (Requêtes, Pages, Pays, Appareils, Dates, Apparence) avec en dessous le tableau des requêtes trié par clics

🔎 Requêtes

Tableau des requêtes avec Clics, Impr., CTR et Pos. Les cellules CTR et Pos. sont colorées pour signaler les valeurs « bonnes » vs « à améliorer ».

📄 Pages

Tableau des URL positionnées du site, avec les 4 mêmes métriques. Les pages sont des liens (ouverture dans un nouvel onglet).

🌍 Pays

Distribution du trafic organique par pays (avec code ISO).

📱 Appareils

Cartes de synthèse pour Desktop, Tablette et Mobile, chacune avec les 4 indicateurs en grille 2×2.

L’onglet Appareils avec les trois cartes Desktop, Tablette et Mobile mises en évidence, chacune avec clics, impressions, CTR et position

📅 Dates

Tableau jour par jour (utile pour un export manuel ou pour examiner des journées précises).

✨ Apparence

Distribution par type de résultat enrichi (Résultats enrichis, Vidéo, Images, FAQ, Avis, Product Snippets, …), une carte par type avec les mêmes 4 indicateurs. Voyez quelles fonctionnalités Google utilise pour afficher votre site dans les SERP.

L’onglet Apparence avec la carte Product Snippets mise en évidence : clics, impressions, CTR et position de ce type de résultat

Synchronisation

Miraqo actualise automatiquement chaque jour les données GSC sur la fenêtre complète de 90 jours. Vous pouvez aussi forcer une synchronisation manuelle avec le bouton 🔄 Synchroniser dans l’en-tête (consommation : 1 appel API GSC par jour, sans limite de plan dédiée).

Alerte de baisse de trafic. Après chaque synchronisation, Miraqo compare les clics des 7 derniers jours disponibles aux 7 précédents : s’ils baissent d’au moins 30 % et que la semaine de comparaison comptait au moins 50 clics, toute personne ayant coché la case Baisses dans les notifications du projet reçoit un e-mail, au plus un par semaine.

Fraîcheur des données Google. Search Console consolide les données avec un délai de 2 à 3 jours. Pour éviter d’afficher des baisses fictives, les sparklines et les deltas en pourcentage du Dashboard s’arrêtent à la limite de fraîcheur (environ aujourd’hui − 2 jours) : les 1 à 2 derniers jours pas encore consolidés sont exclus des comparaisons. Il est normal que le Dashboard n’affiche pas « hier ».

Déconnexion

Paramètres → Général → 🔍 Google Search Console → Déconnecter. Confirmation requise. L’historique des données déjà importées reste visible sur la page Données GSC, mais vous ne recevrez plus de nouvelles mises à jour tant que vous ne vous reconnectez pas.

Vous pouvez aussi révoquer l’accès côté Google : Compte Google → Sécurité → Applications tierces. Après la révocation, la prochaine synchronisation échouera avec invalid_grant (voir ci-dessous).

Erreurs courantes

  • « invalid_grant » pendant la synchronisation — le token a été révoqué (changement de mot de passe Google, expiration, accès révoqué manuellement ou application retirée du compte Google). Allez dans Paramètres → Général, cliquez sur Déconnecter puis reconnectez-vous.
  • Aucune propriété n’apparaît dans le sélecteur — le compte Google choisi n’a accès à aucune propriété GSC. Vérifiez que vous êtes connecté avec le bon compte et, si nécessaire, demandez au propriétaire du site de vous ajouter comme utilisateur dans GSC.
  • Propriétés listées mais aucune donnée — la propriété a été vérifiée depuis moins de 24 à 72h. Google met 1 à 3 jours pour peupler les données des nouvelles propriétés.
  • Synchronisation OK mais tableaux vides pour un onglet spécifique (ex. Pays/Apparence) — votre site n’a pas encore reçu de trafic/impressions de ce type, ou GSC n’a pas agrégé suffisamment de données. Ce n’est pas un bug de l’outil.

Ce qui change ailleurs après la connexion

  • Aperçu du projet — la carte « Indicateurs clés » affiche des données enrichies et le widget Analytics se corrèle mieux
  • Triage Dashboard — la colonne ∆ Impressions GSC apparaît, ainsi que la tendance des clics sur 30 jours dans la ligne du projet
  • Mots-clés du projet — dans Paramètres → Mots-clés, le panneau « 💡 Suggérés par Google Search Console » apparaît avec les requêtes entrantes à ajouter au suivi (clics et impressions des 28 derniers jours, bouton + Ajouter par ligne)
  • Prompts IA — dans Paramètres → Prompt IA, un panneau similaire apparaît avec des requêtes multi-mots de GSC comme prompts candidats

Le panneau « Suggérés par Google Search Console » dans l’onglet Mots-clés des Paramètres : liste des requêtes avec clics et impressions et le bouton Ajouter pour chaque ligne

Configuration initiale terminée. Vous pouvez maintenant :

Dernière mise à jour: 5 septembre 2026