README

目录

• 客户商品模块
  • 目录
  • 关于
    • 定制您的产品供应
    • 提升客户满意度
    • 简化购物体验
  • 安装
  • Composer 要求
  • 配置
  • 不受支持的特性
  • API 文档
    • [GET] 获取产品
      • 返回参数
    • [POST] 添加产品
      • 参数
      • 返回参数
    • [POST] 删除产品
      • 参数
      • 返回参数
    • [POST] 删除所有产品
      • 参数
      • 返回参数
    • [GET] 检查产品
      • 参数
      • 返回参数

关于

客户商品模块通过引入先进的产品可见性管理系统，使您的 Magento 2 商店得以提升。使用此模块，您可以根据单个客户偏好精细调整产品的可见性，从而提供前所未有的个性化购物体验。

定制您的产品供应

想象一下，您有能力根据每个客户的独特需求和偏好定制产品目录。客户商品模块使这一现实成为可能。通过无缝集成到 Magento 的产品显示逻辑中，它允许您自定义特定客户可见的产品，确保他们只能看到对他们最重要的产品。

提升客户满意度

客户满意度是每个成功的在线商店的核心。使用此模块，您可以通过展示相关的产品推荐并确保客户只能接触到符合他们兴趣的商品来提高客户满意度。

简化购物体验

告别杂乱的产品列表，迎接简化的购物体验。通过过滤产品可见性，您可以清除您的店面，让客户更容易发现他们真正感兴趣的产品，从而提高转换率和增加销售额。

总之，客户商品模块是您在 Magento 2 中开启以客户为中心的产品可见性管理系统全潜能的关键。定制您的产品供应，提升客户满意度，简化购物体验，以推动您的在线商店成功。

安装

您可以使用 Composer 将客户商品模块轻松安装到您的 Magento 2 项目中。只需运行以下命令

composer require conneqt/module-customer-assortment

Composer 要求

PHP：需要 PHP 版本 8.1 或更高。 \ Magento 框架：与 Magento 框架兼容。 \ cweagans/composer-patches：使用 Composer Patches 插件。 \ magento/module-catalog-search：需要 Magento 目录搜索模块版本 102.0 或更高。

配置

导航到商店配置 \ 前往您的 Magento 管理面板并访问配置设置： 路径：商店 -> 配置 -> Conneqt -> 客户商品

客户 ID 属性 \ 选择您希望用作模块中 customerId 的客户属性。此属性可以随时更改。

自动调整客户特定属性 \ 您可以在下拉菜单中选择“是”或“否”。当设置为“是”时，模块将自动调整产品上的客户特定布尔属性。此属性确定产品是否仅对拥有该产品的客户可见。

不受支持的特性

虽然客户商品模块增强了您的 Magento 2 商店的商品可见性管理功能，但请注意，某些功能和功能目前不受支持或有限制。请注意以下几点

产品块： 在您商店前端显示产品的任何块都不会根据客户组合自动过滤。显示在各种小工具、特色区域或自定义块中的产品不会根据客户特定偏好进行调整。

相关产品： 此模块不会对相关产品推荐应用过滤器。在产品页面或购物车中显示的相关产品不会考虑个别客户的偏好。

可配置产品选项： 单个产品选项（如尺寸、颜色或定制）不会根据客户组合进行过滤。客户将看到相同的产品选项，无论他们的偏好如何。

组合产品子产品： 组合产品内的子产品不会被过滤。客户将看到与组合产品相关联的所有子产品，即使其中一些不属于他们的组合。

分层导航选项： 虽然该模块增强了产品可见性，但它可能无法准确反映分层导航选项中的产品总数。由于分层导航的传统实现方式，客户可能会看到比他们组合中可用的结果更多的过滤器。

与其他模块的兼容性： 此模块未经充分测试，无法与其他第三方模块兼容，这些模块在干净的Magento安装之外。在集成其他扩展时，请确保彻底测试和兼容性检查。

在配置您的Magento 2商店时，请牢记这些限制。虽然客户组合模块提供了强大的以客户为中心的可见性管理功能，但您的商店前端和相关的产品推荐的一些方面可能无法完全符合个别客户的偏好。

API 文档

我们提供了一套全面的API来管理客户组合。以下是可用端点的概述

[GET] 获取产品

描述： 获取客户组合中所有产品的详细信息。 URL： /V1/product-assortment/getProducts/:customerId

返回参数

products（产品引用数组）： product_sku（String）：产品的SKU（库存保持单位）。 external_id（String）：与产品相关联的外部ID。 customer_id（String）：产品所属的客户ID。 entity_id（Int）：表示产品与客户组合之间关联的内部标识符。 updated_at（时间戳）：行最后一次更新的时间戳。 created_at（时间戳）：行创建的时间戳。

[POST] 添加产品

描述： 将产品添加到客户的组合中。当“cleanup”参数设置为true时，任何未包含在提供的数组中的客户组合中的产品将被删除。 URL： /V1/product-assortment/addProducts

参数

customerId（String） cleanup（布尔值） productReferences（混合） - 格式：{ sku : string, external : string }

返回参数

success（True/False） invalidReferences（包含不存在于产品数据库中的SKU的产品引用数组） createdReferences（添加到客户组合中的产品引用数组） updatedReferences（数据库中更新的产品引用数组）

[POST] 删除产品

描述： 从客户组合中删除指定SKU的产品。 URL： /V1/product-assortment/removeProducts

参数

customerId（String） productReferences（数组）

返回参数

removedSkus（从客户组合中删除的SKU数组） success（True/False）

[POST] 删除所有产品

描述： 根据提供的客户ID从客户组合中删除所有产品。 URL： /V1/product-assortment/removeAllProducts

参数

customerId（String）

返回参数

removedSkus（从客户组合中删除的SKU数组） success（True/False）

[GET] 检查产品

描述： 检查具有指定SKU的产品是否存在于客户组合中。 URL： /V1/product-assortment/hasProduct

参数

customerId（String） productSku（String）

返回参数

hasProduct（True/False） success（True/False）

有关API请求和响应的更详细信息和示例，您可以参考我们由Postman生成的API文档。

请注意：在Magento中，用作customerId的客户属性可以自定义，因此它可能并不总是对应于Magento的默认客户ID。