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
- Voir Ajouter des données d’exemple pour obtenir des instructions de configuration.
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)
- Disponible à partir de la page Détails de l’instance
- point d’entrée GraphQL pour votre instance
- Disponible à partir de la page Détails de l’instance
- Identifiant de la vue Catalogue pour la vue Catalogue globale
- Disponible à partir de la page Détails du catalogue
- 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
- La valeur par défaut pour les données d’exemple est
Étapes de configuration
-
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.
-
Personnaliser la configuration storefront-Mettez à jour le fichier
config.jsondans votre référentiel pour vous connecter à votre instance Adobe Commerce Optimizer. -
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.jsonpour une configuration spécifique à l'instance
Étape 1 : générer votre projet
-
Ouvrez l’outil Créateur de site
{width="700" modal="regular"}
-
Sélectionnez Créer un site (code et contenu).
-
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
-
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
-
Cliquez sur Install AEM Code Sync App pour ouvrir le programme d’installation de la synchronisation du code dans un nouvel onglet.
-
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.
-
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
-
Dans la section Détails du site , passez en revue les liens de votre projet de storefront :
{width="700" modal="regular"}
Utilisez ces liens pour gérer le code, le contenu et la configuration de votre storefront.
-
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.
-
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 -
Recherchez la section
cs(Catalog Service) dans la configuration. -
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" } -
Enregistrez le fichier de configuration.
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
-
Accédez à votre URL d’aperçu en direct :
https://main--{SITE}--{ORG}.aem.liveRemplacez
{ORG}et{SITE}par le nom de votre organisation et de votre site GitHub. -
Critères de réussite : vous devriez voir la page d’accueil du storefront avec du contenu standard.
{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.
-
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-2017Pour le storefront par défaut, vous pouvez utiliser la valeur
placeholderdans 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. -
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
{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.
-
Sur la page d’accueil du storefront, cliquez sur l’icône de loupe dans l’en-tête.
-
Saisissez la chaîne de recherche
tireset appuyez sur Entrée. -
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
{width="675" modal="regular"}
-
Cliquez sur n'importe quel produit de pneu pour voir sa page détaillée.
{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
- 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.
- 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é.
- 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.
- 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.jsoncorrespond à 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 :
Obtenir de l’aide
Si les problèmes persistent :
- Consultez la documentation du storefront Adobe Commerce
- Consultez le guide du développeur de Adobe Commerce Optimizer 🔗
- Consultez les ressources d’assistance Adobe Commerce
Étapes suivantes
Après avoir configuré et vérifié votre storefront, vous pouvez :
-
Installer Sidekick - Extension de navigateur pour la modification, la prévisualisation et la publication de contenu directement à partir de votre site web
-
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
-
Complétez le cas pratique de bout en bout - En savoir plus sur la configuration de storefront et la gestion des catalogues à l’aide de Adobe Commerce Optimizer
-
Explorer la personnalisation du storefront - Découvrez les options de configuration et de configuration avancées.
-
Utiliser les listes déroulantes Commerce pour personnaliser l’expérience storefront-Ajoutez des composants préconfigurés pour améliorer votre expérience storefront