集合

一个集合将产品分组，以便购物者可以更快地找到它们——想想“跑鞋”或“夏季促销”。
DataEase 让您可以：

• 在一次上传中创建或重命名数百个集合。
• 批量添加或移除产品、规则、来源和条件。
• 快速更改排序顺序、图片和 SEO 文本。

Shopify 的新集合模型（Admin API 2026-07）。 Shopify 不再将集合分为“智能”和“自定义”。一个集合由一个或多个来源（sources）构成；每个来源都有包含/排除条件（conditions），和/或手动挑选的产品、变体或子集合。DataEase 通过 Sources & conditions 列支持此模型（详见下文）。对于经典列仍能描述的集合，包含经典规则和产品列的文件将继续正常工作。

Shopify 集合指南。

---

目录

1. 导出
2. 导入
3. 字段参考
4. 过滤器
5. Sources & conditions

---

2. 导出

1. 选择 CSV 或 Excel。
2. 选择 Collection 作为实体。
3. 选择您需要的字段——title、sortOrder、ruleColumn 等。要导出用新模型构建的集合，请启用 Sources & conditions 列组。
4. 可选：勾选 Matrixify-style headers and values，以 Matrixify 的表头和值（例如 Source: Type、Include、any condition）而不是 API 值（sourceType、INCLUDE、ANY）写入来源和条件列。
5. 运行任务并下载您的文件。

经典列无法描述的集合。 如果一个集合以经典规则列无法表达的方式使用新模型（例如有多个来源、排除条件、变体来源，或条件与手动挑选混用），其 ruleColumn/ruleRelation/ruleCondition/appliedDisjunctively 单元格会留空，导出日志会显示警告，提示您启用 Sources & conditions 列。如果只启用了经典列，此类集合仅导出其主行。

分步指南：导出指南

---

3. 导入

command 中支持的命令：CREATE、UPDATE、REPLACE、DELETE、IGNORE
行项目命令（规则或产品）：CREATE、MERGE、UPDATE、DELETE、IGNORE

• 对于手动集合，使用产品行（productId）。
• 对于智能集合，使用规则行（ruleColumn / ruleCondition…）。
• 对于使用新模型的集合（多个来源、排除条件、变体来源、子集合），使用 Sources & conditions 列。

模式是按每个集合决定的：如果某个集合的任意一行填写了 Sources & conditions 列（例如 sourceType 或 conditionField），整个集合就会以新模式导入，其 productId / productHandle / productPosition 行只设置排序位置——它们不会添加或移除产品。否则应用经典行为：产品行添加（CREATE、MERGE）、移动（UPDATE）或移除（DELETE）手动挑选的产品。

在智能集合上使用经典产品行。 对于一个已存在的智能集合，包含产品行（productId + itemCommand CREATE）的经典文件现在会将这些产品作为手动挑选项添加，因此该集合会变成条件与挑选产品混合的集合。此后，对该集合的经典规则导入（包括已保存的计划导入）会失败，报错 “The collection uses the new collections model (MIXED_SELECTIONS_AND_CONDITIONS)”。对于此类集合，请使用 Sources & conditions 列。

提示： 只有 sortOrder = MANUAL 的集合允许您设置 productPosition。

1. 下载示例文件：Collection-import-sample.xlsx
2. 填写必填字段：CREATE 时需要 title 和 handle；UPDATE/DELETE 时包括 id 或 handle。
3. 在 DataEase 中映射列，上传并开始导入。

完整步骤：导入指南

---

4. 字段参考

基本

• id — 集合 ID。用于 UPDATE、REPLACE 或 DELETE。

• command — 集合行的操作：CREATE、UPDATE、REPLACE、DELETE、IGNORE。

• title — 显示给购物者的名称。

• handle — URL 友好的字符串。必须唯一。

• descriptionHtml — 带有 HTML 的富文本描述。

• templateSuffix — 替代 Liquid 模板（不含 .liquid）。

• sortOrder — 默认产品排序：ALPHA_ASC、ALPHA_DESC、CREATED、CREATED_DESC、MANUAL、MOST_RELEVANT、PRICE_ASC、PRICE_DESC。自 Admin API 2026-07 起，Shopify 将按最畅销排序的集合返回为 MOST_RELEVANT，因此导出会写入 MOST_RELEVANT 而不是 BEST_SELLING。DataEase 不再支持 BEST_SELLING——请在文件中使用 MOST_RELEVANT。

• updatedAt — 最后修改日期（ISO 8601）。仅导出。

SEO

• seoTitle — 自定义页面标题标签。

• seoDescription — 自定义元描述。

图片

• imageUrl — 精选图片的 URL。

• imageAltText — 图片的替代文本。

• imageHeight — 图片高度（像素）。仅导出。

• imageWidth — 图片宽度（像素）。仅导出。

行项目（规则或产品）

• itemCommand — 此行的 CREATE、MERGE、UPDATE、DELETE 或 IGNORE。

智能集合规则字段

只有当集合仍能被描述为一组规则时，这些经典列才会在导出时被填写；否则它们将留空（参见导出）。

• ruleColumn — 规则的产品属性（例如，TITLE、TAG、VENDOR）。

• ruleCondition — 规则比较的值，如 Shoes。

• ruleConditionObjectId — 某些规则类型的额外信息（例如，类别 ID）。

• ruleRelation — 操作符：EQUALS、CONTAINS、NOT_EQUALS 等。

• appliedDisjunctively — true = 匹配任意规则；false = 匹配所有规则。

手动集合产品字段

• productId — 要包含的产品 ID。

• productPosition — 位置编号（仅在 sortOrder = MANUAL 时有效）。

• productTitle — 产品标题。仅导出。

• productHandle — 产品 handle。仅导出。

发布

• publicationScope — 集合发布的销售渠道。

Metafields

• metafields — 额外的应用字段。参见 Metafields 指南。

---

5. 过滤器

• CollectionType — Smart（有条件） 或 Custom（仅手动）。Shopify 的新模型没有集合类型这个概念，因此 DataEase 会根据集合的来源自行推断：smart = 至少有一个带包含条件的来源；custom = 其他所有情况（仅手动挑选的产品、子集合，或没有来源）。由于此过滤器是在 Shopify 返回集合之后应用的，导出表单中的集合数量可能显示为 ≤ N（最多 N 个）。

• Handle — 导出 handle 包含您输入文本的集合。

• Id — 按 id 导出单个集合。

• ProductId — 导出包含特定 productId 的集合。

• ProductPublicationStatus — 按集合内产品发布状态过滤。

• PublishableStatus — 选择已准备、已安排或未发布的集合。

• PublishedAt — 集合变为可见的日期范围。

• PublishedStatus — true 表示已发布，false 表示隐藏。

• Title — 导出 title 包含您文本的集合。

• UpdatedAt — 按最后更新日期范围过滤。

---

Sources & conditions

启用 Sources & conditions 列组，即可按 Shopify 的新集合模型导出和导入集合。一行 = 一个来源的一个条件或一个手动挑选的项目；该来源的来源列会在其每一行上重复。集合的基本列（handle、title 等）照常重复。

值可以用 API 格式（INCLUDE、ALL、TAGGED_WITH、COMPARE_AT_PRICE）或 Matrixify 格式（Include、all conditions、Includes、Compare at price）填写，不区分大小写。从 Matrixify 的 Collections 表导出的文件会通过其表头（Source: ID、Condition: Field 等）被识别。

• sourceId — 来源的 ID。使用导出的 ID 来更改现有来源，或使用您自己的标签（例如 s1）来为新来源的各行分组。

• sourceCommand — MERGE（默认）将行添加到来源；REPLACE 清空来源并用文件内容重新填充；DELETE 删除该来源。

• sourceType — PRODUCTS、VARIANTS、COLLECTIONS（子集合），或用于其他应用共享的来源的 APP <app id> | PRODUCTS / APP <app id> | VARIANTS（导入时只读）。UNKNOWN 仅用于导出。

• sourceTitle — 来源的标题。如果在创建来源时为空，DataEase 会根据集合标题生成一个。

• sourceDescription — 来源的描述。

• inclusionType — INCLUDE（默认）或 EXCLUDE。

• inclusionMatch — ALL 或 ANY：产品需要匹配该来源的全部还是任意一个包含（或排除）条件。新建的来源默认是 ALL。

• conditionCommand — MERGE（默认）在条件尚不存在时添加它；DELETE 移除该条件。要更改某个条件的值，请删除旧条件并添加新条件，或使用 sourceCommand = REPLACE。

• conditionField — TAG、TITLE、TYPE、VENDOR、STATUS、CATEGORY、CATEGORY_WITH_SUBCATEGORIES、PRICE、COMPARE_AT_PRICE、INVENTORY_STOCK、WEIGHT、VARIANT_TITLE、COLLECTION（仅排除）、MANUAL_SELECTION、METAFIELD: namespace.key、VARIANT_METAFIELD: namespace.key。UNKNOWN 仅用于导出（表示 DataEase 无法写入的条件；此类行在导入时会被跳过并显示警告）。

• conditionRelation — 运算符，例如 TAGGED_WITH、EQUALS、CONTAINS、DOES_NOT_CONTAIN、GREATER_THAN、IS_SET、INCLUDES。对于 MANUAL_SELECTION 和 COLLECTION 请留空。

• conditionValue — 值，以逗号分隔（\, 表示字面逗号）。价格可带可选货币（12.50 EUR，默认 = 商店货币）；重量可带可选单位（1.5 kg，默认 = 商店单位）。对于 MANUAL_SELECTION，每行填写一个产品 handle 或 ID，变体用 product-handle | Variant Title，COLLECTIONS 来源中则填写集合 handle。导出会写入 handle，以便文件可以在不同商店间迁移。

• conditionMatch — 当条件有多个值时为 ANY（默认）或 ALL；导入时也接受 OR / AND。

在新模式下，productId / productHandle / productPosition 行只设置排序位置（用于 sortOrder = MANUAL）。新模型的 Shopify 限制会在导入调用 Shopify 之前进行检查：每个集合最多 10 个来源，每个来源最多 60 个条件（每个值都计入），最多 5 个排除的集合，10 个子集合，以及 1,000 个手动排除项。

示例——一个来源中的标签条件加一次手动挑选和一次手动排除：

handle,title,sourceId,sourceType,sourceTitle,inclusionType,inclusionMatch,conditionField,conditionRelation,conditionValue,conditionMatch
vegan,Vegan picks,s1,PRODUCTS,Vegan tag,INCLUDE,ANY,TAG,TAGGED_WITH,"vegan,plant-based",ANY
vegan,Vegan picks,s1,PRODUCTS,Vegan tag,INCLUDE,,MANUAL_SELECTION,,oat-milk,
vegan,Vegan picks,s1,PRODUCTS,Vegan tag,EXCLUDE,,MANUAL_SELECTION,,leather-belt,

重新导入同一个文件不会创建重复的来源或条件。

---

需要帮助吗？我们的支持团队会在 24 小时内回复。

其他字段

DataEase 支持此实体的更多列：

• productsCount — 集合中的产品数量。