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

店面和目录管理员的端到端用例

此用例基于一个名为Carvelo Automobile的虚构汽车企业集团,该企业集团具有复杂的操作设置。 它演示了如何使用Adobe Commerce Optimizer管理支持多个品牌、经销店和价格手册的目录,同时提供自定义的店面体验。

先决条件

此用例专为想要了解如何使用Adobe Commerce Optimizer设置店面和管理目录的管理员和开发人员设计。 它假定您对Adobe Commerce Optimizer及其功能有基本的了解。

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

必需的设置

在开始本教程之前,请确保已满足以下先决条件:

  • Adobe Commerce Optimizer实例

    • 访问Cloud Manager中的测试实例
    • 有关安装说明,请参阅开始使用
  • 用户权限

    • 管理员访问Adobe Admin Console
    • 有关帐户设置,请参阅用户管理
    • 如果您没有访问权限,请联系您的Adobe客户代表。
  • 示例数据

    • 已将Carvelo汽车目录数据加载到实例中
    • 按照示例目录数据摄取存储库中的说明操作
    • 您可以使用包含的reset.js脚本在完成之后删除示例数据
  • 店面环境

    • 使用Node.js的本地开发环境
    • 克隆和配置的店面样板项目
    • 有关详细说明,请参阅店面设置

让我们开始吧

在此使用案例中,您使用的是以下内容:

  1. Adobe Commerce Optimizer UI — 设置目录视图和策略以管理Carvelo用例的复杂目录操作设置。

  2. Commerce Storefront — 使用加载到Adobe Commerce Optimizer实例和Commerce Storefront配置文件fstab.yamlconfig.json中的示例目录数据渲染店面。

NOTE
通过查看Adobe Commerce Storefront文档中的探索样板主题来了解店面配置文件。

关‌键要点

在本文末尾,您将了解:

  • 通过性能和可扩展的目录数据模型了解Adobe Commerce Optimizer的基础知识。
  • 了解目录数据模型如何与Adobe构建的与平台无关的店面组件集成。
  • 了解如何使用Adobe Commerce Optimizer目录视图和策略来创建自定义目录视图和数据访问过滤器,并将数据发送到由Edge Delivery提供支持的Adobe Commerce店面。

业务方案 — Carvelo Automobile

卡韦洛汽车是一个虚拟的汽车集团,拥有复杂的运营结构。

卡韦洛汽车

在这张图表中,您会看到Carvelo销售三种品牌的汽车产品。 每个品牌都是不同的子公司:

  • Aurora(电动汽车)
  • 螺栓(SUV)
  • Cruz(混合)

它通过三家经销商销售这些品牌:

  • Arkbridge
  • 金斯布拉夫
  • Celport

这些经销商属于两家不同的母公司:

  • 西海岸公司(Arkbridge)
  • 东海岸公司(Kingsbluff, Celport)

每家公司都有两个价格手册,用于按特定价格向不同购物者(基础客户、VIP)销售产品。

  • west_coast_incvip_west_coast_inc
  • east_coast_incvip_east_coast_inc

如您所见,这是一个非常复杂的业务用例。 使用Adobe Commerce Optimizer,商家可以使用单个基本目录支持复杂的业务结构,以联合数据,而无需目录重复,扩展价格手册(超过30k的价格手册),并将所有这些数据提供给Edge Delivery Services店面。

现在您已大致了解业务用例,下面是您在本教程中使用的目标:

recommendation-more-help

Carvelo希望通过不同的经销商(Arkbridge、Kingsbluff和Celport)跨其三个品牌(Aurora、Bolt和Cruz)销售部件。 Carvelo希望确保经销商只能按各自的许可协议获得正确的部件和价格。

最终,卡韦洛有两个主要目标:

  1. 维护一个“全球”网站,该网站具有涵盖所有三个品牌的所有SKU。
  2. 根据独特的SKU可见性和每个经销商的每个SKU价格,为经销商建立自己的店面提供途径。 同时使用单个基本目录,可消除目录重复。

1.访问Adobe Commerce Optimizer实例

导航到预配置了示例数据的Commerce Optimizer应用程序的URL。 您可以从Commerce Cloud项目的实例详细信息中找到Commerce Optimizer管理器中的URL,也可以从系统管理员处获取该URL。 (请参阅访问实例。)

启动Adobe Commerce Optimizer时,您会看到以下内容:

Adobe Commerce Optimizer UI

NOTE
请参阅概述文章以了解Adobe Commerce Optimizer UI的关键组件。

在左侧导航中,展开​ 存储设置 ​部分,然后单击​ Catalog views。 请注意,Arkbridge和Kingsbluff经销商已创建目录视图:

为示例数据配置的现有目录视图

NOTE
您可以暂时忽略​ 全局 ​目录视图。

单击信息图标可查看目录视图详细信息。

Arkbridge具有以下策略:

  • 品牌
  • 模型
  • West Coast公司品牌
  • Arkbridge部件类别

Kingsbluff具有以下策略:

  • 品牌
  • 模型
  • East Coast公司品牌
  • Kingsbluff部件类别

在下一部分中,您将为Celport代理创建目录视图和策略。

2.创建策略和目录视图

Carvelo的商务经理需要为属于​ East Coast Inc ​公司的经销商​ Celport ​设置一个新店面。 赛尔波特将为Bolt和Cruz品牌销售刹车和悬架产品。

Celport经销商

使用Adobe Commerce Optimizer,商务管理器将:

  1. 为Celport创建一个名为​ Celport部件类别 ​的新策略,以便仅销售制动和悬架部件。

  2. 为Celport店面创建新的目录视图。

    此目录视图使用您新创建的策略​ Celport部件类别 ​和现有的​ East Coast Inc品牌,以确保Celport在与East Coast Inc签署的协议中只能销售Bolt和Cruz品牌。Celport目录视图使用east_coast_inc价格手册来支持与品牌许可协议相符的产品定价计划。

  3. 更新商务店面配置以使用来自您创建的Celport目录视图的数据。

在本节末尾, Celport将启动并运行,准备销售Carvelo的产品。

创建策略

让我们创建一个名为​ Celport部件类别 ​的新策略来过滤Celport经销商销售的SKU,包括制动和悬架部件。

  1. 在左边栏中,展开​ 存储设置 ​部分,然后单击​ Policies

  2. 单击​ Create Policy

    此时将显示一个新页面,用于添加策略详细信息。

  3. 添加所需的详细信息:

    名称 = Celport部件类别

  4. 单击​ Add Filter

    将显示一个对话框以添加过滤器详细信息。

  5. 添加筛选器详细信息:

    • 属性 = part_category
    • 运算符 = IN
    • 值Source = 静态
    • = 制动器
    • = 暂停
    note important
    IMPORTANT
    必须单独输入每个属性值。 输入值后,按​ Enter ​将其添加到筛选器配置。 然后,输入下一个值。 所有值都必须与目录中的SKU属性名称完全匹配。

    要了解有关STATIC和TRIGGER值源之间差异的更多信息,请参阅值源类型

  6. 在​ Filter details ​对话框中,单击​ Save

  7. 要启用刚刚创建的筛选器,请单击操作点(…),然后选择​ 启用

  8. 单击​ Save

    note note
    NOTE
    如果​ Save ​按钮未处于活动状态(蓝色),则可能缺少策略名称。 单击​ 新策略 ​旁边的铅笔图标进行添加。
  9. 通过单击后退箭头返回到策略列表。

    您的新​ Celport部件类别 ​策略将显示在列表中。

验证此步骤是否正确完成:

  • 策略将显示在策略列表中
  • 策略状态显示为已启用(绿色指示器)
  • 过滤器详细信息显示“part_category IN(制动、暂停)”
  • 策略名称为“Celport部件类别”

创建目录视图

为​ Celport ​经销商创建新的目录视图,并链接以下策略: East Coast Inc品牌 ​和​ Celport部件类别

  1. 在左边栏中,展开​ 存储设置 ​部分,然后单击​ Catalog views

    请注意现有的目录视图: ArkbridgeKingsbluff ​和​ Global

    现有目录视图页面

  2. 单击​ Add catalog view

  3. 填写目录视图详细信息:

    • 名称 = Celport
    • 目录源 = en-US
    • 策略 (使用下拉列表) = East Coast Inc品牌Celport部件类别品牌型号
  4. 单击​ Add ​以创建目录视图。

    目录视图页面将更新以显示新的目录视图。

    已更新的目录视图列表

  5. 获取Celport目录视图ID。

    单击​ 目录视图 ​页上Celport目录视图的信息图标。

    Celport目录视图ID

    复制并保存目录视图ID。 当您更新店面配置以向新的Celport目录传送数据时,需要此ID。

    验证此步骤是否正确完成:

    • 目录视图名称为“Celport”
    • 目录视图显示4个关联的策略
    • 将显示目录视图ID,并且可以复制它
    • 目录源显示“en-US”

在创建Celport目录视图和相关策略之后,下一步是将店面配置为使用新的Celport目录。

3.更新店面

本教程的最后一段涉及更新您已经创建的店面,以将数据交付到新的Celport目录。 在此部分中,您将storefront配置文件中的目录视图ID替换为Celport的目录视图ID。

  1. 在本地开发环境中,打开您克隆GitHub存储库的文件夹以及店面样板配置文件。

  2. 在文件夹的根目录中,打开config.json文件。

    accordion
    config.json代码
    code language-json
    {
     "public": {
       "default": {
       "commerce-core-endpoint": "https://www.aemshop.net/graphql",
       "commerce-endpoint": "https://na1-sandbox.api.commerce.adobe.com/Fwus6kdpvYCmeEdcCX7PZg/graphql",
       "headers": {
          "cs": {
             "ac-view-id": "9ced53d7-35a6-40c5-830e-8288c00985ad",
             "ac-price-book-id": "west_coast_inc",
             "ac-source-locale": "en-US"
            }
          },
          "analytics": {
             "base-currency-code": "USD",
             "environment": "Production",
             "store-id": 1,
             "store-name": "ACO Demo",
             "store-url": "https://www.aemshop.net",
             "store-view-id": 1,
             "store-view-name": "Default Store View",
             "website-id": 1,
             "website-name": "Main Website"
           }
        }
       }
    }
    

    请注意,目录视图标题包含以下值:

    • commerce-endpoint"https://na1-sandbox.api.commerce.adobe.com/Fwus6kdpvYCmeEdcCX7PZg/graphql"
    • ac-view-id"9ced53d7-35a6-40c5-830e-8288c00985ad"
    • ac-price-book-id"west_coast_inc"
    • ac-source-locale"en-US"
  3. commerce-endpoint值中,将URL中的租户ID替换为Adobe Commerce Optimizer实例的URL。

    您可以在Commerce Optimizer UI的URL中找到租户ID。 例如,在以下URL中,租户ID为XDevkG9W6UbwgQmPn995r3

    code language-text
    https://experience.adobe.com/#/@commerceprojectbeacon/in:XDevkG9W6UbwgQmPn995r3/commerce-optimizer-studio/catalog
    
  4. ac-view-id值替换为您之前复制的Celport目录视图ID。

  5. ac-price-book-id值替换为"east_coast_inc"

    进行这些更改后,config.json文件应类似于以下内容,将ACO-tenant-idcelport-catalog-view-id占位符替换为您的值:

    code language-json
    {
      "public": {
         "default": {
         "commerce-core-endpoint": "https://www.aemshop.net/graphql",
         "commerce-endpoint": "https://na1-sandbox.api.commerce.adobe.com/{{ACO-tenant-id}}/graphql",
         "headers": {
             "cs": {
                 "ac-view-id": "{{celport-catalog-view-id}}",
                 "ac-price-book-id": "east_coast_inc",
                 "ac-source-locale": "en-US"
               }
             },
             "analytics": {
                 "base-currency-code": "USD",
                 "environment": "Production",
                 "store-id": 1,
                 "store-name": "ACO Demo",
                 "store-url": "https://www.aemshop.net",
                 "store-view-id": 1,
                 "store-view-name": "Default Store View",
                 "website-id": 1,
                 "website-name": "Main Website"
              }
          }
      }
    }
    
  6. 保存文件。

    保存更改后,更新目录配置以使用Carvelo目录视图,该视图已配置为仅销售制动和悬架部件。

4.预览店面

现在,您已更新店面配置以使用Celport目录视图,您可以预览店面以查看它如何呈现目录数据。

  1. 启动店面以查看您的店面配置创建的Celport特定目录体验。

    1. 从IDE的终端窗口中,启动本地店面预览。

      code language-shell
      npm start
      

      浏览器打开,显示位于http://localhost:3000的本地开发预览。

      如果命令失败或浏览器未打开,请查看Storefront设置主题中有关本地开发的说明

  2. 在浏览器中搜索brakes,然后按​ Enter

    店面会更新以显示显示制动部件的产品列表页面。

    Brakes产品列表页

    单击制动器部件图像以查看产品详细信息以及价格信息,并记录产品价格信息。

  3. 搜索tires,它是您的Adobe Commerce Optimizer实例上的用例数据中提供的另一个部件类别。

    标头不正确的店面配置

    请注意,不会返回任何结果。 这是因为Celport目录视图已配置为仅销售制动和悬架部件。

  4. 尝试更新店面配置文件(config.json)。

    1. 更改ac-view-idac-price-book值。

    例如,您可以将目录视图ID更改为Kingsbluff目录视图,将价格手册ID更改为east_coast_inc。 您可以通过查看​ Kingsbluff部件类别 ​策略来查看Kingsbluff可用的部件类别。

    1. 保存文件。

      保存文件时,本地店面预览会自动更新。

    2. 使用“搜索”功能在浏览器中预览更改以查找轮胎零件。

      请注意可用的不同部件类型,并注意分配给Kingsbluff目录视图的价格。

    这些实验展示了Adobe Commerce Optimizer的灵活性 — 您可以快速地在不同的目录视图和价格手册之间切换,为不同的受众创建自定义购物体验,而无需复制您的目录数据。

故障排除

如果您在本教程中遇到问题,请尝试以下解决方案:

策略创建问题

问题: ​保存按钮未处于活动状态

  • 解决方案: ​请确保已输入策略名称并已填写所有必填字段

问题: ​筛选器未按预期工作

  • 解决方案: ​验证属性名称是否与目录中的SKU属性完全匹配

目录查看问题

问题: ​目录视图未出现在列表中

  • 解决方案: ​验证是否已启用和正确配置所有关联的策略

店面配置问题

问题: ​店面未加载

  • 解决方案: ​检查您的租户ID和目录视图ID是否在config.json文件中正确输入

问题: ​未显示任何产品

  • 解决方案: ​验证价格手册ID是否与您的Adobe Commerce Optimizer实例中可用的价格手册ID匹配

问题: ​搜索未返回任何结果

  • 解决方案: ​确认目录视图策略允许搜索的产品类别

有关其他帮助,请参阅Adobe Commerce Optimizer文档或与Adobe支持部门联系。

摘要

在本教程中,您已成功:

  • 创建了新策略以筛选Celport代理的产品类别
  • 使用多个策略设置目录视图以控制产品可见性
  • 已配置店面以使用新目录视图
  • 通过测试产品可见性和定价验证了配置

后续步骤

要继续了解Adobe Commerce Optimizer,请执行以下操作:

e37aa9ac-438f-4a0d-bc16-4a10ee6cfc97