[SaaS uniquement]{class="badge positive" title="S’applique uniquement aux projets Adobe Commerce as a Cloud Service et Adobe Commerce Optimizer (infrastructure SaaS gérée par Adobe)."}

Cas d’utilisation complet de Storefront et de Catalog Administrator

Ce cas d’utilisation est basé sur un conglomérat automobile fictif appelé Carvelo Automobile, qui possède une configuration opérationnelle complexe. Il explique comment utiliser Adobe Commerce Optimizer pour gérer un catalogue qui prend en charge plusieurs marques, concessionnaires et tarifs, tout en offrant une expérience de storefront personnalisée.

Conditions préalables

Ce cas pratique est destiné aux administrateurs et aux développeurs qui souhaitent apprendre à configurer un storefront et à gérer un catalogue à l’aide de Adobe Commerce Optimizer. Cela suppose que vous ayez une compréhension de base de Adobe Commerce Optimizer et de ses fonctionnalités.

Temps estimé pour terminer : 45-60 minutes

Configuration requise

Avant de commencer ce tutoriel, assurez-vous que les conditions préalables suivantes sont en place :

  • Instance Adobe Commerce Optimizer

    • Accès à une instance de test dans Cloud Manager
    • Voir Prise en main pour obtenir des instructions de configuration
  • Autorisations utilisateur

    • Accès des administrateurs à Adobe Admin Console
    • Voir User Management pour la configuration des comptes
    • Si vous n’y avez pas accès, contactez votre représentant de compte Adobe.
  • Données d’exemple

  • Environnement Storefront

    • Environnement de développement local avec Node.js.
    • Projet standard Storefront cloné et configuré
    • Voir Configuration de Storefront pour obtenir des instructions détaillées

Commençons

Dans ce cas d’utilisation, vous travaillez avec les éléments suivants :

  1. Interface utilisateur de Adobe Commerce Optimizer - Configurez des vues et des politiques de catalogue pour gérer la configuration opérationnelle complexe du catalogue pour le cas d’utilisation de Carvelo.

  2. Storefront Commerce : effectuez le rendu du storefront à l’aide des exemples de données de catalogue chargées dans votre instance Adobe Commerce Optimizer et des fichiers de configuration, fstab.yaml et config.json du storefront Commerce.

NOTE
Découvrez les fichiers de configuration de storefront en consultant la rubrique Explorer le standard dans la documentation du storefront Adobe Commerce.

‌Principaux points à retenir

À la fin de cet article, vous pourrez :

  • Découvrez les principes de base de Adobe Commerce Optimizer avec son modèle de données de catalogue performant et évolutif.
  • Découvrez comment le modèle de données de catalogue s’intègre aux composants storefront indépendants de la plateforme créés par Adobe.
  • Découvrez comment utiliser les vues et politiques de catalogue Adobe Commerce Optimizer pour créer des vues de catalogue personnalisées et des filtres d’accès aux données, et envoyer les données à un storefront Adobe Commerce optimisé par Edge Delivery.

Scénario d'affaires - Carvelo Automobile

Carvelo Automobile est un conglomérat automobile fictif avec une configuration opérationnelle complexe.

Carvelo Automobile

Dans ce diagramme, vous voyez que Carvelo vend des produits automobiles de trois marques. Chaque marque est une entreprise enfant différente :

  • Aurora (véhicules électriques)
  • Boulon (SUV)
  • Cruz (hybride)

Elle vend ces marques par l'intermédiaire de trois concessionnaires :

  • Arkbridge
  • Kingsbluff
  • Celport

Ces concessionnaires appartiennent à deux sociétés mères différentes :

  • West Coast Inc. (Arkbridge) (en anglais seulement)
  • East Coast Inc. (Kingsbluff, Celport)

Chaque société possède deux registres des prix utilisés pour vendre des produits à un prix spécifique pour différents acheteurs (base, VIP).

  • west_coast_inc et vip_west_coast_inc
  • east_coast_inc et vip_east_coast_inc

Comme vous pouvez le constater, il s’agit d’un cas d’utilisation commerciale très complexe. Avec Adobe Commerce Optimizer, un commerçant peut prendre en charge une structure commerciale complexe à l’aide d’un catalogue de base unique pour syndiquer les données sans duplication de catalogue, adapter les tarifs (tarifs de plus de 30 000) et diffuser toutes ces données sur un storefront Edge Delivery Services.

Maintenant que vous disposez d’un aperçu du cas d’utilisation professionnel, voici votre objectif tout au long de ce tutoriel :

recommendation-more-help

Carvelo souhaite vendre des pièces de ses trois marques (Aurora, Bolt et Cruz) par l'intermédiaire des différents concessionnaires (Arkbridge, Kingsbluff et Celport). Carvelo veut s'assurer que les concessionnaires n'ont accès qu'aux pièces et aux prix corrects conformément à leurs accords de licence respectifs.

En fin de compte, Carvelo a deux objectifs principaux :

  1. Tenez à jour un site web « mondial », qui comporte tous les SKU des trois marques.
  2. Offrez aux concessionnaires un moyen de créer leurs propres vitrines en fonction de la visibilité et des prix uniques des SKU pour chaque SKU de chaque concessionnaire. Le tout lors de l’utilisation d’un seul catalogue de base, ce qui élimine la duplication de catalogue.

​1. Accéder à l’instance de Adobe Commerce Optimizer

Accédez à l’URL de l’application Commerce Optimizer préconfigurée avec les données d’exemple. Vous pouvez rechercher l’URL dans le gestionnaire Commerce Cloud à partir des détails de l’instance pour votre projet Commerce Optimizer ou l’obtenir auprès de votre administrateur système. (Voir Accès à une instance.)

Lorsque vous lancez Adobe Commerce Optimizer, les éléments suivants s’affichent :

Adobe Commerce Optimizer UI

NOTE
Consultez l’article présentation pour en savoir plus sur les composants clés de Adobe Commerce Optimizer’interface utilisateur.

Dans le volet de navigation de gauche, développez la section Configuration du magasin et cliquez sur Catalog views. Notez que les concessionnaires Arkbridge et Kingsbluff ont déjà créé des vues de catalogue :

Vues de catalogue existantes configurées pour les données d’exemple

NOTE
Pour l’instant, vous pouvez ignorer la vue catalogue globale.

Cliquez sur l’icône d’informations pour consulter les détails de la vue du catalogue.

Les politiques d’Arkbridge sont les suivantes :

  • Marque
  • Modèle
  • Marques de West Coast Inc
  • Catégories de pièces Arkbridge

Kingsbluff a les politiques suivantes :

  • Marque
  • Modèle
  • Marques de East Coast Inc
  • Catégories de pièces Kingsbluff

Dans la section suivante, vous allez créer une vue de catalogue et des politiques pour le concessionnaire Celport.

​2. Créer une vue de politique et de catalogue

Le directeur du commerce de Carvelo doit mettre en place une nouvelle vitrine pour un concessionnaire appelé Celport qui appartient à la société East Coast Inc. Celport commercialisera des freins et des suspensions pour les marques Bolt et Cruz.

Distributeur Celport

À l’aide de Adobe Commerce Optimizer, le gestionnaire de commerce :

  1. Créez une nouvelle politique appelée Catégories de pièces Celport pour que Celport vende uniquement des pièces de frein et de suspension.

  2. Créez une vue de catalogue pour le storefront Celport.

    Cette vue catalogue utilise votre nouvelle politique catégories de pièces Celport et les marques existantes East Coast Inc pour vous assurer que Celport ne peut vendre que les marques Bolt et Cruz dans le cadre de l'accord avec East Coast Inc. La vue catalogue Celport utilise le catalogue east_coast_inc pour prendre en charge les barèmes de prix de produits qui s'alignent sur les accords de licence de la marque.

  3. Mettez à jour la configuration du storefront Commerce pour utiliser les données de la vue de catalogue Celport que vous avez créée.

À la fin de cette section, Celport sera opérationnel et prêt à vendre les produits de Carvelo.

Créer une politique

Créons une nouvelle politique appelée Catégories de pièces Celport pour filtrer les SKU que le concessionnaire Celport vend, qui incluent les pièces de frein et de suspension.

  1. Dans le rail de gauche, développez la section Configuration du magasin et cliquez sur Policies.

  2. Cliquez sur Create Policy.

    Une nouvelle page s’affiche pour ajouter les détails de la politique.

  3. Ajoutez les détails requis :

    Nom = Catégories de pièces Celport

  4. Cliquez sur Add Filter.

    Une boîte de dialogue s’affiche pour ajouter des détails de filtre.

  5. Ajoutez les détails du filtre :

    • Attribute = part_category
    • Opérateur = IN
    • Valeur Source = STATIC
    • Valeur = freins
    • Valeur = suspension
    note important
    IMPORTANT
    Chaque valeur d’attribut doit être saisie séparément. Après avoir saisi une valeur, appuyez sur Entrée pour l’ajouter à la configuration du filtre. Saisissez ensuite la valeur suivante. Toutes les valeurs doivent correspondre exactement au nom de l’attribut SKU dans le catalogue.

    Pour en savoir plus sur la différence entre une source de valeurs STATIQUE et TRIGGER, voir types de sources de valeurs.

  6. Dans la boîte de dialogue Filter details, cliquez sur Save.

  7. Pour activer le filtre que vous venez de créer, cliquez sur les points d’action (…) et sélectionnez Activer.

  8. Cliquez sur Save.

    note note
    NOTE
    Si le bouton Save n’est pas actif (bleu), il se peut que le nom de la politique vous manque. Cliquez sur l’icône en forme de crayon en regard de Nouvelle politique pour l’ajouter.
  9. Revenez à la liste des politiques en cliquant sur la flèche Précédent.

    Votre nouvelle stratégie Celport part categories apparaît dans la liste.

Pour vérifier que cette étape a été correctement effectuée :

  • La politique apparaît dans la liste des politiques
  • Le statut de la politique s’affiche comme étant activé (indicateur vert)
  • Les détails du filtre indiquent « part_category IN (freins, suspension) »
  • Le nom de la stratégie est « Couvrir les catégories de pièces »

Création d’une vue de catalogue

Créez une nouvelle vue de catalogue pour le concessionnaire Celport et liez les politiques suivantes : marques East Coast Inc et Catégories de pièces Celport.

  1. Dans le rail de gauche, développez la section Configuration du magasin et cliquez sur Catalog views.

    Notez les vues de catalogue existantes : Arkbridge, Kingsbluff et Global.

    Page Vues de catalogue existantes

  2. Cliquez sur Add catalog view.

  3. Renseignez les détails de la vue Catalogue :

    • Name = Celport
    • Sources de catalogue = fr-FR
    • Politiques (liste déroulante d’utilisation) = Marques East Coast Inc; Catégories de pièces Celport; Marque; Modèle
  4. Cliquez sur Add pour créer la vue de catalogue.

    La page Vues du catalogue se met à jour pour afficher la nouvelle vue du catalogue.

    Liste des vues de catalogue mise à jour

  5. Obtenez l’identifiant de vue du catalogue Celport.

    Cliquez sur l’icône d’informations correspondant à la vue Catalogue Celport sur la page Vues Catalogue.

    Identifiant de vue de catalogue Celport

    Copiez et enregistrez l’ID de vue de catalogue. Vous avez besoin de cet identifiant lorsque vous mettez à jour la configuration du storefront pour fournir des données à votre nouveau catalogue Celport.

    Pour vérifier que cette étape a été correctement effectuée :

    • Le nom de la vue Catalogue est « Celport »
    • La vue Catalogue affiche 4 politiques associées
    • L’ID de vue de catalogue s’affiche et peut être copié
    • La source du catalogue affiche « en-US ».

Après avoir créé la vue de catalogue Celport et les politiques associées, l’étape suivante consiste à configurer le storefront pour utiliser votre nouveau catalogue Celport.

​3. Mettre à jour votre storefront

La dernière partie de ce tutoriel implique la mise à jour du storefront que vous avez déjà créé pour diffuser des données vers le nouveau catalogue Celport. Dans cette section, remplacez l’ID de vue de catalogue dans votre fichier de configuration de storefront par l’ID de vue de catalogue pour Celport.

  1. Dans votre environnement de développement local, ouvrez le dossier dans lequel vous avez cloné le référentiel GitHub avec vos fichiers de configuration storefront standard.

  2. Dans le répertoire racine du dossier, ouvrez le fichier config.json.

    accordion
    code config.json
    code language-json
    {
     "public": {
       "default": {
       "commerce-core-endpoint": "https://www.aemshop.net/graphql",
       "commerce-endpoint": "https://na1-sandbox.api.commerce.adobe.com/Fwus6kdpvYCmeEdcCX7PZg/graphql",
       "headers": {
          "cs": {
             "ac-view-id": "9ced53d7-35a6-40c5-830e-8288c00985ad",
             "ac-price-book-id": "west_coast_inc",
             "ac-source-locale": "en-US"
            }
          },
          "analytics": {
             "base-currency-code": "USD",
             "environment": "Production",
             "store-id": 1,
             "store-name": "ACO Demo",
             "store-url": "https://www.aemshop.net",
             "store-view-id": 1,
             "store-view-name": "Default Store View",
             "website-id": 1,
             "website-name": "Main Website"
           }
        }
       }
    }
    

    Notez que l’en-tête de la vue Catalogue comprend les valeurs suivantes :

    • commerce-endpoint : "https://na1-sandbox.api.commerce.adobe.com/Fwus6kdpvYCmeEdcCX7PZg/graphql"
    • ac-view-id:"9ced53d7-35a6-40c5-830e-8288c00985ad"
    • ac-price-book-id : "west_coast_inc"
    • ac-source-locale : "en-US"
  3. Dans la valeur commerce-endpoint , remplacez l’ID du client dans l’URL par l’URL de votre instance Adobe Commerce Optimizer.

    L’ID du client se trouve dans l’URL de l’interface utilisateur de Commerce Optimizer. Par exemple, dans l’URL suivante, l’identifiant client est XDevkG9W6UbwgQmPn995r3.

    code language-text
    https://experience.adobe.com/#/@commerceprojectbeacon/in:XDevkG9W6UbwgQmPn995r3/commerce-optimizer-studio/catalog
    
  4. Remplacez la valeur ac-view-id par l’ID de vue du catalogue Celport que vous avez copié précédemment.

  5. Remplacez la valeur ac-price-book-id par "east_coast_inc".

    Après avoir apporté ces modifications, votre fichier config.json doit ressembler à ce qui suit, les espaces réservés ACO-tenant-id et celport-catalog-view-id devant être remplacés par vos valeurs :

    code language-json
    {
      "public": {
         "default": {
         "commerce-core-endpoint": "https://www.aemshop.net/graphql",
         "commerce-endpoint": "https://na1-sandbox.api.commerce.adobe.com/{{ACO-tenant-id}}/graphql",
         "headers": {
             "cs": {
                 "ac-view-id": "{{celport-catalog-view-id}}",
                 "ac-price-book-id": "east_coast_inc",
                 "ac-source-locale": "en-US"
               }
             },
             "analytics": {
                 "base-currency-code": "USD",
                 "environment": "Production",
                 "store-id": 1,
                 "store-name": "ACO Demo",
                 "store-url": "https://www.aemshop.net",
                 "store-view-id": 1,
                 "store-view-name": "Default Store View",
                 "website-id": 1,
                 "website-name": "Main Website"
              }
          }
      }
    }
    
  6. Enregistrez le fichier.

    Lorsque vous enregistrez les modifications, vous mettez à jour la configuration du catalogue pour utiliser la vue de catalogue Carvelo qui a été configurée pour vendre uniquement des pièces de frein et de suspension.

​4. Prévisualiser le storefront

Maintenant que vous avez mis à jour la configuration du storefront pour utiliser la vue de catalogue Celport, vous pouvez prévisualiser le storefront pour voir comment il effectue le rendu des données du catalogue.

  1. Lancez le storefront pour afficher l’expérience de catalogue spécifique à Celport créée par votre configuration de storefront.

    1. Dans la fenêtre du terminal de votre IDE, démarrez l’aperçu de votre storefront local.

      code language-shell
      npm start
      

      Le navigateur s’ouvre dans l’aperçu du développement local sur http://localhost:3000.

      Si la commande échoue ou si le navigateur ne s’ouvre pas, consultez les instructions pour le développement local dans la rubrique Configuration de Storefront .

  2. Dans le navigateur, recherchez brakes et appuyez sur Entrée.

    Le storefront se met à jour pour afficher la page de liste de produits affichant les pièces de frein.

    Page de liste des produits Freins

    Cliquez sur une image de pièce de frein pour afficher les détails du produit avec les informations de prix et notez les informations de prix du produit.

  3. Recherchez tires, qui est une autre catégorie d’articles disponible dans les données de cas d’utilisation de votre instance Adobe Commerce Optimizer.

    Configuration de storefront avec des en-têtes incorrects

    Notez qu’aucun résultat n’est renvoyé. Ceci est dû au fait que la vue Catalogue Celport a été configurée pour vendre uniquement des pièces de frein et de suspension.

  4. Testez la mise à jour de votre fichier de configuration de storefront (config.json).

    1. Modifiez les valeurs ac-view-id et ac-price-book.

    Par exemple, vous pouvez remplacer l'ID de vue de catalogue par la vue de catalogue Kingsbluff et l'ID de catalogue par east_coast_inc. Vous pouvez voir les catégories de pièces disponibles pour Kingsbluff en examinant la politique Catégories de pièces Kingsbluff.

    1. Enregistrez le fichier.

      Lorsque vous enregistrez le fichier, l’aperçu du storefront local se met automatiquement à jour.

    2. Prévisualisez les modifications dans le navigateur à l'aide de la fonction Rechercher pour rechercher des pièces de pneumatique.

      Notez les différents types de pièces disponibles et les prix attribués à la vue catalogue Kingsbluff.

    Ces expériences illustrent la flexibilité de Adobe Commerce Optimizer : vous pouvez rapidement basculer entre différentes vues de catalogue et tarifs afin de créer des expériences d’achat personnalisées pour différentes audiences sans dupliquer les données de votre catalogue.

Dépannage

Si vous rencontrez des problèmes au cours de ce tutoriel, essayez les solutions suivantes :

Problèmes de création de politique

Problème : le bouton Enregistrer n’est pas actif

  • Solution : assurez-vous que le nom de la politique est saisi et que tous les champs obligatoires sont renseignés

Problème : filtre ne fonctionne pas comme prévu

  • Solution : vérifiez que le nom de l’attribut correspond exactement à l’attribut de SKU dans votre catalogue

Événements de la vue Catalogue

Problème : vue Catalogue n’apparaît pas dans la liste

  • Solution : vérifiez que toutes les politiques associées sont activées et correctement configurées

Problèmes de configuration du storefront

Problème : le storefront ne se charge pas

  • Solution : vérifiez que votre identifiant client et votre identifiant de vue de catalogue sont correctement saisis dans le fichier config.json

Problème : Aucun produit ne s’affiche

  • Solution : vérifiez que l'ID du catalogue des prix correspond à celui disponible dans votre instance Adobe Commerce Optimizer

Problème : recherche ne renvoyant aucun résultat

  • Solution : vérifiez que les politiques d’affichage du catalogue autorisent la catégorie de produits recherchée

Pour obtenir de l’aide supplémentaire, consultez la documentation de Adobe Commerce Optimizer ou contactez l’assistance technique d’Adobe.

Résumé

Dans ce tutoriel, vous avez réussi à :

  • Création d'une nouvelle politique pour filtrer les catégories de produits pour le concessionnaire Celport
  • Configurer une vue de catalogue avec plusieurs politiques pour contrôler la visibilité du produit
  • Configuration d’un storefront pour utiliser la nouvelle vue de catalogue
  • Vérification de la configuration en testant la visibilité et le prix du produit

Étapes suivantes

Pour continuer à en savoir plus sur Adobe Commerce Optimizer :

bd545cdc-f6ec-4be2-962c-39295172b339