Winefront instellen
Deze handleiding begeleidt u bij het instellen van een winkel voor uw Adobe Commerce Optimizer -instantie met Adobe Edge Delivery Services. Uw winkel bevat bouwsteencode, voorbeeldinhoud en ondersteuning voor productdetailpagina's en productdetectie (zoeken en filteren).
Geschatte tijd om te voltooien: 30-45 minuten
Vereisten
- GitHub rekening die bewaarplaatsen kan tot stand brengen en voor lokale ontwikkeling (github.com) gevormd is
- Adobe Commerce Optimizer-instantie met voorbeeldgegevens en geconfigureerde catalogusweergaven en beleidsregels
- Zie steekproefgegevens voor opstellingsinstructies toevoegen.
Vereiste instance-gegevens
Verzamel voordat u begint de volgende informatie van uw Adobe Commerce Optimizer -instantie:
- Identiteitskaart van de Aannemer (ook genoemd instantiidentiteitskaart)
- Beschikbaar bij de pagina van instantiedetails
- eindpunt van GraphQL voor uw instantie
- Beschikbaar bij de pagina van instantiedetails
- identiteitskaart van de mening van de Catalogus voor de globale catalogusmening
- Beschikbaar bij de pagina van catalogusdetails
- Source scène voor uw catalogusmening
- Standaard voor voorbeeldgegevens is
en_US
- Standaard voor voorbeeldgegevens is
Stappen instellen
-
creeer uw storefront project - gebruik het hulpmiddel van de Maker van de Plaats om een nieuw storefront project met boilerplate code, steekproefinhoud, en een configuratiedossier tot stand te brengen.
-
pas de storefrontconfiguratie aan - werk het
config.jsondossier in uw bewaarplaats bij om met uw Adobe Commerce Optimizer instantie te verbinden. -
verifieer uw opstelling (10 min)
- Een voorvertoning van uw winkelsite weergeven
- Productdetailpagina's en zoekfunctionaliteit testen
Uw winkelproject maken
Met het gereedschap Sitemaker maakt u een volledig storefront-project met de volgende componenten:
- Plaats: Storefront het landen pagina met boilerplate inhoud
- Code: Bewaarplaats met boilerplate brondossiers
- Inhoud: Het milieu van de Auteur van het document met de dossiers van de plaatsinhoud
- Commerce Config:
config.jsondossier voor instantie-specifieke configuratie
Stap 1: Genereer uw project
-
Open het hulpmiddel van de Maker van de Plaats
{width="700" modal="regular"}
-
Selecteer creeer Nieuwe Plaats (Code & Inhoud).
-
Voltooi de siteconfiguratie:
- GitHub Organisatie/Gebruikersnaam: Ga uw GitHub gebruikersbenaming of organisatienaam in
- Naam van de Plaats: Kies een beschrijvende naam voor uw storefront
- Commerce GraphQL Endpoint (facultatief): ga het eindpunt van GraphQL voor uw Adobe Commerce Optimizer instantie in
-
Klik creeer Plaats om de bewaarplaats GitHub met de storefront boilerplate code tot stand te brengen.
Wanneer de gegevensopslagruimte is gemaakt, wordt de Site Creator bijgewerkt en wordt u gevraagd de app Codesync te installeren.
Stap 2: De app Codesync installeren
-
Klik op Install AEM Code Sync App om het installatieprogramma voor codesynchronisatie te openen op een nieuw tabblad.
-
Configureer de app Codesync:
- Selecteer uw organisatie GitHub, dan klik Configure.
- Klik in de interface Codesynchronisatie op Only select repositories .
- Klik op het menu Select repositories en kies vervolgens de opslagplaats voor de storefront-code die u hebt gemaakt.
- Klik op Save om uw opslagplaats te registreren.
-
Terugkeer aan het browser venster waar de Maker van de Plaats open is, en klik creeer Plaats.
De maker van de site kopieert de inhoud van het storefront boilerplate naar de omgeving van de auteur van het document. Dit proces duurt 1 tot 2 minuten.
Stap 3: Sla uw projectkoppelingen op
-
In de sectie van de Details van de Plaats, herzie de verbindingen voor uw archiefproject:
{width="700" modal="regular"}
Gebruik deze koppelingen om uw winkelcode, inhoud en configuratie te beheren.
-
Kopieer en sla deze verbindingen voor toekomstige verwijzing op: Klik ** Copy.
Uw winkel configureren
Werk uw storefront configuratie bij om met uw Adobe Commerce Optimizer instantie te verbinden.
-
Open configuratiebeheer met behulp van de koppeling die u eerder hebt opgeslagen:
https://da.live/sheet#/<username or org>/<repo name>/config.json -
Zoek de sectie
cs(Catalog Service) in de configuratie. -
Vervang de waarden van de plaatsaanduiding door de waarden voor de instantie. Zie Eerste vereisten .
code language-json "cs": { "AC-View-ID": "{catalogViewId}", "AC-Environment-ID": "{tenantId}", "AC-Source-Locale": "en_US" } -
Sla het configuratiebestand op.
Uw instellingen controleren
Test uw storefront om te controleren of deze correct is verbonden met uw Adobe Commerce Optimizer -instantie.
Stap 1: je winkelhomepage bekijken
-
Ga naar de URL van uw live voorvertoning:
https://main--{SITE}--{ORG}.aem.liveVervang
{ORG}en{SITE}door uw GitHub-organisatie en sitenaam. -
criteria van het Succes: U zou de storefront homepage met boilerplate inhoud moeten zien.
{width="700" modal="regular"}
Stap 2: pagina's met productdetails testen
Bekijk de standaardpagina met productdetails om te controleren of de productgegevens correct worden geladen.
-
Ga naar een voorbeeldproductpagina:
https://main--{SITE}--{ORG}.aem.live/products/placeholder/{sku}Gebruik om het even welke SKU van uw steekproefgegevens, bijvoorbeeld:
https://main--{SITE}--{ORG}.aem.live/products/placeholder/aur-flu-tir-std-2017Voor de standaardwinkel kunt u de
placeholder-waarde in de route gebruiken om het product weer te geven. Wanneer u begint met het aanpassen van uw winkel, kunt u de storefront code aanpassen om de weg aan de pagina van het productdetail te plaatsen die op productroutes wordt gebaseerd die in uw catalogus worden bepaald.note tip TIP Bekijk beschikbare SKUs van de pagina van de Synchronisatie van Gegevens in uw Adobe Commerce Optimizer instantie. -
criteria van het Succes: De pagina zou moeten tonen:
- Productnaam, beschrijving en prijs
- Productafbeeldingen
- Toevoegen aan tekengebied
- Gegevens opgehaald uit uw Adobe Commerce Optimizer -instantie
{width="700" modal="regular"}
Stap 3: Test de standaardzoekfunctionaliteit
Test de standaardproductfuncties, inclusief zoeken en filteren.
-
Klik op de startpagina van de winkel op het vergrootglaspictogram in de koptekst.
-
Typ het onderzoekskoord
tiresen druk binnengaan. -
criteria van het Succes: U zou moeten zien:
- Pagina met zoekresultaten met bandenproducten
- Filteropties in de zijbalk
- Productaanbiedingen met afbeeldingen en prijzen
{width="675" modal="regular"}
-
Klik op een bandenproduct om de detailpagina weer te geven.
{width="675" modal="regular"}
Problemen oplossen
Als u tijdens de installatie problemen ondervindt, controleert u op fouten met de console van de webpaginacontrole. Wis ook de browsercache of gebruik een andere browser.
Gebruik de volgende richtlijnen voor het controleren van veelvoorkomende problemen:
Algemene kwesties
- Verzeker u beheerdertoegang tot uw organisatie GitHub hebt.
- Probeer een persoonlijke opslagplaats in plaats van een organisatie te gebruiken.
- Controleer GitHub-machtigingen en probeer het opnieuw.
- Verifieer de URL-indeling van uw site:
https://main--{SITE}--{ORG}.aem.live - Controleer of de toepassing Codesync correct is geïnstalleerd.
- Zorg ervoor dat de opslagplaats openbaar is of correct is geconfigureerd.
- De configuratiewaarden controleren in
config.json - Controleer in de Adobe Commerce Optimizer -instantie de pagina Gegevenssynchronisatie om te controleren of er voorbeeldproducten zijn geladen. Als geen producten beschikbaar zijn, laad de steekproefgegevens opnieuw of voeg een product toe gebruikend Ingestie API van Gegevens . Wacht een paar minuten op configuratieveranderingen om zich te verspreiden.
- Probeer de productdetails terug te winnen gebruikend de Merchandising de productvraag van de Dienst gebruikend de zelfde kopballen die in het
config.jsondossier worden gevormd. Als u de gegevens kunt ophalen, is dit waarschijnlijk een probleem met de configuratie van de catalogusweergave of een indexfout.
- Verifieer dat u de resultaten van het productonderzoek kunt terugwinnen gebruikend de Merchandising de vraag van de Diensten productSearch gebruikend de zelfde kopballen die in het
config.jsondossier worden gevormd. Als u de gegevens kunt ophalen, is dit waarschijnlijk een probleem met de configuratie van de catalogusweergave of een indexfout. - Controleer of de weergave-id van de catalogus in het
config.json-bestand overeenkomt met de weergave-id van de catalogus in Adobe Commerce Optimizer . - In Adobe Commerce Optimizer, verifieer de configuratie van het beleid, de scène, en de prijsboeken die u in de configuratie van de storefrontkopbal gebruikte.
- Verifieer de montages van attributenmeta-gegevens correct voor onderzoek worden geplaatst.
Controlelijst voor validatie
Voordat u verdergaat met de volgende stappen, moet u controleren of de winkel correct werkt. Ga hiervoor als volgt te werk:
aan
terug
aan
Hulp vragen
Als er problemen blijven optreden:
Volgende stappen
Nadat u uw winkel hebt ingesteld en geverifieerd, kunt u:
-
installeer Sidekick - Browser uitbreiding voor het uitgeven, het previewing, en het publiceren inhoud direct van uw website
-
opstelling een lokale ontwikkelomgeving - creeer een lokaal milieu om uw storefront code en inhoud aan te passen
Leren en verkennen
-
voltooi het gebruiksgeval van begin tot eind - Leer meer over storefront opstelling en catalogusbeheer gebruikend Adobe Commerce Optimizer
-
verken storefront aanpassing - leer geavanceerde opstelling en configuratieopties
-
drop-ins van Commerce van het Gebruik om storefront ervaring aan te passen - voeg pre-gebouwde componenten toe om uw storefront ervaring te verbeteren