将 Metafields 添加到 Shopify 产品

一次为多个产品添加或更新 metafields 如果手动完成会非常耗时。DataEase 让这一过程变得简单：导出您的产品，在 Excel 或 CSV 中使用 namespace:key 对编辑 metafield 值，然后将它们导入回 Shopify——所有操作都经过类型安全验证。

🎯 目标

使用 CSV/Excel 和 DataEase 批量添加或更新产品 metafields。使用干净的 namespace:key 对和类型安全的值。

📋 分步说明

1. 导出产品

在 DataEase 中，进入 New Export → Products。至少包括：

• id
• handle

可以选择添加现有的 metafields 以查看当前数据。

这将为您提供一个包含所有产品的文件，准备进行编辑。

2. 选择如何编辑 Metafields

DataEase 支持两种方法来编辑 metafields：

动态列（推荐）： 每个键添加一列，命名为 metafield: {namespace} / {key}（例如，metafield: my_fields / material）。直接在单元格中输入值。

单个 “metafields” 列： 在一个单元格中提供多个条目，格式为 namespace:key = value; namespace2:key2 = value2（用分号分隔）。

3. 编辑文件

在 Excel 或 Google Sheets 中打开导出的文件。对于您想更改的每一行：

1. 设置 command = UPDATE
2. 使用适当的格式填写您的 metafield 值：
   • 字符串： 纯文本（例如，Organic Cotton）
   • 数字： 数字格式（例如，42, 19.95）
   • 布尔值： TRUE / FALSE
   • 日期/时间： ISO-8601 格式（例如，2025-11-05T10:00:00+01:00）
   • JSON： 有效的 JSON（例如，{"color":"red","size":"m"}）

完成后，将文件保存为 .xlsx 或 .csv。

4. 导入和验证

1. 在 DataEase 中，启动 New Import
2. 上传您编辑过的文件
3. 映射列（推荐使用 Product ID）
4. 运行 Validation

打开验证报告并修复在 Validation Status 中标记的任何类型/格式问题。

5. 运行导入

验证通过后，点击 Run Import 将您的 metafields 应用到 Shopify。

完成后，在 Shopify 管理后台检查产品以确认一切正确。

📝 重要提示

• 清除 metafield： 在 UPDATE 时将动态列的单元格留空以删除该键
• 类型： 验证器检查 Shopify metafield 类型（字符串、数字、布尔值、日期时间、json 等）。使用适当的格式通过验证
• 一致性： 保持命名空间和键的一致性（my_fields.material，而不是混合大小写/空格）
• 变体 metafields： 在变体级别导出时遵循相同的方法（参见 Variants 指南），使用 Variant ID 和相应的 metafield 列

💡 最小 CSV 示例

动态列（推荐）：

id,command,metafield: my_fields / material,metafield: my_fields / season
gid://shopify/Product/123,UPDATE,Organic Cotton,Summer 2025

单个 “metafields” 列：

id,command,metafields
gid://shopify/Product/456,UPDATE,"my_fields:material = Organic Cotton; my_fields:season = Summer 2025"

清除 metafield（动态列留空）：

id,command,metafield: my_fields / material
gid://shopify/Product/789,UPDATE,

🎉 就是这样！

您的 metafields 现在已批量添加或更新。
如果您遇到任何问题或有疑问，请随时联系我们的支持团队。