[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)."}

Configurer votre storefront

Ce guide vous guide tout au long de la configuration d’un storefront pour votre instance Adobe Commerce Optimizer à l’aide d’Adobe Edge Delivery Services. Votre storefront comprend du code standard, un exemple de contenu et une assistance pour les pages de détails du produit et la découverte de produits (recherche et filtrage).

Délai d’exécution estimé : entre 30 et 45 minutes

Conditions préalables

  • Compte GitHub qui peut créer des référentiels et qui est configuré pour le développement local (github.com).
  • Adobe Commerce Optimizerinstance avec des exemples de données et des vues de catalogue et des politiques configurées

Données d’instance requises

Avant de commencer, collectez les informations suivantes à partir de votre instance Adobe Commerce Optimizer :

  • Identifiant client (également appelé identifiant d’instance)
  • point d’entrée GraphQL pour votre instance
  • Identifiant de la vue Catalogue pour la vue Catalogue globale
  • Paramètres régionaux Source pour la vue de votre catalogue
    • La valeur par défaut pour les données d’exemple est en_US
NOTE
Les clients disposant d’un accès d’évaluation peuvent trouver le point d’entrée GraphQL dans l’e-mail de bienvenue reçu lors de la création de votre instance. Les instances d’évaluation sont préconfigurées avec des exemples de données, des vues de catalogue et des politiques.

Étapes de configuration

  1. Créer votre projet de storefront-Utilisez l’outil Créateur de site pour créer un projet de storefront avec un code standard, un exemple de contenu et un fichier de configuration.

  2. Personnaliser la configuration storefront-Mettez à jour le fichier config.json dans votre référentiel pour vous connecter à votre instance Adobe Commerce Optimizer.

  3. Vérification de la configuration (10 minutes)

    • Prévisualiser votre site storefront
    • Tester les pages de détails du produit et la fonctionnalité de recherche

Créer votre projet storefront

L’outil Créateur de site crée un projet de storefront complet avec les composants suivants :

  • Site : page de destination de storefront avec du contenu standard
  • Code : référentiel contenant des fichiers sources standard.
  • Contenu : environnement de création de documents avec des fichiers de contenu de site.
  • Configuration Commerce : fichier config.json pour une configuration spécifique à l'instance

Étape 1 : générer votre projet

  1. Ouvrez l’outil Créateur de site

    Site Creator tool {width="700" modal="regular"}

  2. Sélectionnez Créer un site (code et contenu).

  3. Effectuez la configuration du site :

    • Organisation/nom d’utilisateur GitHub : saisissez votre nom d’utilisateur ou d’organisation GitHub
    • Nom du site : choisissez un nom explicite pour votre storefront
    • Point d’entrée Commerce GraphQL (facultatif) : saisissez le point d’entrée GraphQL de votre instance Adobe Commerce Optimizer
  4. Cliquez sur Créer un site pour créer le référentiel GitHub avec le code standard du storefront.

    Lorsque le référentiel est créé, le créateur du site se met à jour et vous invite à installer l’application de synchronisation du code.

Étape 2 : installer l’application de synchronisation du code

  1. Cliquez sur Install AEM Code Sync App pour ouvrir le programme d’installation de la synchronisation du code dans un nouvel onglet.

  2. Configurez l’application de synchronisation du code :

    • Sélectionnez votre organisation GitHub, puis cliquez sur Configure.
    • Dans l’interface de synchronisation du code, cliquez sur Only select repositories.
    • Cliquez sur le menu Select repositories, puis choisissez le référentiel de code storefront que vous avez créé.
    • Cliquez sur Save pour enregistrer votre référentiel.
  3. Revenez à la fenêtre du navigateur dans laquelle le créateur du site est ouvert, puis cliquez sur Créer un site.

    Le créateur du site copie le contenu standard du storefront dans l’environnement de création de documents. Ce processus prend entre 1 et 2 minutes.

Étape 3 : enregistrer les liens de votre projet

  1. Dans la section Détails du site , passez en revue les liens de votre projet de storefront :

    Storefront setup complete {width="700" modal="regular"}

    Utilisez ces liens pour gérer le code, le contenu et la configuration de votre storefront.

  2. Copiez et enregistrez ces liens pour référence ultérieure : cliquez sur **Copy.

Configuration de votre storefront

Mettez à jour la configuration de storefront pour vous connecter à votre instance Adobe Commerce Optimizer.

  1. Ouvrez Configuration Manager à l’aide du lien que vous avez enregistré précédemment :

    https://da.live/sheet#/<username or org>/<repo name>/config.json

  2. Recherchez la section cs (Catalog Service) dans la configuration.

  3. Remplacez les valeurs d’espace réservé par les valeurs de votre instance. Voir Conditions préalables.

    code language-json
    "cs": {
       "AC-View-ID": "{catalogViewId}",
       "AC-Environment-ID": "{tenantId}",
       "AC-Source-Locale": "en_US"
    }
    
  4. Enregistrez le fichier de configuration.

NOTE
La propagation des modifications de configuration peut prendre quelques minutes. Si vous ne voyez pas immédiatement les données, attendez 2 à 3 minutes avant de procéder au dépannage.

Vérification de la configuration

Testez votre storefront pour vous assurer qu’il est correctement connecté à votre instance Adobe Commerce Optimizer.

Étape 1 : afficher votre page d’accueil storefront

  1. Accédez à votre URL d’aperçu en direct :

    https://main--{SITE}--{ORG}.aem.live

    Remplacez {ORG} et {SITE} par le nom de votre organisation et de votre site GitHub.

  2. Critères de réussite : vous devriez voir la page d’accueil du storefront avec du contenu standard.

    ACO storefront site with boilerplate {width="700" modal="regular"}

Étape 2 : test des pages de détails du produit

Affichez la page des détails du produit par défaut pour vérifier que les données du produit se chargent correctement.

  1. Accédez à un exemple de page de produit :
    https://main--{SITE}--{ORG}.aem.live/products/placeholder/{sku}

    Utilisez n’importe quel SKU de vos données d’exemple, par exemple :
    https://main--{SITE}--{ORG}.aem.live/products/placeholder/aur-flu-tir-std-2017

    Pour le storefront par défaut, vous pouvez utiliser la valeur placeholder dans l’itinéraire pour afficher le produit. Lorsque vous commencez à personnaliser votre storefront, vous pouvez personnaliser le code de storefront pour définir le chemin d’accès à la page des détails du produit en fonction des itinéraires de produit définis dans votre catalogue.

    note tip
    TIP
    Affichez les SKU disponibles à partir de la page Synchronisation des données dans votre instance Adobe Commerce Optimizer.
  2. Critères de réussite : la page doit afficher :

    • Nom, description et prix du produit
    • Images du produit
    • Fonctionnalité Ajouter au panier
    • Données extraites de votre instance Adobe Commerce Optimizer

    Default product detail page showing a product from the sample data {width="700" modal="regular"}

Étape 3 : tester la fonctionnalité de recherche par défaut

Testez les fonctionnalités du produit par défaut, notamment la recherche et le filtrage.

  1. Sur la page d’accueil du storefront, cliquez sur l’icône de loupe dans l’en-tête.

  2. Saisissez la chaîne de recherche tires et appuyez sur Entrée.

  3. Critères de réussite : vous devriez voir :

    • Page de résultats de recherche avec produits pneumatiques
    • Options de filtrage dans la barre latérale
    • Listes de produits avec images et prix

    View search results page {width="675" modal="regular"}

  4. Cliquez sur n'importe quel produit de pneu pour voir sa page détaillée.

    View product details page {width="675" modal="regular"}

Dépannage

Si vous rencontrez des problèmes lors de la configuration, utilisez la console Inspecteur de page web pour rechercher des erreurs. Essayez également d’effacer le cache de votre navigateur ou utilisez un autre navigateur.

Suivez les conseils suivants pour vérifier les problèmes courants :

Problèmes courants

Problème
Symptômes
Solution
Échec de l’installation de la synchronisation du code
Impossible de terminer la configuration de la synchronisation du code
  • Vérifiez que vous disposez d’un accès administrateur à votre organisation GitHub.
  • Essayez d’utiliser un référentiel personnel au lieu d’une organisation.
  • Vérifiez les autorisations GitHub et réessayez.
Site non chargé
Erreurs 404 ou de connexion
  • Vérifiez le format de l’URL de votre site : https://main--{SITE}--{ORG}.aem.live
  • Vérifiez que l’application de synchronisation du code est correctement installée.
  • Assurez-vous que le référentiel est public ou correctement configuré.
Aucune donnée de produit affichée
Les pages de produits affichent des espaces réservés ou des erreurs
  • Vérifiez vos valeurs de configuration dans config.json
  • Dans l’instance Adobe Commerce Optimizer, vérifiez la page Synchronisation des données pour vous assurer que les exemples de produits sont chargés. Si aucun produit n’est disponible, rechargez les données d’exemple ou ajoutez un produit à l’aide de l’API Data Ingestion. Patientez quelques minutes pour que les modifications de configuration se propagent.
  • Essayez de récupérer les détails du produit à l’aide de la requête products du service de marchandisage en utilisant les mêmes en-têtes que ceux configurés dans le fichier config.json. Si vous pouvez récupérer les données, il s’agit probablement d’un problème lié à la configuration de la vue de catalogue ou d’une erreur d’index.
La recherche ne renvoie aucun résultat
Page de résultats de recherche vide
  • Vérifiez que vous pouvez récupérer les résultats de la recherche de produit à l’aide des services de marchandisage requête productSearch en utilisant les mêmes en-têtes configurés dans le fichier config.json. Si vous pouvez récupérer les données, il s’agit probablement d’un problème lié à la configuration de la vue de catalogue ou d’une erreur d’index.
  • Vérifiez que l’ID de vue de catalogue dans le fichier config.json correspond à l’ID de vue de catalogue dans Adobe Commerce Optimizer.
  • Dans Adobe Commerce Optimizer, vérifiez la configuration des politiques, des paramètres régionaux et des tarifs que vous avez utilisés dans la configuration de l’en-tête du storefront.
  • Vérifiez que les paramètres de métadonnées d’attribut sont correctement définis pour la recherche.

Liste de contrôle de validation

Avant de passer aux étapes suivantes, vérifiez que votre storefront fonctionne correctement en vérifiant les éléments suivants :

Liste de contrôle Les valeurs de configuration correspondent aux paramètres de votre instance

Liste de contrôle la page d’accueil de Storefront se charge sans erreur

Liste de contrôle au moins une page de détails du produit affiche des informations complètes

Liste de contrôle la fonctionnalité de recherche renvoie des résultats pertinents

Liste de contrôle Les images du produit se chargent correctement

Liste de contrôle Les valeurs de configuration correspondent aux paramètres de votre instance

Obtenir de l’aide

Si les problèmes persistent :

Étapes suivantes

Après avoir configuré et vérifié votre storefront, vous pouvez :

  1. Installer Sidekick - Extension de navigateur pour la modification, la prévisualisation et la publication de contenu directement à partir de votre site web

  2. Configuration d’un environnement de développement local - Créez un environnement local pour personnaliser le code et le contenu de votre storefront

Apprendre et explorer

recommendation-more-help
bd545cdc-f6ec-4be2-962c-39295172b339