[仅限SaaS]{class="badge positive" title="仅适用于Adobe Commerce as a Cloud Service和 Adobe Commerce Optimizer 项目(Adobe管理的SaaS基础架构)。"}

设置您的店面

本指南将指导您使用Adobe Edge Delivery Services为Adobe Commerce Optimizer实例设置店面。 您的店面包括样板代码、示例内容,以及对产品详细信息页面和产品发现(搜索和筛选)的支持。

预计完成时间: 30-45分钟

先决条件

  • 可以创建存储库并配置为本地开发的​ GitHub帐户 (github.com)
  • Adobe Commerce Optimizer实例 ​包含示例数据以及配置的目录视图和策略

所需的实例数据

在开始之前,请从Adobe Commerce Optimizer实例收集以下信息:

NOTE
试用版访问客户可以在创建实例时收到的欢迎电子邮件中找到GraphQL端点。 试用实例预配置了示例数据、目录视图和策略。

设置步骤

  1. 创建店面项目 — 使用站点创建者工具创建一个新的店面项目,该项目包含样板代码、示例内容和配置文件。

  2. 自定义店面配置 — 更新存储库中的config.json文件以连接到Adobe Commerce Optimizer实例。

  3. 验证您的设置 (10分钟)

    • 预览您的店面网站
    • 测试产品详细信息页面和搜索功能

创建店面项目

站点创建者工具创建一个包含以下组件的完整店面项目:

  • 站点:包含样板内容的店面登陆页面
  • 代码:包含样板源文件的存储库
  • 内容:包含站点内容文件的文档创作环境
  • Commerce配置:实例特定配置的config.json文件

步骤1:生成项目

  1. 打开站点创建者工具

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

  2. 选择​ 创建新站点(代码和内容)

  3. 完成站点配置:

    • GitHub组织/用户名:输入您的GitHub用户名或组织名称
    • 网站名称:为您的店面选择一个描述性名称
    • Commerce GraphQL端点(可选):输入Adobe Commerce Optimizer实例的GraphQL端点
  4. 单击​ 创建站点 ​以使用店面样板代码创建GitHub存储库。

    创建存储库后,站点创建者会更新并提示您安装代码同步应用程序。

步骤2:安装代码同步应用程序

  1. 单击​ Install AEM Code Sync App ​以在新选项卡中打开代码同步安装程序。

  2. 配置代码同步应用程序:

    • 选择您的GitHub组织,然后单击​ Configure
    • 在代码同步界面中,单击​ Only select repositories
    • 单击​ Select repositories ​菜单,然后选择您创建的店面代码存储库。
    • 单击​ Save ​注册存储库。
  3. 返回打开站点创建器的浏览器窗口,然后单击​ 创建站点

    站点创建者将店面样板内容复制到文档创作环境。 此过程需要1-2分钟。

步骤3:保存项目链接

  1. 在网站详细信息部分,查看店面项目的链接:

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

    使用这些链接管理您的店面代码、内容和配置。

  2. 复制并保存这些链接以供将来引用:单击**Copy。

配置您的店面

更新storefront配置以连接到Adobe Commerce Optimizer实例。

  1. 使用您之前保存的链接打开配置管理器:

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

  2. 在配置中找到cs (目录服务)部分。

  3. 将占位符值替换为实例的值。 请参阅先决条件

    code language-json
    "cs": {
       "AC-View-ID": "{catalogViewId}",
       "AC-Environment-ID": "{tenantId}",
       "AC-Source-Locale": "en_US"
    }
    
  4. 保存配置文件。

NOTE
配置更改可能需要几分钟才能传播。 如果您没有立即看到数据,请等待2-3分钟再进行故障排除。

验证设置

测试您的店面以确保它已正确连接到您的Adobe Commerce Optimizer实例。

步骤1:查看店面主页

  1. 导航到实时预览URL:

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

    {ORG}{SITE}替换为您的GitHub组织和站点名称。

  2. 成功标准:您应该会看到包含样板内容的店面主页。

    ACO storefront site with boilerplate {width="700" modal="regular"}

第2步:测试产品详细信息页面

查看默认的产品详细信息页面,以验证产品数据是否正确加载。

  1. 导航到示例产品页面:
    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。
  2. 成功标准:页面应显示:

    • 产品名称、说明和定价
    • 产品图像
    • 添加到购物车功能
    • 从Adobe Commerce Optimizer实例检索的数据

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

步骤3:测试默认搜索功能

测试默认的产品功能,包括搜索和筛选。

  1. 在店面主页上,单击标题中的放大镜图标。

  2. 键入搜索字符串tires并按​ Enter

  3. 成功标准:您应会看到:

    • 包含轮胎产品的搜索结果页面
    • 侧栏中的筛选选项
    • 包含图像和定价的产品列表

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

  4. 单击任何轮胎产品以查看其详细信息页面。

    View product details page {width="675" modal="regular"}

故障排除

如果在设置过程中遇到问题,请使用网页检查器控制台检查错误。 此外,请尝试清除浏览器缓存或使用其他浏览器。

使用以下指南检查常见问题:

常见问题

问题
症状
解决方案
代码同步安装失败
无法完成代码同步设置
  • 确保您拥有GitHub组织的管理员访问权限。
  • 尝试使用个人存储库而不是组织。
  • 请检查GitHub权限并重试。
站点未加载
404或连接错误
  • 验证您的网站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中,验证您在店面页眉配置中使用的策略、区域设置和价格手册的配置。
  • 验证是否已正确设置用于搜索的属性元数据设置

验证核对清单

在继续后续步骤之前,请验证以下各项,确保您的店面运行正常:

清单 配置值与您的实例设置匹配

检查清单 店面主页加载无错误

清单 至少一个产品详细信息页面显示完整信息

清单 搜索功能返回相关结果

清单 产品图像正在正确加载

清单 配置值与您的实例设置匹配

获取帮助

如果问题仍然存在:

后续步骤

设置并验证店面后,您可以:

  1. 安装Sidekick — 用于直接从您的网站编辑、预览和发布内容的浏览器扩展

  2. 设置本地开发环境 — 创建本地环境以自定义店面代码和内容

学习和探索

recommendation-more-help
e37aa9ac-438f-4a0d-bc16-4a10ee6cfc97