GSC Connect — Documentation
Installer et utiliser Search Console Connect 2.0.0 : assistant de connexion Google, performances par produit et catégorie, inspection d'URL en masse, sitemaps, alertes, cron et sécurité.
Search Console Connect affiche vos données Google Search Console dans le back-office PrestaShop : clics, impressions, CTR et position par produit, catégorie, page CMS et requête, inspection d’URL en masse avec file d’attente, sitemaps et alertes par e-mail. Ce guide couvre l’installation, l’assistant de connexion Google, la lecture des rapports, l’inspection, les alertes, le cron, la sécurité et le dépannage. Version documentée : 2.0.0, compatible PrestaShop 1.7.8 à 9.
Indépendance vis-à-vis de Google. Ce module n’est ni affilié à Google, ni approuvé ou sponsorisé par Google. Il affiche les données renvoyées par l’API officielle Search Console avec votre propre client OAuth : vos données ne transitent pas par DataFirefly. Il ne garantit aucun gain de positionnement, de trafic ou d’indexation.

Installation
- Back-office → Modules → Gestionnaire de modules → Installer un module, puis déposez
dfgscconnect-2.0.0.zip. - Un menu Search Console apparaît avec six pages : Vue d’ensemble, Performances, Indexation, Sitemaps, Alertes, Connexion et paramètres.
- Ouvrez Connexion et paramètres : un assistant en 4 étapes vous guide (environ 10 minutes la première fois).
Prérequis
- PrestaShop 1.7.8, 8.x ou 9.x ; PHP 7.1 à 8.5 (testé en 7.4, 8.1 et 8.5) ; extensions
curletopenssl. - Un compte Google propriétaire ou utilisateur de la propriété Search Console de la boutique.
- Une tâche planifiée (cron) chez votre hébergeur pour l’automatisation.
Mise à jour depuis 1.0.x
Installez le nouveau zip par-dessus l’ancien. Le script de mise à jour conserve la connexion Google (les jetons sont chiffrés au passage), la propriété, les métriques (doublons fusionnés), les inspections, la file et les alertes. Les anciennes alertes ne sont pas renvoyées par e-mail.
Assistant de connexion Google

Étape 1 : créer votre client OAuth Google Cloud
- Sur console.cloud.google.com, créez un projet, puis dans API et services > Bibliothèque, activez Google Search Console API.
- Configurez l’écran de consentement (type Externe) avec le nom de la boutique et votre e-mail. Dans l’accès aux données, ajoutez le scope
https://www.googleapis.com/auth/webmasters.readonly(ouwebmasterssi vous voulez gérer les sitemaps depuis la boutique). - Créez un identifiant client OAuth de type Application Web et collez dans « URI de redirection autorisés » l’adresse affichée par le module (bouton Copier). En multiboutique, chaque boutique a sa propre adresse : ajoutez-les toutes au même client.
- Publiez l’application (statut « En production »). En statut « Test », Google invalide l’autorisation au bout de 7 jours et il faudrait se reconnecter chaque semaine. Pour votre propre usage, Google peut afficher « Google n’a pas validé cette application » : cliquez sur Paramètres avancés, puis continuez.
- Copiez le Client ID et le Client secret dans le module, choisissez l’accès demandé et enregistrez. Le secret est chiffré (AES-256) et n’est plus jamais affiché.
Quel accès choisir ? Lecture seule (recommandé) suffit pour les performances, l’inspection d’URL et le statut des sitemaps. Lecture + gestion des sitemaps permet en plus d’envoyer et de retirer des sitemaps depuis PrestaShop. Le module demande aussi openid email pour afficher quel compte Google est connecté.
Étape 2 : se connecter avec Google
Cliquez sur Se connecter avec Google, validez l’écran de consentement : vous revenez dans le back-office, connecté. Le compte, l’accès accordé et l’état de la connexion sont affichés ; Reconnecter et Déconnecter et révoquer sont disponibles.

Étape 3 : choisir la propriété
Le module liste les propriétés accessibles et met en avant celle qui couvre l’adresse de la boutique (une propriété de domaine sc-domain: couvre tous les sous-domaines ; une propriété avec préfixe d’URL couvre une adresse précise). Option avancée : adresse publique, si la boutique est servie à une autre adresse que celle définie dans PrestaShop (proxy, CDN).
Étape 4 : automatiser
Copiez l’URL cron (à garder privée) et programmez-la toutes les 15 minutes, par exemple : */15 * * * * curl -fsS "URL" >/dev/null. Le bouton Exécuter maintenant lance une passe immédiate. L’historique d’activité liste les dernières tâches et leurs erreurs éventuelles, expliquées en clair.

Le bouton Tester la connexion vérifie pas à pas : client OAuth, autorisation Google, accès à la propriété, lecture des performances, droit de gestion des sitemaps.
Vue d’ensemble
Clics, impressions, CTR et position moyenne de la propriété sur 7 jours à 16 mois, comparés à la période précédente ou à l’année précédente. Les totaux viennent de la dimension « date » de l’API : ce sont les mêmes chiffres que les graphiques de Search Console. La courbe affiche clics, impressions, CTR, position et la période de comparaison.

Plus bas : top produits, top catégories, top requêtes, pages qui perdent des clics, opportunités (requêtes en position 4 à 20 avec beaucoup d’impressions), santé de l’indexation, sitemaps et alertes ouvertes. Google publie ses données avec environ 2 jours de délai ; la dernière journée peut être incomplète.
Performances par produit, catégorie et requête

Onglets Produits, Catégories, Requêtes, Toutes les pages et Pages CMS : clics, évolution, impressions, CTR et position (moyenne pondérée par les impressions, comme Search Console), recherche, tri, pagination et export CSV (UTF-8 avec BOM, séparateur point-virgule).
Chaque URL Google est rattachée à sa page PrestaShop grâce aux routes de la boutique, y compris les règles personnalisées de « SEO et URL », le préfixe de langue et les URL non réécrites. Les paramètres (?utm_…, pagination, filtres) sont ignorés : toutes les variantes d’une page sont regroupées sous elle.

Le bouton de détail affiche les requêtes qui mènent à un produit, une catégorie ou une page (instantané des 28 derniers jours), ou les pages qui se positionnent sur une requête.

Le rapport Catégories affiche aussi les clics des produits dont c’est la catégorie par défaut.
Indexation : inspection d’URL en masse

Ajoutez à la file les pages vues dans Google (28 jours) (recommandé : ce sont les URL exactes connues de Google), tous les produits actifs, toutes les catégories, les pages CMS, les pages modifiées depuis leur dernière inspection, ou une liste d’URL collée. Les URL hors de la propriété sont ignorées. La file est traitée par le cron ; Exécuter la file maintenant la traite depuis la page avec une barre de progression.
Quotas Google. L’API d’inspection est limitée à 2 000 appels par jour et 600 par minute par propriété (remise à zéro à minuit, heure du Pacifique). Le module compte chaque appel, respecte vos plafonds (réglables plus bas), met la file en pause sur une erreur 429 et reprend seul ; une erreur de quota ne consomme pas de tentative.

Résultats filtrables : indexées, non indexées, erreurs, et pages pour lesquelles Google a choisi une autre URL canonique que celle déclarée.

Le détail affiche le verdict, l’état de couverture, l’indexation autorisée ou non, la récupération de la page, robots.txt, la dernière exploration, l’agent d’exploration, les URL canoniques déclarée et choisie par Google, les sitemaps, les pages de référence et les résultats enrichis détectés. L’inspection montre la version connue de Google (dernière exploration), pas un test en direct. « Non indexée » n’est pas toujours un problème : les pages avec une balise canonique vers une autre URL, redirigées ou en noindex sont exclues volontairement.
Sitemaps

Liste des sitemaps connus de Search Console avec leur statut (succès, en attente, erreurs, avertissements), les URL envoyées par type, la date d’envoi et la dernière lecture par Google. Le module détecte les sitemaps de la boutique (lignes Sitemap: du robots.txt, module Google sitemap, DataFirefly Sitemap) et permet, avec l’accès « gestion des sitemaps », de les envoyer, renvoyer ou retirer. Seules les URL couvertes par la propriété peuvent être envoyées ; retirer un sitemap ne supprime pas le fichier. Depuis 2023, Google ne communique plus le nombre d’URL indexées par sitemap.
Alertes

- Baisse de position et baisse de clics : 7 derniers jours consolidés comparés aux 7 jours précédents, par page et pour toute la propriété, avec seuils et minimums d’impressions ou de clics réglables.
- Page non indexée : une page indexée qui sort de l’index, ou une page qui apporte des clics et n’est pas indexée (hors exclusions volontaires).
- Erreurs de sitemap, connexion Google perdue, quota d’inspection atteint.
Les alertes sont dédoublonnées, se résolvent seules quand le problème disparaît, et peuvent être marquées lues ou résolues en masse.

Le résumé par e-mail (quotidien, hebdomadaire ou à chaque passage du cron) part vers jusqu’à 10 destinataires, dans la langue choisie. Un bouton envoie un e-mail de test.

Réglages
| Réglage | Défaut | Rôle |
|---|---|---|
| Historique à importer | 16 mois | Profondeur chargée au premier passage, un mois par exécution du cron (Search Console conserve 16 mois). |
| Conserver les données | 24 mois | Rétention locale (16, 24, 36 mois ou sans limite) ; au-delà de 16 mois, comparaisons que Search Console ne propose plus. |
| Inspections par jour / par minute | 1 800 / 300 | Plafonds du module, sous les limites Google (2 000 / 600). |
| Langues à inspecter | Langue par défaut | Ou toutes les langues actives, ou une sélection. |
| Réinspection automatique | Activée | Après modification d’un produit, d’une catégorie ou d’une page CMS. L’enregistrement n’est pas ralenti : la modification est notée et traitée par le prochain cron. |
| Conserver les données à la désinstallation | Désactivé | Désactivé : la désinstallation révoque les connexions Google et supprime les tables du module. |
Sécurité et droits
- OAuth 2.0 avec PKCE et un paramètre
statealéatoire, à usage unique, valable 15 minutes et lié à l’employé et à son navigateur ; le code est échangé dans la session de l’employé. - Secret client, jeton d’accès et jeton de rafraîchissement chiffrés en base ; jamais affichés ni écrits dans les journaux.
- Déconnecter révoque l’autorisation chez Google. Si Google refuse l’autorisation enregistrée (accès révoqué, mot de passe changé, application en statut « Test »), la boutique passe en « reconnexion nécessaire », une alerte est créée et plus aucun appel n’est fait.
- Droits par onglet : un profil avec le seul droit « Voir » consulte tout mais ne peut rien modifier. Jeton CSRF sur toutes les actions.
- Multiboutique : chaque boutique a sa connexion, sa propriété, ses données, ses réglages et ses alertes.
- Cron : jeton comparé en temps constant, verrou contre les exécutions simultanées, réponse sans détail interne. Le contrôleur de retour Google et le cron restent accessibles en mode maintenance.
Dépannage
redirect_uri_mismatch sur l’écran Google
L’adresse de redirection enregistrée dans Google Cloud n’est pas strictement identique à celle du module (http/https, www, chemin). Recopiez-la avec le bouton Copier.
La connexion s’arrête au bout de 7 jours
L’application OAuth est encore en statut « Test » chez Google : publiez-la (« En production »), puis reconnectez la boutique.
« La Google Search Console API n’est pas activée »
Activez l’API dans la bibliothèque du projet Google Cloud, attendez quelques minutes, puis testez la connexion.
Aucun produit dans les rapports
Vérifiez que la propriété couvre l’adresse de la boutique. Si la boutique est servie derrière un proxy ou un CDN, renseignez l’adresse publique (étape 3).
La file d’inspection est en pause
Le quota du jour est atteint (le vôtre ou celui de Google) ou Google a demandé de ralentir : la file reprend seule. Le bouton Reprendre maintenant lève la pause.
Les e-mails d’alerte n’arrivent pas
Vérifiez les destinataires et la configuration e-mail de PrestaShop (Paramètres avancés > E-mail), puis utilisez Envoyer un e-mail de test. En cas d’échec d’envoi, le module réessaie au plus toutes les 6 heures.
Données et désinstallation
Tables ps_dfgsc_* (connexion, propriétés, totaux journaliers, pages, requêtes, couples page-requête, correspondance d’URL, inspections, file, quotas, sitemaps, alertes, historique des tâches) et clés DFGSC_*. La désinstallation révoque les connexions Google et supprime ces données, sauf si « Conserver les données à la désinstallation » est activé. Chart.js 4.4.0 (licence MIT) est inclus et chargé uniquement sur les pages du module qui affichent des graphiques.