PS PrestaShop Intermédiaire

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é.

Mis à jour Version du module 2.0.0

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.

Vue d'ensemble Search Console dans PrestaShop : clics, impressions, CTR, position moyenne et courbe de tendance
Vue d'ensemble Search Console dans PrestaShop : clics, impressions, CTR, position moyenne et courbe de tendance

Installation

  1. Back-office → Modules → Gestionnaire de modules → Installer un module, puis déposez dfgscconnect-2.0.0.zip.
  2. Un menu Search Console apparaît avec six pages : Vue d’ensemble, Performances, Indexation, Sitemaps, Alertes, Connexion et paramètres.
  3. 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 curl et openssl.
  • 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

Assistant de connexion pas à pas : création du client OAuth Google Cloud et URI de redirection à copier
Assistant de connexion pas à pas : création du client OAuth Google Cloud et URI de redirection à copier

Étape 1 : créer votre client OAuth Google Cloud

  1. Sur console.cloud.google.com, créez un projet, puis dans API et services > Bibliothèque, activez Google Search Console API.
  2. 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 (ou webmasters si vous voulez gérer les sitemaps depuis la boutique).
  3. 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.
  4. 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.
  5. 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.

Connexion Google active et choix de la propriété Search Console (domaine ou préfixe d'URL)
Connexion Google active et choix de la propriété Search Console (domaine ou préfixe d'URL)

É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.

Test de connexion en un clic : client OAuth, autorisation, propriété, données de performances
Test de connexion en un clic : client OAuth, autorisation, propriété, données de performances

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.

Top produits, catégories et requêtes, pages qui perdent des clics et opportunités
Top produits, catégories et requêtes, pages qui perdent des clics et opportunités

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

Rapport de performances par produit : clics, évolution, impressions, CTR et position
Rapport de performances par produit : clics, évolution, impressions, CTR et position

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.

Requêtes Google qui mènent à une fiche produit, avec clics, impressions et position
Requêtes Google qui mènent à une fiche produit, avec clics, impressions et position

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.

Performances par catégorie, avec les clics des produits de chaque catégorie
Performances par catégorie, avec les clics des produits de chaque catégorie

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

Inspection d'URL en masse : statut d'indexation, file d'attente et quota Google du jour
Inspection d'URL en masse : statut d'indexation, file d'attente et quota Google du jour

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 d'inspection : pages indexées, non indexées et URL canonique choisie par Google
Résultats d'inspection : pages indexées, non indexées et URL canonique choisie par Google

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.

Détail d'une inspection d'URL : couverture, exploration, robots.txt et URL canoniques
Détail d'une inspection d'URL : couverture, exploration, robots.txt et URL canoniques

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

Sitemaps connus de Search Console, erreurs et sitemaps détectés sur la boutique
Sitemaps connus de Search Console, erreurs et sitemaps détectés sur la boutique

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

Alertes : baisse de position ou de clics, page désindexée, erreurs de sitemap
Alertes : baisse de position ou de clics, page désindexée, erreurs de sitemap
  • 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.

Réglages : alertes configurables, quotas d'inspection, historique et tâche cron
Réglages : alertes configurables, quotas d'inspection, historique et tâche cron

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.

E-mail récapitulatif des alertes Search Console envoyé par la boutique
E-mail récapitulatif des alertes Search Console envoyé par la boutique

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 state alé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.

Cette page vous a-t-elle été utile ?

Toujours bloqué ? Contactez le support