PS PrestaShop Intermédiaire

dfsearchconsole — Google Search Console pour PrestaShop

Installation, connexion à Google en 5 étapes, synchronisation, tableau de bord, opportunités SEO, paramètres et mise à jour depuis la 1.x.

Mis à jour Version du module 2.0.0

Présentation

DataFirefly – Search Console importe les données de Google Search Console dans le back-office PrestaShop 1.7.8, 8 et 9 : clics, impressions, CTR et position moyenne par page et par requête, comparaison avec la période précédente ou l’année précédente, part des recherches de marque, appareils et pays. À partir de ces données, le module liste des opportunités SEO calculées avec des règles explicites, affichées à l’écran, et relie chaque URL au produit, à la catégorie ou à la page CMS correspondant, avec un lien vers son édition.

Le module ajoute le menu Améliorer → Opportunités SEO avec cinq onglets : Tableau de bord, Opportunités, Pages, Requêtes et Connexion et paramètres. L’accès à Google se fait en lecture seule (webmasters.readonly) avec votre propre client OAuth Google Cloud.

Tableau de bord Search Console dans PrestaShop : clics, impressions, CTR et position moyenne comparés à la période précédente, avec courbe quotidienne
Tableau de bord Search Console dans PrestaShop

Ce module n’est ni affilié à Google ni approuvé par Google. Google Search Console est une marque de Google LLC. Le module ne prévoit aucun gain de clics ni de position : il mesure et classe, les résultats dépendent de Google et de vos concurrents.

Installation

  1. Téléchargez dfsearchconsole-2.0.0.zip depuis votre compte client DataFirefly.
  2. Dans le back-office : Modules → Gestionnaire de modules → Téléverser un module, puis choisissez le fichier.
  3. Ouvrez Améliorer → Opportunités SEO → Connexion et paramètres.

Le module crée ses propres tables ps_dfsrch_*, ses clés de configuration DFSRCH_* et ses onglets AdminDfSrch*. Il ne partage aucune table, clé ni onglet avec le module DataFirefly Search Console Connect (dfgscconnect) : les deux peuvent être installés ensemble et désinstallés séparément.

Prérequis : PrestaShop 1.7.8 à 9.x, PHP 7.4 à 8.5 (testé sur PHP 7.4, 8.1 et 8.5), extensions cURL et OpenSSL, une propriété validée dans Google Search Console.

Connexion à Google

L’onglet Connexion et paramètres présente un Assistant de connexion en cinq étapes. Comptez une dizaine de minutes la première fois.

Assistant de connexion en 5 étapes : client OAuth Google Cloud, URI de redirection à copier, connexion en lecture seule, propriété et test
Assistant de connexion en 5 étapes

1. Créer le client OAuth dans Google Cloud Console

  1. Sur console.cloud.google.com, créez un projet (ou choisissez un projet existant).
  2. API et services → Bibliothèque : activez Google Search Console API.
  3. Écran de consentement OAuth (Google Auth Platform) : type d’utilisateur Externe (ou Interne avec Google Workspace), ajoutez le champ d’application https://www.googleapis.com/auth/webmasters.readonly et, tant que l’application est au statut « Test », ajoutez votre compte Google comme utilisateur test.
  4. Identifiants (Clients) : créez un ID client OAuth de type Application Web et collez dans URI de redirection autorisés l’URI affichée par le module (bouton Copier).

L’URI doit être identique au caractère près (protocole, www, préfixe de langue). Sinon Google affiche l’erreur redirect_uri_mismatch. Aucune origine JavaScript autorisée n’est nécessaire. Si le domaine, le HTTPS ou la langue par défaut de la boutique changent, l’URI change aussi : le module le signale et il faut la déclarer à nouveau.

2. Saisir l’ID client et le code secret du client

Collez l’ID client et le code secret du client, puis Enregistrer le client OAuth. Le code secret est stocké chiffré et n’est plus jamais affiché ; laissez le champ vide pour le conserver lors d’une modification.

3. Se connecter avec Google

Se connecter avec Google ouvre l’écran de consentement de Google. Cochez l’accès à Search Console : sans cette case, le module refuse la connexion et l’explique. La demande est à usage unique, liée à l’employé et à la boutique, et protégée par PKCE ; l’échange du code a lieu dans le back-office.

Statut « Test » de l’application Google Cloud : Google invalide l’autorisation au bout de 7 jours. Le module affiche alors Connexion Google à renouveler sur toutes ses pages ; cliquez sur Reconnecter. Pour éviter ces reconnexions, passez l’application « En production » dans l’écran de consentement ; Google peut alors demander une vérification de l’application.

4. Choisir la propriété de cette boutique

La liste reprend les propriétés accessibles avec votre compte et votre niveau d’accès. Celle qui correspond au domaine de la boutique est marquée d’une étoile. Une propriété de domaine (sc-domain:) couvre tous les sous-domaines ; les pages qui ne sont pas sur la boutique apparaissent comme « Autre site ». Si vous changez de propriété, les données de l’ancienne sont supprimées.

5. Tester, puis synchroniser

Tester la connexion vérifie l’URI de redirection, l’autorisation Google (jeton renouvelé), la liste des propriétés et la lecture des données des 28 derniers jours. Synchroniser maintenant lance la première synchronisation avec une barre de progression.

Synchronisation

La première synchronisation importe les totaux quotidiens des 16 derniers mois, puis les pages et les requêtes de la période analysée (7, 28, 90 ou 180 jours) et de la période précédente de même durée, les appareils et les pays. Elle avance par étapes : les écrans continuent d’afficher les dernières données complètes jusqu’à la fin. Resynchronisation complète réimporte tout, même sans nouveau jour.

  • Les jours sont comptés en heure du Pacifique (Los Angeles), comme dans Search Console.
  • Les données arrivent avec 2 à 3 jours de décalage ; le module n’importe que les jours définitifs.
  • Ensuite, seuls les jours manquants sont importés. Si aucun nouveau jour n’est disponible, l’analyse n’est pas recalculée.
  • Google anonymise certaines requêtes rares : les totaux par requête sont inférieurs aux totaux du site.
  • Quota Google (erreur 429) ou indisponibilité (erreurs 5xx) : le module réessaie avec une attente croissante, puis met la synchronisation en pause ; elle reprend à la même étape au passage suivant (Synchronisation en pause).
  • Gros catalogues : l’import se fait par pages de 25 000 lignes, dans la limite de Lignes importées par période.

Synchronisation automatique (cron)

Appelez toutes les heures l’URL affichée dans Synchronisation automatique (cron). Elle ne fait rien tant que les données sont à jour, reprend une synchronisation en pause et s’arrête après une cinquantaine de secondes. Un verrou empêche deux exécutions simultanées.

7 * * * * curl -fsS "https://votre-boutique.example/module/dfsearchconsole/cron?token=…" >/dev/null 2>&1

L’URL est propre à chaque boutique et sert de mot de passe : seuls les employés autorisés à modifier l’onglet la voient. Générer une nouvelle URL invalide immédiatement l’ancienne. La réponse ne contient qu’un statut, jamais de données.

Tableau de bord

Choisissez la durée (7 jours à 16 mois) et la comparaison (vs période précédente ou vs année précédente). Les quatre indicateurs (clics, impressions, CTR moyen, position moyenne) et la courbe proviennent des totaux quotidiens du site, requêtes anonymisées comprises ; la ligne pointillée représente la période de comparaison.

Part des clics marque et hors marque, appareils, pays, principales opportunités et nombre de requêtes par tranche de position
Part des clics marque et hors marque

Sous la courbe : Marque et hors marque (à partir des noms de marque saisis dans les paramètres), Appareils, Pays, Principales opportunités, Requêtes par position (1-3, 4-10, 11-20, 21-50, au-delà), et les pages qui gagnent ou perdent le plus de clics.

Opportunités

Après chaque synchronisation, le module calcule six types d’opportunités. La règle de chaque type, avec vos seuils, est affichée en haut de la liste (Comment les opportunités sont-elles détectées ?).

Opportunités SEO classées par type : proches du top 10, CTR faible, pages en baisse, cannibalisation, URL à nettoyer, balises meta manquantes
Opportunités SEO classées par type
Type Règle (seuils par défaut)
Proche du top 10 Requête hors marque en position moyenne 11 à 20, au moins 50 impressions sur la période.
CTR faible pour sa position Requête hors marque du top 10 dont le CTR est inférieur à 50 % du CTR médian de vos propres requêtes hors marque à la même position. Si votre boutique a moins de 8 requêtes comparables, une courbe de référence indicative est utilisée et signalée.
Pages qui perdent des clics Page qui a perdu au moins 30 % de ses clics (et en avait au moins 20) ; cause probable déduite de la position, des impressions et du CTR, ou page indisponible.
Cannibalisation Requête hors marque pour laquelle au moins deux objets différents reçoivent chacun 15 % des impressions ou plus. Les URL d’un même produit ou d’une même catégorie (déclinaisons, pagination, paramètres) sont regroupées.
URL à nettoyer URL vue par Google qui n’est pas l’URL actuelle de son objet : ancienne URL, URL de déclinaison, paramètres de suivi, produit ou page supprimé ou désactivé.
Balises meta manquantes Produit, catégorie ou page CMS en position 20 ou mieux dont le meta title ou la meta description est vide dans la langue de l’URL.

Chaque carte affiche les Faits mesurés (positions avant et maintenant, CTR médian de comparaison, mots de la requête absents du meta title, longueur de la description…) et Ce que vous pouvez faire, avec un bouton vers l’édition du produit, de la catégorie ou de la page CMS.

Requête au CTR faible pour sa position, comparée au CTR médian des requêtes de la boutique, avec faits mesurés et actions
Requête au CTR faible pour sa position
Page qui perd des clics : cause probable (baisse de position), requêtes qui ont le plus perdu et vérifications proposées
Page qui perd des clics
Cannibalisation : une requête partagée entre une catégorie et un produit, part des impressions de chaque page et actions
Cannibalisation

La Priorité ne sert qu’à trier la liste (impressions concernées et distance à l’objectif) ; ce n’est pas une prévision. Marquer comme réalisée (avec une note facultative) conserve les mesures du moment : l’onglet Suivi des actions réalisées les compare aux synchronisations suivantes. Ignorer retire l’opportunité de la liste À faire ; Rouvrir la remet. Ces statuts sont conservés d’une synchronisation à l’autre.

Les opportunités sont recalculées dès que vous modifiez un seuil ou les noms de marque, sans nouvel appel à Google. Les listes et l’export CSV suivent les filtres affichés.

Pages

Chaque URL vue par Google est rapprochée de son objet PrestaShop à partir des règles d’URL de votre boutique (y compris les règles personnalisées), de la langue, des déclinaisons et des paramètres. Filtres : type (produit, catégorie, page CMS, marque, fournisseur, page d’accueil…), tendance (gagne, perd, nouvelle, disparue) et remarque (Pas l’URL actuelle, URL de déclinaison, paramètres, Objet supprimé, Désactivé, Autre site).

Pages vues dans Google rapprochées des produits, catégories et pages CMS, avec évolution des clics, CTR, position et lien d'édition
Pages vues dans Google rapprochées des produits

Le Détail de la page montre les indicateurs comparés, les requêtes de la page, les balises SEO dans la langue de l’URL et les opportunités qui la concernent.

Détail d'une page produit : KPI comparés, requêtes de la page, balises SEO de la langue et opportunités
Détail d'une page produit

Requêtes

Les requêtes sont regroupées toutes pages confondues. Filtres : marque ou hors marque, tranche de position (top 3, 4 à 10, 11 à 20, au-delà), tendance et Sur plusieurs pages. Le Détail de la requête liste les pages qui apparaissent pour cette requête.

Requêtes hors marque triées par impressions, avec filtres par position, tendance et requêtes présentes sur plusieurs pages
Requêtes hors marque triées par impressions

Paramètres d’analyse

Paramètre Défaut Effet
Période analysée 28 jours 7, 28, 90 ou 180 jours, comparés à la période précédente de même durée. S’applique à la synchronisation suivante.
Impressions minimum 50 En dessous, une requête ou une page n’est pas une opportunité.
Positions « Proche du top 10 » 11 à 20 Plage de positions de la règle « Proche du top 10 ».
Seuil de CTR faible (en % de votre médiane) 50 CTR inférieur à ce pourcentage du CTR médian à la même position.
Page qui perd des clics 30 % et 20 clics Perte minimale et nombre minimal de clics sur la période précédente.
Cannibalisation : part minimale par page (%) 15 Part des impressions que chaque page doit recevoir.
Lignes importées par période 100 000 Plafond de lignes page × requête par période (5 000 à 1 000 000).
Historique quotidien conservé (mois) 16 Les jours plus anciens sont supprimés à chaque synchronisation.
Noms de marque vide Séparés par des virgules (accents et majuscules ignorés). Les requêtes de marque sont exclues des opportunités et du CTR médian de comparaison.

Droits, multiboutique et sécurité

  • Droits PrestaShop par onglet : la lecture permet de consulter et d’exporter en CSV ; la modification permet de connecter, synchroniser, régler et changer les statuts ; la suppression permet d’effacer les données importées. Un employé en lecture seule voit les champs grisés et pas l’URL cron. Toutes les actions passent par un formulaire protégé par un jeton de sécurité.
  • Multiboutique : connexion, propriété, URL cron, paramètres et données sont propres à chaque boutique. Sélectionnez une boutique dans le sélecteur ; le contexte « Toutes les boutiques » affiche Sélectionnez une boutique.
  • Code secret du client, jetons OAuth et jeton cron sont chiffrés en AES-256-GCM avec la clé de votre boutique ; ils n’apparaissent jamais dans les pages ni dans les messages d’erreur.
  • Les données ne circulent qu’entre votre serveur et Google. Aucun tiers, aucune IA externe.

Dépannage

« Connexion Google à renouveler »

Google refuse l’autorisation enregistrée : révoquée, expirée, ou application au statut « Test » (7 jours). Cliquez sur Reconnecter. Les données déjà importées restent disponibles.

« L’API Google Search Console n’est pas activée »

Activez Google Search Console API dans API et services → Bibliothèque du projet, attendez quelques minutes, puis réessayez.

Ce compte Google n’a pas accès à la propriété

Ajoutez le compte comme utilisateur de la propriété dans Search Console (Paramètres → Utilisateurs et autorisations), ou choisissez une autre propriété.

Synchronisation en pause

Google limite temporairement les requêtes (quota) ou est indisponible. La synchronisation reprend au passage suivant du cron, ou tout de suite avec Reprendre maintenant.

Bandeau rouge « Mode test »

Les clés DFSRCH_TEST_API_BASE / DFSRCH_TEST_AUTH_BASE redirigent les appels vers un simulateur local de développement. Elles sont vides par défaut et n’ont pas de champ dans le formulaire ; videz-les avant une utilisation réelle.

Mise à jour depuis la version 1.x

Téléversez le zip 2.0.0 par-dessus la version installée. La mise à jour reprend les réglages, l’ID et le code secret du client, les jetons (pas besoin de se reconnecter), la propriété, l’URL cron (même jeton), les pages, les requêtes et les statuts « traitée / ignorée ». Elle supprime ensuite les anciennes tables ps_dfgsc_sync, ps_dfgsc_page, ps_dfgsc_query et ps_dfgsc_opportunity (uniquement si leur structure est celle de la 1.x), les anciennes clés de configuration de la 1.x, ses anciens onglets et ses anciens fichiers. La clé DFGSC_CRON_TOKEN est laissée en place si le module DataFirefly Search Console Connect est installé. Lancez ensuite une synchronisation pour charger l’historique quotidien, les appareils et les pays.

Désinstallation

La désinstallation révoque l’autorisation Google, puis supprime uniquement les tables ps_dfsrch_*, les clés DFSRCH_* et les onglets du module. Vous pouvez aussi retirer l’accès de l’application dans les paramètres de sécurité de votre compte Google.

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

Toujours bloqué ? Contactez le support