元数据键如何工作
订单上的每个项目可以携带一个或多个元数据条目 — 一个键和一个值。您的平台在创建订单时将这些发送给 Zonos。默认情况下,Zonos 存储此元数据,但不会在订单细目中显示它。
当您在偏好设置页面添加一个键时,Zonos 会在每个订单项目上查找该键并将匹配的值显示为该项目下方的额外一行。
- 同一键的多个值用逗号连接 — 例如,
red, large。 - 没有该键的项目根本不会显示该行,因此订单详情保持整洁。
- 键在组织范围内配置。 您组织中的每个用户都会看到相同的元数据行。
何时使用此功能
常见用例:
- 刻字或个性化 — 显示
engraving-text键,以便仓库知道订单需要在发货前进行自定义工作。 - 礼物订单 — 显示
gift-message或gift-wrap键,以便打包员可以包含正确的插件。 - 订阅或忠诚度 — 显示
subscription-id或loyalty-tier键,以获得支持和履行背景。 - 自定义平台字段 — 您的平台传递的任何项目级字段,您的团队需要在订单中看到。
添加元数据键
- 进入 Dashboard -> Settings -> Orders -> Preferences。
- 在 Metadata keys 字段中,输入您的平台发送的确切键名称(例如,
engraving-text)。 - 点击 Add。
该键将立即应用于所有订单详情页面。打开任何订单细目以确认新行出现在每个携带该元数据的项目下方。

键名称区分大小写,必须与您的平台发送的内容完全匹配。如果您不确定确切的键,请检查最近订单的原始元数据或询问您的开发人员。
删除元数据键
- 进入 Dashboard -> Settings -> Orders -> Preferences。
- 在列表中找到要删除的键。
- 点击该行右侧的垃圾图标。
该行将停止在订单细目中出现,无论是新订单还是现有订单。
故障排除
该行在订单详情页面上不显示。
- 确认键名称完全匹配,包括大小写以及任何破折号或下划线(
engraving-text与Engraving_Text不同)。 - 确认订单项目实际上有该元数据。在您的平台开始发送该键之前创建的较早订单将没有它。
该行显示但为空。
- 该平台使用空值发送了该键。检查平台端的集成以确保值已填充。
一个键在某些项目上显示,但在其他项目上不显示。
- 这是预期的 — 元数据是每个项目的,而不是每个订单的。只有平台为其发送该键的项目才会显示该行。
订单偏好设置
在每个订单项目中显示平台元数据。当您的电子商务平台随每个订单发送额外信息时(例如刻字注记、礼物留言或订阅 ID),Zonos 会将其作为元数据接收。订单偏好设置页面允许您选择哪些元数据键应该显示在订单细目中的每个订单项目上,以便您的履行团队可以一目了然地看到需要的内容,而无需打开原始平台。