SEO Rich Data - installation et configuration
Objectif du module
Le module Kowal_SeoRichData ajoute à Magento 2 des données structurées schema.org au format JSON-LD. Les données générées peuvent inclure les produits, les offres, les prix, la disponibilité, les notes, les avis, les breadcrumbs, les données de l’organisation, le nom du site, la search box, les profils sociaux, les FAQ et les vidéos.
La configuration du module se trouve dans le panneau d’administration Magento :
Stores > Configuration > Kowal > SEO Rich Data
Exigences
- Magento 2.
- Accès au CLI Magento.
- Accès au Composer repository contenant le package
kowal/module-seo-rich-data. - Package de base requis :
kowal/base. - Autorisations pour exécuter les commandes
bin/magento.
Installation via Composer
- Ajoutez le dépôt du package :
Les données d’accès au dépôt Composer, à savoir l’adresse e-mail du client et le token de licence, vous seront envoyées par e-mail après l’achat. Elles sont également disponibles dans l’espace client après connexion sur kowal.store. Remplacez TWOJ_EMAIL_KLIENTA par l’adresse e-mail de votre compte et TWOJ_TOKEN par le token reçu. Exécutez les commandes dans le répertoire racine de Magento.
composer config repositories.kowal composer https://repo.kowal.store
- 2. Configurez les données d’accès au dépôt Composer Kowal :
composer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'
composer require kowal/module-seo-rich-data
php bin/magento module:enable Kowal_SeoRichData
- 5. Lancez la mise à jour de Magento :
php bin/magento setup:upgrade
- 6. En environnement de production, exécutez la compilation DI :
php bin/magento setup:di:compile
- 7. En environnement de production, si le projet l’exige, générez les fichiers statiques :
php bin/magento setup:static-content:deploy
php bin/magento cache:flush
Installation manuelle
- Copiez le module dans le répertoire :
app/code/Kowal/SeoRichData
php bin/magento module:enable Kowal_SeoRichData
- 3. Lancez la mise à jour de Magento :
php bin/magento setup:upgrade
php bin/magento cache:flush
Actions après installation
Après l’installation, le module ajoute l’attribut produit :
| Attribut | Signification |
|---|
offer_item_condition | État du produit utilisé pour générer itemCondition dans offers. |
L’attribut prend en charge les valeurs suivantes :
| Valeur dans Magento | Valeur JSON-LD |
|---|
DamagedCondition | https://schema.org/DamagedCondition |
NewCondition | https://schema.org/NewCondition |
RefurbishedCondition | https://schema.org/RefurbishedCondition |
UsedCondition | https://schema.org/UsedCondition |
Si aucune valeur d’attribut n’est définie pour le produit, le module le traite comme NewCondition.
Périmètre de configuration
Tous les champs de configuration sont disponibles pour les périmètres Default, Website et Store View, conformément aux paramètres Magento.
Les champs de type Enabled, Show ... et similaires utilisent les valeurs standard de Magento :
| Valeur | Signification |
|---|
Yes | La fonction est activée et peut générer des données JSON-LD. |
No | La fonction est désactivée. |
Breadcrumbs
Cette section concerne les données structurées du chemin de navigation.
| Champ | Signification | Valeurs |
|---|
Enabled | Active la génération des données BreadcrumbList. | Yes, No |
Fixed Category Path | Sur la page produit, utilise le chemin de catégorie le plus spécifique lorsque Magento ne fournit pas le contexte complet de catégorie. | Yes, No |
Type | Détermine la longueur du chemin breadcrumbs généré pour le moteur de recherche. | Default (Long), Short |
Valeurs du champ Type :
| Valeur | Signification |
|---|
Default (Long) | Chemin complet, par exemple Store > Category > Subcategory > Product. |
Short | Chemin raccourci, par exemple Store > Subcategory > Product. |
Include Your Site Name in Search Results
Cette section concerne les données de type WebSite, qui peuvent aider Google à reconnaître le nom du site.
| Champ | Signification | Valeurs |
|---|
Enabled | Active la génération des données WebSite. | Yes, No |
Website Name | Nom du site/de la boutique transmis dans les données structurées. | Texte, par exemple le nom de la boutique. |
Organization
Cette section concerne les données de type Organization.
| Champ | Signification | Valeurs |
|---|
Enabled | Active la génération des données de l’organisation. | Yes, No |
Organization Name | Nom de l’entreprise ou de la boutique. | Texte ; champ requis après activation de la section. |
Logo Url | URL complète du logo de l’organisation. | URL du fichier graphique. |
Description | Description de l’organisation. | Texte. |
Description Length | Nombre maximal de caractères de la description. | Nombre ; vide signifie aucune troncature. |
Country | Pays de l’organisation. | Code pays issu de la liste Magento. |
Region/State | Région ou État. | Texte. |
ZIP/Postal Code | Code postal. | Texte. |
City | Ville. | Texte. |
Street Address | Rue et numéro. | Texte. |
Sales | Téléphone du service commercial. | Numéro au format international, par exemple +48.... |
Technical Support | Téléphone du support technique. | Numéro au format international. |
Customer Service | Téléphone du service client. | Numéro au format international. |
Le pays de cette section peut être utilisé comme fallback pour le pays de livraison et le pays de la politique de retour, si les champs correspondants de la section produit restent vides.
Social Profiles
Cette section ajoute les profils sociaux de l’organisation. Pour que les données aient du sens, la section Organization doit être activée.
| Champ | Signification | Valeurs |
|---|
Enabled | Active la génération des liens vers les profils sociaux. | Yes, No |
Facebook | URL du profil Facebook. | URL complète. |
Twitter | URL du profil Twitter / X. | URL complète. |
Google+ | URL du profil Google+. | URL complète ; champ de configuration historique. |
Instagram | URL du profil Instagram. | URL complète. |
YouTube | URL de la chaîne YouTube. | URL complète. |
LinkedIn | URL du profil LinkedIn. | URL complète. |
Myspace | URL du profil Myspace. | URL complète ; champ de configuration historique. |
Pinterest | URL du profil Pinterest. | URL complète. |
SoundCloud | URL du profil SoundCloud. | URL complète. |
Tumblr | URL du profil Tumblr. | URL complète. |
Les champs vides sont ignorés.
Search Box
Cette section concerne les données SearchAction, qui peuvent permettre l’affichage du champ de recherche de la boutique dans les résultats Google.
| Champ | Signification | Valeurs |
|---|
Enabled | Active la génération des données du moteur de recherche du site. | Yes, No |
Category Rich Data
Cette section concerne la génération des données produit sur les pages de catégorie.
| Champ | Signification | Valeurs |
|---|
Show Products Data | Ajoute des données structurées pour les produits visibles sur la page de catégorie. | Yes, No |
L’activation de cette option peut dégrader les performances des pages de catégorie, car le module doit collecter les données de nombreux produits.
Product Rich Data
Cette section concerne les principales données produit de type Product ainsi que les données offers.
Champs produit de base
| Champ | Signification | Valeurs |
|---|
Enabled | Active la génération du JSON-LD produit sur la page produit. | Yes, No |
Show Availability | Ajoute availability dans offers. | Yes, No |
priceValidUntil Default Value | Date de validité du prix par défaut. | Date. |
Use “Special Price To” Value for priceValidUntil Snippet | Si le produit a un prix spécial actif et une date Special Price To, cette date remplace la valeur par défaut. | Yes, No |
Show Condition | Ajoute itemCondition dans offers. | Yes, No |
Description | Détermine la source de la description du produit dans JSON-LD. | None, Product Short Description, Product Full Description, Page Meta Description |
Valeurs du champ Description :
| Valeur | Signification |
|---|
None | Ne récupère pas la description depuis la configuration ; le code peut utiliser le nom du produit comme fallback si la description est vide. |
Product Short Description | Utilise la description courte du produit. |
Product Full Description | Utilise la description complète du produit. |
Page Meta Description | Utilise la meta description de la page. |
Produits configurables et groupés
| Champ | Signification | Valeurs |
|---|
Show Configurable Products as | Détermine la manière de générer les offres pour les produits configurables. | Main Offer, List of Associated Products Offers, Aggregate Offer |
Show Grouped Products as | Détermine la manière de générer les offres pour les produits groupés. | Main Offer, List of Associated Products Offers, Aggregate Offer |
Valeurs :
| Valeur | Signification |
|---|
Main Offer | Génère une offre unique pour le produit principal. |
List of Associated Products Offers | Génère une offre séparée pour chaque produit simple ou associé. |
Aggregate Offer | Génère AggregateOffer avec le prix le plus bas, le prix le plus élevé et le nombre d’offres. |
Notes et avis
| Champ | Signification | Valeurs |
|---|
Show Rating | Ajoute aggregateRating et review aux données produit. | Yes, No |
Use Yotpo Reviews instead of Magento Reviews | Récupère les avis depuis Yotpo au lieu de Magento Reviews. | Yes, No |
Rating Format | Détermine l’échelle de notation. | Percentage Scale, Numeric Scale |
Number of Reviews | Limite du nombre d’avis les plus récents ajoutés au JSON-LD. | Nombre ; vide signifie tous les avis. |
Valeurs du champ Rating Format :
| Valeur | Signification |
|---|
Percentage Scale | Les notes sont interprétées sur une échelle en pourcentage. |
Numeric Scale | Les notes sont interprétées sur une échelle numérique. |
L’intégration avec Yotpo nécessite la disponibilité d’un module prenant en charge Yotpo. Si le module n’est pas installé, la configuration Yotpo ne doit pas être activée.
Brand, manufacturer et identifiants produit
| Champ | Signification | Valeurs |
|---|
Brand | Attribut produit utilisé pour générer la propriété brand. | N’importe quel attribut produit de la liste. |
EAN / GTIN Attribute | Attribut produit utilisé comme identifiant produit global. | N’importe quel attribut produit de la liste. |
Manufacturer | Attribut produit utilisé pour générer la propriété manufacturer. | N’importe quel attribut produit de la liste. |
Le champ EAN / GTIN Attribute génère la propriété en fonction du nombre de chiffres :
| Nombre de chiffres | Propriété JSON-LD |
|---|
| 8 | gtin8 |
| 12 | gtin12 |
| 13 | gtin13 |
| 14 | gtin14 |
| Autre nombre positif de chiffres | gtin |
Le module supprime les caractères autres que les chiffres de la valeur EAN / GTIN avant de générer le JSON-LD.
Shipping details
La section de livraison permet de générer shippingDetails dans offers. Les données ne sont ajoutées que lorsque la section est activée et contient toutes les valeurs requises.
| Champ | Signification | Valeurs |
|---|
Show Shipping Details | Active la génération de shippingDetails. | Yes, No |
Shipping Country | Pays de livraison. | Code pays issu de la liste Magento ; si vide, le pays de la section Organization est utilisé. |
Shipping Price | Coût de livraison. | Nombre égal ou supérieur à 0 ; 0 signifie livraison gratuite. |
Handling Time Min Days | Délai minimal de traitement de la commande. | Nombre entier, jours. |
Handling Time Max Days | Délai maximal de traitement de la commande. | Nombre entier, jours. |
Transit Time Min Days | Délai minimal de transport. | Nombre entier, jours. |
Transit Time Max Days | Délai maximal de transport. | Nombre entier, jours. |
La devise du coût de livraison est récupérée depuis la devise de l’offre produit.
Exemple de signification des valeurs :
| Champ | Exemple | Signification |
|---|
Shipping Price | 0 | Livraison gratuite. |
Handling Time Min Days | 0 | La commande peut être traitée le jour même. |
Handling Time Max Days | 1 | Le traitement de la commande dure au maximum 1 jour. |
Transit Time Min Days | 1 | La livraison dure au moins 1 jour. |
Transit Time Max Days | 5 | La livraison dure au maximum 5 jours. |
Merchant return policy
La section de politique de retour permet de générer hasMerchantReturnPolicy dans offers. Les données ne sont ajoutées que lorsque la section est activée et contient les valeurs requises.
| Champ | Signification | Valeurs |
|---|
Show Merchant Return Policy | Active la génération de hasMerchantReturnPolicy. | Yes, No |
Return Policy Country | Pays d’application de la politique de retour. | Code pays issu de la liste Magento ; si vide, le pays de la section Organization est utilisé. |
Return Policy Category | Type de politique de retour. | Finite Return Window, Returns Not Permitted, Unlimited Return Window |
Merchant Return Days | Nombre de jours pour le retour. | Nombre entier ; requis pour Finite Return Window. |
Return Method | Méthode de retour prise en charge. | -- Empty --, Return By Mail, Return In Store, Return At Kiosk |
Return Fees | Information sur les frais de retour. | -- Empty --, Free Return, Customer Responsibility, Return Shipping Fees |
Return Shipping Fee | Montant des frais d’expédition de retour. | Nombre supérieur à 0 ; requis uniquement pour Return Shipping Fees. |
Valeurs du champ Return Policy Category :
| Valeur | Valeur JSON-LD | Signification |
|---|
Finite Return Window | https://schema.org/MerchantReturnFiniteReturnWindow | Retour possible pendant un nombre de jours défini. Requiert Merchant Return Days. |
Returns Not Permitted | https://schema.org/MerchantReturnNotPermitted | Les retours ne sont pas autorisés. |
Unlimited Return Window | https://schema.org/MerchantReturnUnlimitedWindow | Retour sans limite de jours définie. |
Valeurs du champ Return Method :
| Valeur | Valeur JSON-LD | Signification |
|---|
-- Empty -- | aucune valeur | La méthode de retour n’est pas ajoutée au JSON-LD. |
Return By Mail | https://schema.org/ReturnByMail | Retour par expédition. |
Return In Store | https://schema.org/ReturnInStore | Retour en magasin physique. |
Return At Kiosk | https://schema.org/ReturnAtKiosk | Retour en point/kiosque. |
Valeurs du champ Return Fees :
| Valeur | Valeur JSON-LD | Signification |
|---|
-- Empty -- | aucune valeur | L’information sur les frais n’est pas ajoutée au JSON-LD. |
Free Return | https://schema.org/FreeReturn | Le retour est gratuit. |
Customer Responsibility | https://schema.org/ReturnFeesCustomerResponsibility | Le coût du retour est à la charge du client. |
Return Shipping Fees | https://schema.org/ReturnShippingFees | Le retour comporte des frais d’expédition de retour définis. Requiert Return Shipping Fee. |
La devise du champ Return Shipping Fee est récupérée depuis la devise de l’offre produit.
Custom Properties
Le champ Custom Properties permet d’ajouter vos propres propriétés au JSON-LD du produit.
Format :
wlasciwosc_jsonld,kod_atrybutu
Si un seul élément est indiqué, le module le traite à la fois comme nom de propriété JSON-LD et comme code d’attribut.
Valeur par défaut :
skumpn,sku
Signification de la valeur par défaut :
| Ligne | Effet |
|---|
sku | Ajoute sku à partir de l’attribut sku. |
mpn,sku | Ajoute mpn à partir de l’attribut sku. |
Exemple d’ajout d’un attribut personnalisé :
color,colormaterial,material
Configuration minimale recommandée pour les produits
Afin de limiter les avertissements Google Search Console pour les données produit, configurez au minimum :
| Champ | Recommandation |
|---|
Product Rich Data > Enabled | Yes |
Show Availability | Yes |
Brand | Sélectionnez l’attribut contenant la marque du produit. |
EAN / GTIN Attribute | Sélectionnez l’attribut contenant l’EAN / GTIN, si les produits possèdent un identifiant global. |
Show Shipping Details | Yes, si la boutique dispose d’une politique de livraison uniforme pouvant être décrite dans la configuration. |
Show Merchant Return Policy | Yes, si la boutique dispose d’une politique de retour uniforme pouvant être décrite dans la configuration. |
Custom Properties | Conservez au moins sku ; ajoutez éventuellement mpn si la boutique possède cet identifiant. |
Vidage du cache après modification de la configuration
Après une modification de configuration, exécutez :
php bin/magento cache:flush
Si la boutique utilise un cache HTTP supplémentaire, Varnish ou un CDN, videz également ces couches de cache.
Vérification du fonctionnement
- Ouvrez une page produit sur le frontend.
- Vérifiez le code source de la page et recherchez :
<script type='application/ld+json'>
- 3. Vérifiez que le JSON-LD contient les champs attendus, par exemple :
{ '@type': 'Product', 'brand': { '@type': 'Brand', 'name': 'Example Brand' }, 'gtin13': '5901234123457', 'offers': [ { '@type': 'Offer', 'shippingDetails': {}, 'hasMerchantReturnPolicy': {} } ]}
- 4. Testez l’URL du produit dans l’outil Google Rich Results Test ou dans Google Search Console.
Remarques de déploiement
- N’activez pas
shippingDetails ni hasMerchantReturnPolicy si les valeurs de configuration ne correspondent pas à la politique réelle de la boutique. - Si les politiques de livraison ou de retour varient selon le produit, la région, la méthode de livraison ou le panier, une configuration globale unique peut ne pas suffire.
- Après modification des attributs
Brand, Manufacturer ou EAN / GTIN Attribute, il est recommandé de réindexer les données produit si la boutique utilise un cache ou des index influençant la lecture des attributs. - Dans les boutiques multilingues et multidevises, vérifiez la configuration séparément pour chaque Store View.
