Metafield 设置 — 销售代表、规格、文档及更多
Vertex 读取 vertex 命名空间中的一小组可选 metafield,以驱动技术目录所需的附加内容 — 销售代表卡片、技术规格表、文档与下载块、MPN 和 GTIN、ships-from 行,以及价格历史披露。
您只需设置实际想要的那些。每个 metafield 都是可选的 — 如果为空,对应的店铺前端组件就根本不会渲染。没有破损的布局、没有占位符、没有错误。
其中一些块在 Customize ▸ Theme settings ▸ B2B 中也有开/关开关 — Show price history on PDP、Show 'Ships from' on PDP(以及其 Default 'Ships from' location),还有 Show 'Documents & downloads' on PDP。下面的 metafield 提供内容;这些开关决定该块是否允许显示。
Metafield 在 Vertex 中的工作方式
本指南中的所有值都存储为 Shopify metafield — 附加到产品或公司的结构化自定义字段。您在 Settings ▸ Custom data 中将每个字段定义一次,然后像其他字段一样按产品(或按公司)填写。
您将在两个地方进行操作:
- 将字段定义一次 — Settings ▸ Custom data ▸ Products(或 Companies)▸ Add definition。这会创建字段,使其显示在每个产品/公司上。
- 按项目填写 — 打开一个产品(或公司)▸ 滚动到 Metafields 区域 ▸ 输入值。
请对下面的每个字段使用列出的确切命名空间和键(例如 vertex.mpn)。命名空间必须是 vertex,Vertex 才能读取它。
一旦定义存在,您就可以从 Products ▸ 选择行 ▸ Edit products ▸ 添加 metafield 列,或通过 CSV 导入 / Shopify Admin API 批量填写值。每个定义只需创建一次。
销售代表联系卡片
销售代表卡片在每个 B2B 触点上展示一位指定的客户经理 — 桌面 header 中的胶囊、移动抽屉底部的完整卡片,以及客户账户面板上的卡片。
代表是按公司设置的(不是按产品,也不是作为主题设置),因此每个公司都可以有自己的代表。
在哪里设置: Customers ▸ Companies ▸ [公司] ▸ Metafields — 使用以下公司 metafield:
| Metafield(namespace.key) | 类型 | 示例 | 备注 |
|---|---|---|---|
vertex.rep_name | Single-line text | Sarah Chen | 触发代表卡片渲染。 |
vertex.rep_email | Single-line text | [email protected] | 渲染为点击发送邮件的按钮。 |
vertex.rep_phone | Single-line text | +1-555-0142 | 渲染为点击拨打电话的按钮。优先 E.164 格式。 |
仅当 vertex.rep_name 已填写,且买家已登录该公司,且 Storefront 模式不是 B2C 专用时,卡片才会渲染。头像显示代表的名字首字母 — 没有代表照片或代表职位字段。
由于代表存在于公司记录上,所以隶属于不同公司的买家会自动看到不同的代表。每个公司设置一次即可。
Ships-from(发货)地点
向买家显示产品从哪个仓库或履约中心发货 — 对拥有多个区域仓库的分销商很有用。
这是主 题设置(默认值 + 开/关开关)和可选的每个产品的 metafield(覆盖值)的组合:
- 主题级默认值 + 开关 — Customize ▸ Theme settings ▸ B2B:打开 Show 'Ships from' on PDP,并设置 Default 'Ships from' location(例如 Cleveland, OH)。默认值会渲染在每个产品标题下方。
- 每个产品的覆盖值 — 对从不同仓库发货的任何产品,设置
vertex.ships_from产品 metafield(single-line text,例如 Atlanta, GA)。
| 位置 | 值 | 示例 |
|---|---|---|
| 主题设置: Default 'Ships from' location | 店铺前端全局默认值 | Cleveland, OH |
产品 metafield: vertex.ships_from | 每个产品的覆盖值 | Atlanta, GA |
将默认值留空(并将 metafield 留空)以在没有特定地点的产品上隐藏该行。
制造商零件号(MPN)
MPN — OEM 零件号 — 是工业买家的第一搜索向量。采购团队在搜索之前几乎总是手头有零件号,因此填充 MPN 会显著提升您的搜索命中率。
在哪里设置: vertex.mpn 产品 metafield(single-line text)。
| Metafield | 示例 |
|---|---|
vertex.mpn | DWE357K |
MPN 渲染在产品页 header 中,并由 Vertex 的预测搜索匹配 — 因此买家可以粘贴竞争对手的 MPN 并仍能找到您的产品。
如果您不填写其他任何内容,也要填写 MPN。采购团队首先按零件号搜索;其他一切都是次要的。
用于 Google Merchant Center 的 GTIN
GTIN(Global Trade Item Number,全球贸易项目编号)使您的产品有资格获得更丰富的 Google 购物预览,并提升 Merchant Center 的匹配率。
在哪里设置: vertex.gtin 产品 metafield(single-line text)。Vertex 已经将款式 barcode 作为结构化数据中的 GTIN 输出,因此仅当您想发布一个不同的对外公开 GTIN 时才设置此项。
| Metafield | 示例 |
|---|---|
vertex.gtin | 0885911234567 |
产品规格表
向买家显示产品页上简洁的两列技术规格表 — 钻夹头容量、电压、重量、尺寸 — 凡是买家在产品间比较的内容皆可。
在哪里设置: vertex.tech_specs 产品 metafield。这是一个**「spec」条目的列表**,其中每个条目都有一个 label、一个 value 和一个可选的 unit。
| 条目字段 | 示例 |
|---|---|
label | Chuck capacity |
value | 13 |
unit (可选) | mm |
示例 — 一把工业钻头的规格:
| Label | Value | Unit |
|---|---|---|
| Chuck capacity | 13 | mm |
| Maximum torque | 65 | Nm |
| No-load speed | 0–2,100 | rpm |
| Battery voltage | 18 | V |
| Weight (with battery) | 1.8 | kg |
产品页将这些渲染为简洁的两列 Technical specifications 表。当 metafield 为空时,该块会自动隐藏。
本指南的早期草稿曾引用 tech_spec_row metaobject。Vertex 对规格不使用 metaobject — 它读取上面描述的单个 vertex.tech_specs 列表 metafield。
文档与下载
将 PDF 附加到产品 — 数据表、MSDS、手册、技术单、安装指南、保修卡 — Vertex 会将它们渲染为产品页上整齐的文档块。
在哪里设置: 每种文档类型一个文件引用产品 metafield。通过 Theme settings ▸ B2B ▸ Show 'Documents & downloads' on PDP 打开该块。
| Metafield | 按钮标签 | 典型用途 |
|---|---|---|
vertex.datasheet | Datasheet | 标准产品数据表。 |
vertex.msds | MSDS | 材料安全数据表 — 许多化学品、润滑剂、溶剂、气雾剂为必需。 |
vertex.brochure | Brochure | 销售手册。 |
vertex.tech_sheet | Tech sheet | 独立技术单。 |
vertex.install_guide | Install guide | 安装或组装指南。 |
vertex.warranty | Warranty | 保修卡。 |
如果产品的这些 metafield 一个都没有填写,整个文档块都会被抑制 — 没有空标题、没有占位符。您一上传 PDF,该块就会出现并显示那一个按钮。
您还可以使用 vertex.certifications 列表 metafield 列出认证(ISO、UL、CE 等);它们会作为徽章渲染在产品页上。
价格历史披露
如果您在有价格披露法规的市场经营(例如欧盟 Omnibus 指令),或者只是想向注重透明度的买家展示价格如何随时间变化,Vertex 可以在产品页上渲染一个可折叠的价格历史块。
在哪里设置: vertex.price_history 产品 metafield — 一个列表,其中每个条目都有一个日期和一个价格。通过 Theme settings ▸ B2B ▸ Show price history on PDP 打开该块。
| Date | Price |
|---|---|
| 2025-01-15 | 14.50 |
| 2025-03-22 | 13.80 |
| 2025-09-04 | 12.32 |
将 metafield 留空以隐藏该块。
NET 条款徽章措辞
出现在 B2B 问候栏(以及账户和订单屏幕)中的 NET 条款徽章,由公司 metafield 驱动,而不是由 Shopify 的原生付款条款名称驱动,也不是由主题设置驱动。
在哪里设置: vertex.payment_terms 公司 metafield(single-line text)。
| Metafield | 示例 |
|---|---|
vertex.payment_terms | NET 30 — 或像 NET 30 — Pay by invoice 这样的自定义措辞 |
留空则该公司不会渲染任何 NET 条款徽章。
设置真正的延期付款结账条款(以便公司实际可以按发票付款)是在 Customers ▸ Companies ▸ [公司] ▸ Payment terms 中完成的 — 见 B2B 设置指南。上面的 vertex.payment_terms metafield 纯粹是 Vertex 在 chrome 中显示的标签;两者相互独立,所以两个都要设置。
不需要 metafield 的内容
以下数据已经是 Shopify B2B 原生的,不需要 vertex 命名空间中的任何内容:
| 数据 | 来源 |
|---|---|
| B2B 价格和数量阶梯 | 目录价目表 |
| 数量规则(MOQ、最大值、增量) | 目录数量规则 |
| 公司名称和地点 | 原生 Shopify 公司记录 |
| 免税状态 | 公司级税务设置 |
| 订单历史(用于重新订购) | 原生 Shopify 订单 |
| 消费限额进度 | 公司地点上的 vertex.spending_limit(可选) |
Vertex 直接从 Shopify 读取这些。本指南中的 metafield 只填补 Shopify 没有原生等效项的空白 — 如销售代表联系方式、技术文档、规格,以及每个产品的 ships-from 标签。
验证您的设置
在店铺前端打开一个产品,并逐项核对此清单:
- MPN 在产品页 header 中显示。
- "Ships from [城市]" 在产品标题下显示。
- 文档块渲染,每个您上传的 PDF 对应一个按钮。
- 规格表渲染您添加的所有行。
- 价格历史块(如已填写)作为可折叠卡片显示在价格下方。
然后以测试公司中的 B2B 买家身份登录店铺前端,以验证代表卡片:
- 销售代表胶囊在桌面 header(≥1170px)中渲染。
- 邮件按钮打开您的邮件客户端,并预填代表的地址。
- 电话按钮在移动端触发通话。
- 移动抽屉(<1170px) 在底部显示代表卡片。
- 账户面板显示完整的代表卡片。
接下来做什么
- B2B 设置指南 → — 端到端启用原生 B2B,以便代表卡片和 B2B chrome 有附加位置。
- Storefront 模式指南 → — 选择 B2B 驱动的 UI 如何在您的店铺前端呈现。
- 主题设置参考 → — 与这些 metafield 搭配的产品页开关。
- FAQ + 故障排除 → — 解答顶级设置相关问题。