设置您的店面
本指南将指导您使用Adobe Edge Delivery Services为Adobe Commerce Optimizer实例设置店面。 您的店面包括样板代码、示例内容,以及对产品详细信息页面和产品发现(搜索和筛选)的支持。
预计完成时间: 30-45分钟
先决条件
- 可以创建存储库并配置为本地开发的 GitHub帐户 (github.com)
- Adobe Commerce Optimizer实例 包含示例数据以及配置的目录视图和策略
- 有关安装说明,请参阅添加示例数据。
所需的实例数据
在开始之前,请从Adobe Commerce Optimizer实例收集以下信息:
设置步骤
创建店面项目
站点创建者工具创建一个包含以下组件的完整店面项目:
- 站点:包含样板内容的店面登陆页面
- 代码:包含样板源文件的存储库
- 内容:包含站点内容文件的文档创作环境
- Commerce配置:实例特定配置的
config.json
文件
步骤1:生成项目
-
打开站点创建者工具
-
选择 创建新站点(代码和内容)。
-
完成站点配置:
- 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:保存项目链接
-
在网站详细信息部分,查看店面项目的链接:
使用这些链接管理您的店面代码、内容和配置。
-
复制并保存这些链接以供将来引用:单击**Copy。
配置您的店面
更新storefront配置以连接到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组织和站点名称。 -
成功标准:您应该会看到包含样板内容的店面主页。
第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实例检索的数据
步骤3:测试默认搜索功能
测试默认的产品功能,包括搜索和筛选。
-
在店面主页上,单击标题中的放大镜图标。
-
键入搜索字符串
tires
并按 Enter。 -
成功标准:您应会看到:
- 包含轮胎产品的搜索结果页面
- 侧栏中的筛选选项
- 包含图像和定价的产品列表
-
单击任何轮胎产品以查看其详细信息页面。
故障排除
如果在设置过程中遇到问题,请使用网页检查器控制台检查错误。 此外,请尝试清除浏览器缓存或使用其他浏览器。
使用以下指南检查常见问题:
常见问题
- 确保您拥有GitHub组织的管理员访问权限。
- 尝试使用个人存储库而不是组织。
- 请检查GitHub权限并重试。
- 验证您的网站URL格式:
https://main--{SITE}--{ORG}.aem.live
- 检查代码同步应用程序是否已正确安装。
- 确保存储库为公共或已正确配置。
- 验证
config.json
中的配置值 - 在Adobe Commerce Optimizer实例中,检查“数据同步”页面以验证是否已加载样例产品。 如果没有可用的产品,请使用数据摄取API重新加载示例数据或添加产品。 请等待几分钟,以便配置更改能够传播。
- 尝试使用在文件中配置的相同标头,通过Merchandising Service products查询
config.json
检索产品详细信息。 如果可以检索数据,则可能是目录视图配置存在问题或索引错误。
- 验证您是否可以使用文件中配置的相同标头,通过Merchandising Services productSearch查询
config.json
检索产品搜索结果。 如果可以检索数据,则可能是目录视图配置存在问题或索引错误。 - 确认
config.json
文件中的目录视图ID与Adobe Commerce Optimizer中的目录视图ID匹配。 - 在Adobe Commerce Optimizer中,验证您在店面页眉配置中使用的策略、区域设置和价格手册的配置。
- 验证是否已正确设置用于搜索的属性元数据设置。
验证核对清单
在继续后续步骤之前,请验证以下各项,确保您的店面运行正常:
获取帮助
如果问题仍然存在:
后续步骤
设置并验证店面后,您可以:
-
安装Sidekick — 用于直接从您的网站编辑、预览和发布内容的浏览器扩展
-
设置本地开发环境 — 创建本地环境以自定义店面代码和内容
学习和探索
-
完成端到端用例 — 使用Adobe Commerce Optimizer了解有关店面设置和目录管理的更多信息
-
探索店面自定义 — 了解高级设置和配置选项
-
使用Commerce下拉列表自定义店面体验 — 添加预建组件以增强您的店面体验