[Alleen SaaS]{class="badge positive" title="Is op Adobe Commerce as a Cloud Service en Adobe Commerce Optimizer slechts projecten (Adobe-Beheerde infrastructuur SaaS) van toepassing."}

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

Vereiste instance-gegevens

Verzamel voordat u begint de volgende informatie van uw Adobe Commerce Optimizer -instantie:

NOTE
Klanten met testtoegang kunnen het GraphQL-eindpunt vinden in de welkome e-mail die is ontvangen toen uw exemplaar werd gemaakt. Proefversies worden vooraf geconfigureerd met voorbeeldgegevens, catalogusweergaven en beleidsregels.

Stappen instellen

  1. 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.

  2. pas de storefrontconfiguratie aan - werk het config.json dossier in uw bewaarplaats bij om met uw Adobe Commerce Optimizer instantie te verbinden.

  3. 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.json dossier voor instantie-specifieke configuratie

Stap 1: Genereer uw project

  1. Open het ​ hulpmiddel van de Maker van de Plaats ​

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

  2. Selecteer creeer Nieuwe Plaats (Code & Inhoud).

  3. 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
  4. 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

  1. Klik op Install AEM Code Sync App om het installatieprogramma voor codesynchronisatie te openen op een nieuw tabblad.

  2. 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.
  3. 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

  1. In de sectie van de Details van de Plaats, herzie de verbindingen voor uw archiefproject:

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

    Gebruik deze koppelingen om uw winkelcode, inhoud en configuratie te beheren.

  2. 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.

  1. Open configuratiebeheer met behulp van de koppeling die u eerder hebt opgeslagen:

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

  2. Zoek de sectie cs (Catalog Service) in de configuratie.

  3. 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"
    }
    
  4. Sla het configuratiebestand op.

NOTE
De configuratieveranderingen kunnen een paar notulen nemen om zich te verspreiden. Als u gegevens niet onmiddellijk ziet, wacht 2-3 minuten vóór het oplossen van problemen.

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

  1. Ga naar de URL van uw live voorvertoning:

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

    Vervang {ORG} en {SITE} door uw GitHub-organisatie en sitenaam.

  2. criteria van het Succes: U zou de storefront homepage met boilerplate inhoud moeten zien.

    ACO storefront site with boilerplate {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.

  1. 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-2017

    Voor 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.
  2. 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

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

Stap 3: Test de standaardzoekfunctionaliteit

Test de standaardproductfuncties, inclusief zoeken en filteren.

  1. Klik op de startpagina van de winkel op het vergrootglaspictogram in de koptekst.

  2. Typ het onderzoekskoord tires en druk binnengaan.

  3. criteria van het Succes: U zou moeten zien:

    • Pagina met zoekresultaten met bandenproducten
    • Filteropties in de zijbalk
    • Productaanbiedingen met afbeeldingen en prijzen

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

  4. Klik op een bandenproduct om de detailpagina weer te geven.

    View product details page {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

Probleem
Symptomen
Oplossing
de installatie van de Synchronisatie van de Code ontbreekt
Kan de installatie van Codesynchronisatie niet voltooien
  • 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.
Plaats laadt niet
404 of verbindingsfouten
  • 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.
Geen getoonde productgegevens
Op productpagina's worden tijdelijke aanduidingen of fouten weergegeven
  • 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.json dossier worden gevormd. Als u de gegevens kunt ophalen, is dit waarschijnlijk een probleem met de configuratie van de catalogusweergave of een indexfout.
het Onderzoek keert geen resultaten terug
Lege pagina met zoekresultaten
  • 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.json dossier 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:

Checklist de waarden van de Configuratie passen uw instantiemontages
aan
Checklist de homepage van de Storefront laadt zonder fouten

Checklist minstens één pagina van het productdetail toont volledige informatie

Checklist de functionaliteit van het Onderzoek keert relevante resultaten
terug
Checklist de beelden van het Product laden correct

Checklist de waarden van de Configuratie passen uw instantiemontages
aan

Hulp vragen

Als er problemen blijven optreden:

Volgende stappen

Nadat u uw winkel hebt ingesteld en geverifieerd, kunt u:

  1. installeer Sidekick ​ - Browser uitbreiding voor het uitgeven, het previewing, en het publiceren inhoud direct van uw website

  2. opstelling een lokale ontwikkelomgeving ​ - creeer een lokaal milieu om uw storefront code en inhoud aan te passen

Leren en verkennen

recommendation-more-help
a28d369d-4524-4c6c-997b-b5503cef9203