Configurations d’URL avancées

Les composants principaux AEM CIF offrent des configurations avancées pour personnaliser les URL des pages de produits et de catégories. De nombreuses mises en œuvre personnalisent ces URL à des fins d’optimisation du moteur de recherche (SEO). La vidéo suivante explique comment configurer le UrlProvider service et les fonctionnalités du mappage Sling pour personnaliser les URL des pages de produits et de catégories.

Configuration

Pour configurer le service UrlProvider en fonction des exigences et des besoins de SEO, un projet doit fournir une configuration OSGI pour la configuration du fournisseur d’URL CIF.

Format d’URL de page de produits

Celui-ci configure les URL des pages de produits et prend en charge les options suivantes :

• {{page}}.html/{{sku}}.html#{{variant_sku}} (par défaut)
• {{page}}.html/{{sku}}/{{url_key}}.html#{{variant_sku}}
• {{page}}.html/{{sku}}/{{category}}/{{url_key}}.html#{{variant_sku}}
• {{page}}.html/{{sku}}/{{url_path}}.html#{{variant_sku}}
• {{page}}.html/{{url_key}}.html#{{variant_sku}}
• {{page}}.html/{{category}}/{{url_key}}.html#{{variant_sku}}
• {{page}}.html/{{url_path}}.html#{{variant_sku}}

Si le magasin de référence Venia est disponible :

• {{page}} est remplacé par /content/venia/us/en/products/product-page ;
• {{sku}} est remplacé par le SKU du produit, par exemple VP09 ;
• {{url_key}} est remplacé par la propriété url_key du produit, par exemple lenora-crochet-shorts ;
• {{url_path}} est remplacé par le url_path du produit, par exemple venia-bottoms/venia-pants/lenora-crochet-shorts ;
• {{variant_sku}} est remplacé par la variante actuellement sélectionnée, par exemple VP09-KH-S

Depuis que le url_path est devenu obsolète, les formats d’URL de produit prédéfinis utilisent les url_rewrites d’un produit et choisissent celui qui contient le plus de segments de chemin comme alternative si le url_path n’est pas disponible.

Avec les données d’exemple ci-dessus, une URL de variante de produit formatée à l’aide du format d’URL par défaut ressemblera à /content/venia/us/en/products/product-page.html/VP09.html#VP09-KH-S.

Format d’URL de page de catégorie

Il configure les URL des pages de listes de catégories ou de produits et prend en charge les options suivantes :

• {{page}}.html/{{url_path}}.html (par défaut)
• {{page}}.html/{{url_key}}.html

Si le magasin de référence Venia est disponible :

• {{page}} est remplacé par /content/venia/us/en/products/category-page ;
• {{url_key}} est remplacé par la propriété url_key de la catégorie ;
• {{url_path}} est remplacé par le url_path de la catégorie

Avec les exemples de données ci-dessus, une URL de page de catégorie formatée à l’aide du format d’URL par défaut ressemble à /content/venia/us/en/products/category-page.html/venia-bottoms/venia-pants.html.

Configuration spécifique au magasin

Les formats d’URL de catégories et de pages produits définis par la configuration du fournisseur d’URL CIF peuvent être modifiés pour chaque magasin.

Dans la configuration CIF, un éditeur peut sélectionner un autre format d’URL de page de catégorie ou de produit. Si rien n’est sélectionné à cet endroit, l’implémentation revient à la configuration de l’ensemble du système.

La modification du format de l’URL d’un site web actif peut avoir un impact négatif sur le trafic organique de votre site. Veuillez vous référer aux Bonnes pratiques ci-dessous et planifier soigneusement le changement du format de l’URL à l’avance.

URL de pages de produits prenant en compte les catégories

Comme il est possible d’encoder des informations sur les catégories dans l’URL d’un produit, les produits appartenant à plusieurs catégories peuvent également être adressés avec plusieurs URL de produit.

Les formats d’URL par défaut sélectionnent l’une des alternatives possibles en utilisant le schéma suivant :

• si l’url_path est défini par le serveur principal de commerce électronique, utilisez-le (obsolète).
• à partir des url_rewrites utilisez les URL qui se terminent par l’url_key comme alternatives
• parmi ces alternatives, utilisez celle qui a le plus de segments de chemin d’accès
• s’il y en a plusieurs, prenez la première dans l’ordre indiqué par le serveur principal de commerce électronique.

Ce schéma sélectionne l’url_path qui a le plus d’ancêtres, en partant du principe qu’une catégorie enfant est plus spécifique que sa catégorie parent. L’url_path sélectionnée est considérée comme canonique et sera toujours utilisée comme lien canonique sur les pages de produits ou dans le plan du site du produit.

Cependant, lorsqu’un acheteur ou une acheteuse navigue d’une page de catégorie à une page de produit, ou d’une page de produit à une autre page de produit associée dans la même catégorie, il est utile de conserver le contexte actuel de la catégorie. Dans ce cas, la sélection d’url_path doit préférer les alternatives qui se trouvent dans le contexte de la catégorie actuelle à la sélection canonique décrite ci-dessus.

Cette fonctionnalité doit être activée dans la configuration du fournisseur d’URL CIF. Si elle est activée, la sélection donnera un score plus élevé aux alternatives, quand

• elles correspondent à des parties d’url_path d’une catégorie donnée depuis le début (correspondance de préfixe floue)
• ou lorsqu’elles correspondent à l’url_key d’une catégorie donnée n’importe où (correspondance partielle exacte).

Prenons l’exemple de la réponse à une requête de produits ci-dessous. Compte tenu des éléments suivants :

• l’utilisateur ou l’utilisatrice se trouve sur la page de la catégorie « Nouveaux produits/Nouveautés de l’été 2022 » ;
• le magasin utilise le format d’URL de page de la catégorie par défaut

L’alternative « nouveaux-produits/nouveautes-de-lete-2022/boucles-doreilles-cirque-dor.html » correspond à deux des segments de chemin du contexte depuis le début. Autrement dit, « nouveaux produits » et « nouveautés de l’été 2022 ». Si le magasin utilise un format d’URL de page de catégorie contenant uniquement l’url_key, la même alternative est toujours sélectionnée, car elle correspond à l’url_key du contexte. Dans les deux cas, l’URL de la page produit est créée pour « nouveaux-produits/nouveautes-de-lete-2022/boucles-doreilles-cirque-dor.html » url_path.

{
  "data": {
    "products": {
      "items": [
        {
          "sku": "VA18-GO-NA",
          "url_key": "gold-cirque-earrings",
          "url_rewrites": [
            {
              "url": "gold-cirque-earrings.html"
            },
            {
              "url": "venia-accessories/gold-cirque-earrings.html"
            },
            {
              "url": "venia-accessories/venia-jewelry/gold-cirque-earrings.html"
            },
            {
              "url": "new-products/gold-cirque-earrings.html"
            },
            {
              "url": "new-products/new-in-summer-2022/gold-cirque-earrings.html"
            }
          ]
        }
      ]
    }
  }
}

Pages de catégories et de produits spécifiques

Il est possible de créer des pages multi-catégories et multi-produits pour un sous-ensemble spécifique de catégories ou de produits d’un catalogue.

Critères de sélection

La sélection d’une page de catégorie spécifique est directe, basée sur l’url_path ou l’url_key de la catégorie. La correspondance de sous-catégories n’est prise en charge que pour les formats d’URL contenant l’url_path complète de la catégorie. Sinon, seule une correspondance exacte de l’url_key est possible.

Les pages produits spécifiques sont sélectionnées soit par le SKU du produit, soit par sa catégorie. Dans ce dernier cas, certaines informations sur la catégorie doivent être encodées dans l’URL du produit. Cette fonctionnalité n’est disponible que pour certains formats d’URL par défaut. Consultez le tableau suivant pour comparer les formats d’URL qui prennent en charge la sélection de pages spécifiques par SKU ou catégorie.

Lien profond

Le UrlProvider est préconfiguré pour générer des liens profonds vers des pages de catégories et de produits spécifiques sur les instances dʼauteur. Cette fonctionnalité est utile pour les éditeurs et éditrices qui parcourent un site en mode Aperçu, se rendent sur une page produit ou de catégorie spécifique, puis repassent en mode Édition pour modifier la page.

Dans les instances de publication, en revanche, les adresses URL des pages de catalogue doivent rester stables pour ne pas perdre les gains de classement dans les moteurs de recherche, par exemple. Pour cette raison, les instances de publication ne génèrent pas de liens profonds vers des pages de catalogue spécifiques par défaut. Pour modifier ce comportement, la stratégie de page spécifique du fournisseur d’URL CIF peut être configurée pour générer toujours des adresses URL de page spécifiques.

Plusieurs pages de catalogue

Lorsque les éditeurs et les éditrices souhaitent avoir un contrôle total sur la navigation de niveau supérieur d’un site, l’utilisation d’une seule page de catalogue pour effectuer le rendu des catégories de niveau supérieur d’un catalogue peut s’avérer contre-productive. Pour y remédier, les éditeurs et les éditrices peuvent créer plusieurs pages de catalogue, une pour chaque catégorie du catalogue qu’ils souhaitent inclure dans la navigation de niveau supérieur.

Pour ce cas d’utilisation, chacune des pages du catalogue peut avoir une référence à une page de produit et de catégorie spécifique à la catégorie configurée pour la page du catalogue. Le UrlProvider les utilise pour créer des liens pour les pages et les catégories de la catégorie configurée. Toutefois, pour des raisons de performances, seules les pages enfants directes du catalogue de la racine de navigation / page de destination d’un site sont prises en compte.

Il est recommandé que les pages de produit et de catégorie d’une page de catalogue soient des pages descendantes de cette page de catalogue, sinon les composants tels que Navigation ou Chemin de navigation risquent de ne pas fonctionner correctement.

Personnalisations

Formats d’URL personnalisés

Pour fournir un format dʼURL personnalisé, un projet peut implémenter lʼinterface de service ProductUrlFormat ou CategoryUrlFormat et enregistrer lʼimplémentation en tant que service OSGI. Ces implémentations, si elles sont disponibles, remplacent le format configuré et prédéfini. S’il existe plusieurs implémentations enregistrées, celle qui a le rang de service le plus élevé remplace celles qui ont le rang de service le plus bas.

Les implémentations de format dʼURL personnalisé doivent implémenter une paire de méthodes pour créer une adresse URL à partir de paramètres donnés, et pour analyser une URL afin de renvoyer les mêmes paramètres, respectivement.

Combinaison avec des mappages Sling

En plus du UrlProvider, il est également possible de configurer des mappages Sling afin de réécrire et de traiter les URL. L’archétype de projet AEM fournit également un exemple de configuration afin de configurer des mappages Sling pour le port 4503 (publication) et 80 (Dispatcher).

Combinaison avec AEM Dispatcher

Les réécritures d’URL peuvent également être obtenues en utilisant le serveur HTTP AEM Dispatcher avec le module mod_rewrite. L’archétype de projet AEM fournit une configuration de Dispatcher AEM de référence qui inclut déjà des règles de réécriture de base pour la taille générée.

Bonnes pratiques

Choix du meilleur format dʼURL

Comme indiqué précédemment, la sélection dʼun des formats par défaut disponibles, ou même lʼimplémentation dʼun format personnalisé, dépendent fortement des besoins et des exigences dʼun magasin. Les suggestions suivantes peuvent vous aider à prendre la bonne décision.

Utilisez un format d’URL de page produit qui contient le SKU.

Les composants principaux CIF utilisent le SKU comme identifiant principal dans tous les composants. Si le format d’URL de la page produit ne contient pas le SKU, une requête GraphQL est nécessaire pour le résoudre. Cette résolution peut avoir une incidence sur le temps de chargement du premier octet (TTFB). Il peut également être souhaitable que les nouveaux acheteurs et acheteuses puissent trouver des produits par SKU en utilisant des moteurs de recherche.

Utilisez un format dʼURL de page produit qui contient le contexte de la catégorie.

Certaines fonctionnalités du fournisseur dʼURL CIF ne sont disponibles que lors de lʼutilisation de formats dʼURL de produits qui codent le contexte de la catégorie, comme la url_key ou l’url_path de la catégorie. Même si ces fonctionnalités sont facultatives pour un nouveau magasin, lʼutilisation de lʼun de ces formats dʼURL dès le départ permet de réduire les efforts de migration à lʼavenir.

Compromis entre la longueur de lʼURL et les informations codées.

En fonction de la taille du catalogue, en particulier de la taille et de la profondeur de lʼarbre des catégories, il peut ne pas être raisonnable dʼencoder lʼurl_path complet des catégories dans lʼadresse URL. Dans ce cas, la longueur de lʼURL peut être réduite en incluant uniquement la url_key de la catégorie. Cette méthode permet de prendre en charge presque toutes les fonctionnalités disponibles lors de l’utilisation de l’url_path de la catégorie.

Utilisez également les mappages Sling pour combiner le SKU avec la url_key du produit. Dans la plupart des systèmes d’e-commerce, le SKU a un format particulier. La séparation du SKU de la url_key pour les requêtes entrantes ne devrait pas poser de problème. Dans cette optique, il devrait être possible de réécrire lʼadresse URL dʼune page produit en /p/{{category}}/{{sku}}-{{url_key}}.html, et lʼURL dʼune catégorie en /c/{{url_key}}.html, respectivement. Les préfixes /p et /c sont toujours nécessaires pour distinguer les pages de produits et de catégories des autres pages de contenu.

Migrer vers un nouveau format d’URL

De nombreux formats d’URL par défaut sont d’une manière ou d’une autre compatibles entre eux, ce qui signifie que les URL formatées par l’un peuvent être analysées par un autre. Cela permet la migration entre les formats d’URL.

D’un autre côté, les moteurs de recherche ont besoin d’un certain temps pour analyser à nouveau toutes les pages du catalogue avec le nouveau format d’URL. Pour prendre en charge ce processus et améliorer l’expérience de la personne utilisatrice finale, il est recommandé de fournir des redirections qui redirigent la personne utilisatrice des anciennes URL vers les nouvelles.

Une approche pour cela pourrait être de connecter un environnement d’évaluation au serveur principal de commerce électronique de production et de le configurer pour utiliser le nouveau format d’URL. Ensuite, obtenez le plan du site du produit généré par le générateur de plan du site des produits CIF pour les environnements d’évaluation et de production et utilisez-les pour créer une carte de réécriture Apache httpd. Cette carte de réécriture peut ensuite être déployée sur le Dispatcher en même temps que le déploiement du nouveau format d’URL.

Exemple

Le projet de magasin de référence Venia comprend des exemples de configuration afin de démontrer l’utilisation d’URL personnalisées pour les pages de produits et de catégories. Cette configuration permet à chaque projet de configurer des modèles d’URL individuels pour les pages de produits et de catégories en fonction de leurs besoins d’optimisation du moteur de recherche. Une combinaison de mappages UrlProvider et Sling CIF telle que décrite ci-dessus est utilisée.

Ressources supplémentaires

• Magasin de référence Venia
• Mappage des ressources AEM
• Mappages Sling