Curosa
Supplier Portal API Reference New

Products

产品变体

了解如何创建和管理产品变体,按颜色、尺寸、材料和其他属性对相关产品进行分组

概述

产品变体允许您将相关产品组合在一起,以便客户轻松选择其首选选项。例如,一件 T 恤可能有不同尺寸(小号、中号、大号)和颜色(红色、蓝色、绿色)的变体,或者一个马克杯可能有不同材料(陶瓷、玻璃)和设计(纯色、带图案)的变体。

变体有助于整理您的目录,让客户更容易找到和比较选项。每个变体组都有一个类型(如颜色、尺寸、材料),并包含多个具有该共同特征的产品。您可以为每个产品创建多个变体组,但每个组类型在每个产品中只能存在一次。

访问变体管理

要管理某个产品的变体:

  1. 导航至侧边栏导航中的产品 (Products)
  2. 找到并点击您想要管理变体的产品
  3. 点击编辑 (Edit) 按钮或标签页
  4. 滚动到变体 (Variants) 部分

或者,您也可以在产品的查看 (View) 页面上查看变体,变体会以只读格式显示,展示所有变体组及其关联产品。

了解变体组

变体被组织成。每个组代表一种变体类型(例如:颜色、尺寸、材料),并包含多个具有该特征的产品。每个产品可以有多个变体组,但每个组类型在每个产品中只能存在一次。

可用的变体组类型

您可以创建以下类型的变体组:

  • 颜色 (Colour):适用于具有不同颜色选项的产品(如:红色、蓝色、绿色)
  • 尺寸 (Size):适用于具有不同尺寸的产品(如:小号、中号、大号)
  • 材料 (Material):适用于由不同材料制成的产品(如:木头、金属、塑料)
  • 款式 (Style):适用于具有不同款式变化的产品
  • 图案 (Pattern):适用于具有不同图案或印花的产品
  • 设计 (Design):适用于具有不同设计选项的产品
  • 形状 (Shape):适用于具有不同形状的产品
  • 功能 (Feature):适用于具有不同功能集的产品

提示:选择最能描述产品差异的变体组类型。例如,颜色差异使用“颜色”,尺寸差异使用“尺寸”,材料差异使用“材料”。

创建变体组

要为产品创建新的变体组:

  1. 导航至产品的编辑页面,滚动到变体 (Variants) 部分
  2. 点击添加变体组 (Add Variant Group) 按钮(加号图标)
  3. 将出现一个弹窗,要求您选择组类型 (Group Type)
  4. 从下拉菜单中选择合适的类型(如:颜色、尺寸、材料)
  5. 点击创建 (Create) 以创建变体组

注意:您不能为同一个产品创建相同类型的重复变体组。如果您尝试创建已存在的组类型,系统将显示警告消息。此时,应将产品添加到现有组中。

创建组后,当前产品将自动作为该组的第一个变体添加。然后,您可以向该组添加更多产品。

向变体组添加产品

创建变体组后,您可以将其他产品添加到其中:

  1. 找到您想要添加产品的变体组
  2. 点击组名称旁边的添加产品变体 (Add Product Variant) 链接或按钮
  3. 将出现一个带有产品选择器的弹窗
  4. 通过 SKU、产品名称或平台 SKU 搜索产品
  5. 选择您想要添加的产品(您可以一次选择多个产品)
  6. 点击添加产品 (Add Products) 将其添加到变体组中

重要提示:

  • 您只能添加属于您供应商账号的产品
  • 已在组中的产品不会出现在选择列表中
  • 当前产品不能添加到其自身的变体组中(它已作为第一个变体包含在内)
  • 添加产品后,您可以编辑其变体值来描述它们的差异

提示:一次添加多个产品时,请确保它们都具有相同的变体特征。例如,创建颜色变体组时,只添加颜色不同的产品。

编辑变体值

组中的每个变体都可以有一个变体值,用于描述其独特之处。变体值可帮助客户了解选项之间的差异,并显示在产品页面上。例如:

  • 颜色组中:“红色”、“蓝色”、“绿色”
  • 尺寸组中:“小号”、“中号”、“大号”
  • 材料组中:“陶瓷”、“玻璃”、“木头”

要编辑变体值:

  1. 在变体组表格中找到该变体
  2. 点击变体值旁边的编辑图标(铅笔)
  3. 在文本框中输入新的变体值
  4. 点击保存 (Save) 应用更改

提示:使用清晰、具有描述性且易于客户理解的变体值。保持简短并确保在整个目录中具有一致性。

重新排序变体

您可以更改变体在组内显示的顺序。这对于优先显示最热门或默认选项非常有用:

  1. 在变体组表格中找到您想要移动的变体
  2. 使用上箭头 (↑) 按钮在列表中向上移动
  3. 使用下箭头 (↓) 按钮在列表中向下移动

注意:第一个变体(排序 0)不能向上移动,最后一个变体不能向下移动。

提示:将最热门或默认选项放在列表首位,因为客户通常会选择他们看到的第一个选项。

从组中移除变体

要从变体组中移除某个产品:

  1. 在变体组表格中找到您想要移除的变体
  2. 点击变体旁边的删除图标(垃圾桶)
  3. 如果有提示,请确认移除

重要:移除变体不会删除产品本身——它只是将其从变体组中移除。该产品仍将存在于您的目录中,并可添加到其他变体组或进行独立管理。

注意:如果您从组中移除了除一个变体以外的所有变体,该组仍将存在。您可以稍后添加更多产品,或者在不再需要时删除整个组。

编辑变体组类型

要更改现有变体组的类型:

  1. 找到您想要编辑的变体组
  2. 点击组类型名称旁边的编辑组 (Edit Group) 链接或图标
  3. 从下拉菜单中选择新类型
  4. 点击保存 (Save) 应用更改

警告:更改组类型时请谨慎,因为这可能会影响变体在网站上向客户显示的方式。只有在确定新类型能更好地代表产品间的差异时才进行更改。

查看变体

您可以通过两种方式查看产品的所有变体:

在编辑表单中

在编辑产品时,变体 (Variants) 部分显示:

  • 产品的所有变体组
  • 每个组显示为一个卡片,包含:
    • 组类型(如“颜色”、“尺寸”)
    • 列出该组中所有变体的表格
    • 每个变体的产品信息(SKU 和名称)
    • 变体值(可编辑)
    • 添加、编辑、重新排序或移除变体的操作

在查看页面中

在产品的查看 (View) 页面上,变体会以只读格式显示,包括:

  • 所有变体组
  • 每个组中的产品及其变体值
  • 此视图适用于快速查看变体关系而无需进行更改

从产品列表创建变体

您还可以通过批量操作直接从产品目录页面创建变体组:

  1. 导航至侧边栏导航中的产品 (Products)
  2. 使用每个产品旁边的复选框选择多个产品
  3. 顶部会出现一个工具栏,显示可用的批量操作
  4. 从批量操作菜单中点击分组成变体 (Group as Variants)
  5. 将出现一个弹窗,要求您选择变体组类型
  6. 选择合适的类型(如:颜色、尺寸、材料)
  7. 点击分组成变体 (Group as Variants) 创建组

这将创建一个所选类型的新变体组,并将所有选定的产品添加到其中。您选择的第一个产品将成为主产品,其他产品将作为变体添加。

提示:当您已经创建了多个相关产品时,这是创建变体组的快捷方式。分组后,您可以编辑单个产品来设置它们的变体值。

最佳实践

组织您的变体

  • 使用描述性的变体值:清晰的数值如“红色”或“大号”有助于客户一目了然地了解其选项
  • 逻辑分组:创建符合您的产品类型及客户购物习惯的变体组
  • 保持组的专注性:不要在同一个组中混入无关的变体。每个组应代表一种变体类型
  • 顺序很重要:在每个组中将最热门或默认的选项排在首位
  • 保持一致性:在类似产品中使用相同的变体值名称(例如:始终使用“小号”而不要混用“S”或“SM”)

选择变体组类型

  • 颜色 (Colour):用于具有不同颜色的产品(如:红、蓝、绿)
  • 尺寸 (Size):用于具有尺寸变化的产品(如:服装的小、中、大号,或容器的容量)
  • 材料 (Material):用于由不同材料制成的产品(如:木质、金属、塑料、陶瓷)
  • 款式 (Style):用于具有不同款式变化的产品
  • 图案 (Pattern):用于具有不同图案或印花的产品
  • 设计 (Design):用于具有不同设计选项的产品
  • 功能 (Feature):用于具有不同功能集的产品

管理大型变体集

  • 如果变体很多,请考虑创建多个变体组以更好地组织它们
  • 在整个目录中对变体值使用清晰、一致的命名规范
  • 定期检查并移除不再可用或已停产的变体
  • 保持变体值简短且具有描述性——避免使用客户可能无法理解的缩写
  • 考虑客户体验:变体过多可能会让人不知所措,因此请进行逻辑分组

常见场景

场景 1:具有尺寸和颜色变体的 T 恤

要创建同时具有尺寸和颜色选项的 T 恤:

  1. 从基础产品开始(例如:“经典 T 恤”)
  2. 创建一个尺寸 (Size) 变体组
  3. 添加产品:小号 T 恤、中号 T 恤、大号 T 恤
  4. 设置变体值:“小号”、“中号”、“大号”
  5. 创建一个颜色 (Colour) 变体组
  6. 添加产品:红色 T 恤、蓝色 T 恤、绿色 T 恤
  7. 设置变体值:“红色”、“蓝色”、“绿色”

客户在查看产品时将能够同时选择尺寸和颜色。

场景 2:具有材料和设计变体的马克杯

要创建具有不同材料和设计的马克杯:

  1. 从基础产品开始(例如:“咖啡马克杯”)
  2. 创建一个材料 (Material) 变体组
  3. 添加产品:陶瓷马克杯、玻璃马克杯
  4. 设置变体值:“陶瓷”、“玻璃”
  5. 创建一个设计 (Design) 变体组
  6. 添加产品:纯色马克杯、图案马克杯
  7. 设置变体值:“纯色”、“图案”

这允许客户选择他们喜欢的材料和设计。

场景 3:向现有产品线添加新颜色

向现有产品线添加新的颜色选项:

  1. 创建带有新颜色的新产品(例如:“蓝色挂件”)
  2. 导航至现有“颜色”变体组中的任何产品
  3. 点击编辑并滚动到变体 (Variants) 部分
  4. 找到“颜色”变体组
  5. 在该组中点击添加产品变体 (Add Product Variant)
  6. 搜索并选择新的“蓝色挂件”产品
  7. 将变体值设置为“蓝色”,以符合您的命名规范

新颜色现在将作为选项与现有颜色并列显示。

故障排除

无法创建变体组

问题:您看到警告提示该类型的组已存在。

解决方案:每个产品只能拥有每种类型的一个变体组。如果您需要添加更多产品,请将其添加到现有组中,而不是创建新组。要向现有组添加产品,请在该组中点击添加产品变体

产品未出现在选择列表中

问题:尝试向变体组添加产品时,该产品未出现。

可能的原因和解决方案

  • 产品已在组中:该产品已存在于此变体组中。检查组列表以确认是否已列出。
  • 供应商账号错误:该产品属于不同的供应商账号。您只能添加来自您自己账号的产品。
  • 与当前产品相同:该产品与您正在编辑的当前产品相同。当前产品会自动包含在内,无法再次添加。

变体值未保存

问题:编辑变体值后,更改未生效。

解决方案

  • 确保在编辑变体值后点击了保存 (Save)
  • 检查您是否有权编辑该产品
  • 如果问题仍然存在,请刷新页面并重试
  • 确保您没有处于只读视图模式

无法移除变体

问题:移除按钮不起作用,或者变体在移除后重新出现。

解决方案

  • 确保您具有编辑产品的权限
  • 确保在做出更改后点击了保存 (Save)
  • 尝试刷新页面并再次尝试移除
  • 如果您尝试移除组中的最后一个变体,您可能需要删除整个组

变体未在网站上显示

问题:变体已设置,但未在产品页面上显示。

可能的原因

  • 产品可能未添加到相关的站点 (Sites)
  • 产品状态可能为“停用 (Inactive)”
  • 变体值可能缺失(为每个变体添加描述性数值)
  • 产品可能正在等待审核

重要提示

  • 变体不会删除产品:从组中移除变体不会删除产品本身。产品仍保留在目录中,可添加到其他变体组或独立管理。
  • 排序顺序很重要:每个变体都有一个排序顺序,决定其显示位置。使用上/下箭头重新排列组内变体。
  • 推荐填写变体值:虽然变体值是可选的,但强烈建议填写,以提供更好的客户体验。它们有助于客户理解选项间的差异。
  • 每个产品每种类型只能有一个组:每个产品只能拥有每种类型的一个变体组。例如,同一个产品不能有两个“颜色”组。
  • 产品必须添加到站点:为了让变体出现在网站上,变体组中的所有产品必须至少添加到一个站点并处于活跃状态。