設定您的店面
本指南將引導您使用Adobe Edge Delivery Services為Adobe Commerce Optimizer執行個體設定店面。 您的店麵包含程式碼、範例內容,以及產品詳細資訊頁面和產品探索(搜尋和篩選)的支援。
預計完成時間: 30-45分鐘
先決條件
- GitHub帳戶,可以建立存放庫並設定為本機開發(github.com)
- Adobe Commerce Optimizer執行個體,包含範例資料及已設定的目錄檢視和原則
- 如需安裝程式指示,請參閱新增範例資料。
必要的執行個體資料
開始之前,請先從您的Adobe Commerce Optimizer執行個體收集下列資訊:
- 租使用者識別碼 (也稱為執行個體識別碼)
- 可從執行個體詳細資訊頁面取得
- 您執行個體的 GraphQL端點
- 可從執行個體詳細資訊頁面取得
- 全域目錄檢視的 目錄檢視識別碼
- 可從目錄詳細資料頁面取得
- 目錄檢視的 Source地區設定
- 範例資料的預設值為
en_US
- 範例資料的預設值為
設定步驟
建立您的店面專案
「場地建立者」工具會建立包含下列元件的完整店面專案:
- 網站:包含樣版內容的店面登陸頁面
- 代碼:儲存庫包含樣版來源檔案
- Content:具有網站內容檔案的檔案製作環境
- Commerce設定:執行個體特定設定的
config.json檔案
步驟1:產生專案
-
開啟網站建立者工具
{width="700" modal="regular"}
-
選取 建立新網站(程式碼與內容)。
-
完成站台設定:
- GitHub組織/使用者名稱:輸入您的GitHub使用者名稱或組織名稱
- 網站名稱:選擇店面的描述性名稱
- Commerce GraphQL端點(選用):輸入您Adobe Commerce Optimizer執行個體的GraphQL端點
-
按一下 建立網站,使用店面樣板程式碼建立GitHub存放庫。
建立存放庫時,網站建立者會更新並提示您安裝程式碼同步應用程式。
步驟2:安裝程式碼同步應用程式
-
按一下 Install AEM Code Sync App 以在新索引標籤中開啟程式碼同步處理安裝程式。
-
設定程式碼同步應用程式:
- 選取您的GitHub組織,然後按一下 Configure。
- 在程式碼同步處理介面中,按一下 Only select repositories。
- 按一下 Select repositories 功能表,然後選擇您建立的店面程式碼存放庫。
- 按一下 Save 註冊您的存放庫。
-
返回開啟網站建立者的瀏覽器視窗,然後按一下 建立網站。
「網站建立者」會將店面樣板內容複製到檔案製作環境。 此程式需要1-2分鐘。
步驟3:儲存專案連結
-
在網站詳細資訊區段中,檢閱店面專案的連結:
{width="700" modal="regular"}
使用這些連結來管理您的店面程式碼、內容和設定。
-
複製並儲存這些連結以供日後參考:按一下**Copy。
設定您的店面
更新您的店面設定以連線至您的Adobe Commerce Optimizer執行個體。
-
使用您先前儲存的連結開啟設定管理員:
https://da.live/sheet#/<username or org>/<repo name>/config.json -
找到組態中的
cs(目錄服務)區段。 -
將預留位置值取代為您的例項值。 請參閱必要條件。
code language-json "cs": { "AC-View-ID": "{catalogViewId}", "AC-Environment-ID": "{tenantId}", "AC-Source-Locale": "en_US" } -
儲存組態檔。
驗證您的設定
測試您的店面,以確保它已正確連線到您的Adobe Commerce Optimizer執行個體。
步驟1:檢視您的店面首頁
-
導覽至您的即時預覽URL:
https://main--{SITE}--{ORG}.aem.live將
{ORG}和{SITE}取代為您的GitHub組織和網站名稱。 -
成功標準:您應該會看到包含樣版內容的店面首頁。
{width="700" modal="regular"}
步驟2:測試產品詳細資料頁面
檢視預設產品詳細資料頁面,以驗證產品資料是否正確載入。
-
導覽至範例產品頁面:
https://main--{SITE}--{ORG}.aem.live/products/placeholder/{sku}使用範例資料中的任何SKU,例如:
https://main--{SITE}--{ORG}.aem.live/products/placeholder/aur-flu-tir-std-2017對於預設店面,您可以使用路由中的
placeholder值來檢視產品。 當您開始自訂店面時,您可以自訂店面程式碼,以根據目錄中定義的產品路由設定產品詳細資料頁面的路徑。note tip TIP 從您執行個體中的資料同步Adobe Commerce Optimizer頁面檢視可用的SKU。 -
成功標準:頁面應顯示:
- 產品名稱、說明和定價
- 產品影像
- 加入購物車功能
- 從您的Adobe Commerce Optimizer執行個體擷取的資料
{width="700" modal="regular"}
步驟3:測試預設搜尋功能
測試預設的產品功能,包括搜尋和篩選。
-
在店面首頁上,按一下標題中的放大鏡圖示。
-
輸入搜尋字串
tires並按 Enter。 -
成功標準:您應該會看到:
- 包含輪胎產品的搜尋結果頁面
- 側欄中的篩選選項
- 包含影像和定價的產品清單
{width="675" modal="regular"}
-
按一下任何輪胎產品以檢視其詳細資訊頁面。
{width="675" modal="regular"}
疑難排解
如果您在設定期間遇到問題,請使用網頁檢視窗主控台來檢查錯誤。 此外,請嘗試清除瀏覽器快取或使用其他瀏覽器。
使用下列指南檢查常見問題:
常見問題
- 確保您擁有GitHub組織的管理員存取權。
- 嘗試使用個人存放庫而非組織。
- 請檢查GitHub許可權,然後再試一次。
- 驗證您的網站URL格式:
https://main--{SITE}--{ORG}.aem.live - 檢查是否已正確安裝程式碼同步應用程式。
- 確儲存放庫是公用或正確設定的。
- 驗證
config.json中的設定值 - 在Adobe Commerce Optimizer執行個體中,檢查[資料同步]頁面以確認是否已載入範例產品。 如果沒有可用的產品,請重新載入範例資料,或使用資料擷取API新增產品。 請稍候幾分鐘,讓設定變更傳播出去。
- 嘗試使用檔案中設定的相同標頭,使用銷售服務產品查詢
config.json擷取產品詳細資料。 如果您可以擷取資料,則可能是目錄檢視設定發生問題或索引錯誤。
- 確認您可以使用檔案中設定的相同標頭,使用Merchandising Services productSearch查詢
config.json擷取產品搜尋結果。 如果您可以擷取資料,則可能是目錄檢視設定發生問題或索引錯誤。 - 確認
config.json檔案中的目錄檢視識別碼符合Adobe Commerce Optimizer中的目錄檢視識別碼。 - 在Adobe Commerce Optimizer中,驗證您在店面頁首設定中所使用的原則、地區設定和價格簿的設定。
- 確認已正確設定搜尋的屬性中繼資料設定。
驗證檢查清單
在繼續下一步之前,請確認下列事項,確定您的店面運作正常:
取得協助
如果問題仍然存在:
後續步驟
設定並驗證店面後,您可以:
-
安裝Sidekick — 直接從您的網站編輯、預覽和發佈內容的瀏覽器延伸模組
-
設定本機開發環境 — 建立本機環境,以自訂您的店面程式碼和內容
學習與探索
-
完成端對端使用案例 — 深入瞭解使用Adobe Commerce Optimizer的店面設定和目錄管理
-
探索店面自訂 — 瞭解進階設定和組態選項
-
使用Commerce下拉式功能表來自訂店面體驗 — 新增預先建立的元件以強化您的店面體驗