元字段 (Metafields) 功能使用指南
元字段功能模块能够让您在 SHOPLINE 后台中存储拓展字段，以此来实现店铺外观定制、功能定制的效果。通过使用元字段，您能够实现对店铺设计和商品页面的个性化配置或多样化展示效果，例如：
- 在商品详情页中为您的多款商品添加不同的使用说明书。
- 在不同的商品列表页中，添加不同的折扣优惠信息。
- 为服饰商品添加不同的材质说明、洗涤建议等。
- 为首饰类商品，添加“克拉数”展示信息。
- 为不同的商品，添加不同的发货公告。
您也可以点击元字段博客文章查看功能的详细介绍。
元字段使用步骤概览
- 选择资源类型：每个元字段将只对单独的”资源类型“生效，因此要使用元字段，您将需要先确定您要创建元字段的资源类型。
目前元字段的功能支持「商品」「商品款式」「商品分类」「自定义页面」「客户」「博客」「博客集合」「公司」资源类型。 - 输入元字段的基本信息。
- 在您的店铺Admin后台为元字段赋值。
- 在页面编辑器中插入动态源或者在SHOPLINE Layout Engine里插入调用代码。
- 目前元字段的功能支持「商品」「商品款式」「商品分类」「自定义页面」「客户」「博客」「博客集合」「公司」资源类型。
元字段简介
元字段的组成
输入元字段的基本信息元字段由 名称 / 资源对象 / 命名空间(Namespace) / 键(key) / 描述(Description) 以及 数据类型 组成
- 名称（Name）：元字段的名称。例如：商品材料。
- 资源对象（OwnerResource）：元字段所归属的资源类型，或称为"所有者资源类型"。例如：商品（products）、自定义页面（pages）等。
- 所有者资源ID（OwnerId）：元字段所归属的资源对象ID。例如：商品A的ID 1605898661。
- 命名空间(Namespace)：一组元字段的容器。通过命名空间对元字段进行分组，可防止商家的元字段与具有相同键名的其他元字段发生冲突。例如：my_fields。
- 键(Key)：元字段的名称，用以指向某元字段，通俗理解为此元字段的代码标识。例如：materials。
- 数据类型(Content_type)：元字段存储的数据类型，例如：单行文本、URL、整数等。
- 描述(Description)：该元字段定义的描述信息，用于帮助您在赋值时输入正确的值。例如：输入该首饰的材料信息。
- 值(Value)：要存储在元字段中的数据。例如：925 silver。
元字段的数据类型
以下为元字段功能的数据类型:
| 数据类型 | 子类 | 是否支持值列表 | 特性 | 使用场景举例 |
文本 |
单行文本 |
是 |
支持单行纯文本输入。 |
添加您的商品的发货公告 |
多行文本 |
是 |
支持多行纯文本输入。 |
为您的产品添加产品成分介绍表表 |
|
富文本 |
是 |
支持富文本输入。 |
为您的商品撰写排版精美的使用说明 备注：富文本元字段仅支持在 3.0 主题中显示 |
|
颜色 |
无 |
是 |
支持 #RRGGBB 格式的 RGB 值。 |
为您的页面添加底色 |
Json |
无 |
否 |
支持用于高级用例的原始 JSON 数据。 |
在店铺页面中添加自定义模块 |
数字 |
整数 |
是 |
仅支持输入整数。 |
添加书籍商品的特定页数说明 |
小数 |
是 |
支持输入整数+小数。 |
在商品详情页中添加珠宝的克拉数信息 |
|
URL |
无 |
是 |
支持 添加HTTP、HTTPS 和 mailto: |
在您的商品详情页添加url链接 |
|
日期和时间
|
日期 |
是 |
支持采用 ISO 8601 格式且不包含时区的日期值。 |
添加产品到期日期、订单配送日期或客户出生日期例：2022-05-28 |
日期和时间 |
是 |
支持采用 ISO 8601 格式的日期值和采用 UTC 时间的时间值。 |
2022-01-01T12:30:00 |
|
true 或 false |
无 |
否 |
布尔类型 ，创建一个复选框，用于选择条件是 true 还是 false。 |
添加是否提供某个选项，例如产品是否可以雕刻 例： true |
|
度量
|
重量 |
是 |
支持整数和小数值。重量使用公制或英制度量单位，kg, g, lb,oz |
添加产品或配料的重量，例如糖的克数 例：{\"value\":3.0,\"unit\":\"oz\"} |
尺寸 |
是 |
支持整数和小数值。尺寸使用公制或英制度量单位。mm,cm,m,inch,foot,code |
尺寸：添加包装箱高度或产品长度，例如围巾的长度 例：{\"value\":2.0,\"unit\":\"in\"} |
|
体积 |
是 |
支持整数和小数值。体积使用公制或英制度量单位 一个值和一个体积单位。有效单位值：ml, cl, l, m3(立方米), us_fl_oz, us_pt, us_qt, us_gal, imp_fl_oz, imp_pt, imp_qt, imp_gal |
体积：添加水杯的体积容量 例：{\"value\":1.0,\"unit\":\"us_fl_oz\"} |
|
评分 |
无 |
是 |
支持配置评分或星级。 |
为产品添加用户评分或星级评分 例：{\"value\":\"5\"} |
|
参考
|
商品 |
是 |
支持对在线商店中的商品进行引用。 |
在在线商店的产品页面或产品系列页面上，设置显示特色产品 例：gid://shopline/Product/160589866 |
商品款式 |
是 |
支持对在线商店中的商品款式进行引用。 |
在在线商店的产品页面上，设置显示具有相同颜色的其他服装商品 例：gid://shopline/ProductVariant/1805951613 |
|
商品分类 |
是 |
支持对在线商店中的商品分类进行引用。 |
例：gid://shopline/collections/1225615767 |
|
页面 |
是 |
支持对在线商店中的自定义页面进行引用。 |
在在线商店中插入政策页面或针对产品的详细保养指南 例：gid://shopline/Page/59592784 |
|
元对象 |
是 |
支持对在线商店中的元对象进行引用。 |
在店铺页面中添加元对象 |
|
文件 |
是 |
图片：引用店铺文件库，或者上传大小为10MB以内JPG,JEPG,PNG,GIF格式的图片；
PDF：引用店铺文件库，或者上传大小为10MB以内的pdf文件。 |
gid://shopline/MediaImage/59301914
gid://shopline/GenericFile/596207872 |
|
资金 |
无 |
否 |
一个数字金额，具有与商店货币相匹配的货币代码。 |
{\"amount\":\"2\",\"currency_code\":\"USD\"} |
创建元字段
下面将以 创建商品资源类型元字段 为例进行介绍
1. 打开SHOPLINE店铺后台，点击【设置】，在设置中点击【自定义数据】模块。
2. 在【元字段】区块下，选择您要创建元字段的资源类型，目前支持创建【商品 / 商品分类 / 商品款式 / 页面 / 客户 / 博客 / 博客集合 / 订单】资源类型的元字段。
在此流程中，我们选择【商品】资源类型进行元字段的创建
3. 点击【添加字段】 。
4. 填写字段名称、命名空间、密钥、以及描述，并选择您需要的数据类型，完毕后点击创建。
- 名称：用于在 SHOPLINE 后台中标识元字段，例如 Color。
- 命名空间和密钥：元字段的唯一识别码。您可以使用命名空间将类似元字段分组到一起，但每个命名空间和密钥必须唯一，例如 custom.color。命名空间和密钥不支持以数字开头。
- 描述（可选）：供您提供描述性信息，例如要为元字段输入的值。
- 数据类型：元字段存储的数据类型，例如文本、文件或 URL。支持配置单个，或多个。
5. 创建完毕。
元字段创建完毕后，您可以对元字段进行赋值
给元字段赋值
1. 选择您要赋值的资源类型，上一流程中我们创建的元字段的资源类型是 商品 ，因此我们将前往SHOPLINE Admin的商品页面进行赋值。选择您要赋值的具体商品，在此流程中。我们将选择第三个商品，进入详情页。
2. 在页面底部找到【自定义数据】模块，选定元字段进行赋值。您可以输入的值的类型取决于元字段的数据类型。
完成对元字段的赋值流程。
如何在主题设计中配置元字段
在编辑器中插入元字段动态源
请点击查看具体操作指引：
元字段 (Metafields) | 如何在主题设计中配置元字段
在 Layout Engine 代码中插入调用代码
元字段创建并赋值完成后，您可以通过下方表格中的调用代码，将其复制到Layout Engine在线代码编辑器中，以实现您的自定义需求。例如，您创建了一个商品元字段，命名空间（Namespace）为 my_fields，密钥（Key）为 additional_info，那么该商品元字段的调用代码为： {{product.metafields.my_fields.additional_info.value}}
| 资源类型 | 2.1 主題元字段调用代码 |
| 商品 | {{product.metafields.namespace.key.value}} |
| 商品分类 | {{collection.metafields.namespace.key.value}} |
| 商品款式 | {{variant.metafields.namespace.key.value}} |
| 页面 | {{page.metafields.namespace.key.value}} |
| 客户 | {{customer.metafields.namespace.key.value}} |
| 博客 | {{article.metafields.namespace.key.value}} |
| 博客集合 | {{blog.metafields.namespace.key.value}} |
| 订单 | {{order.metafields.namespace.key.value}} |
| 资源类型 | 3.0 主題元字段调用代码 |
| 商品 | {{#var metafield_ns = product | get_metafields("namespace") /}} {{#metafield_tag metafield_ns.key /}} |
| 商品分类 | {{#var metafield_ns = collection | get_metafields("namespace") /}} {{#metafield_tag metafield_ns.key /}} |
| 商品款式 | {{#var metafield_ns = variant | get_metafields("namespace") /}} {{#metafield_tag metafield_ns.key /}} |
| 页面 | {{#var metafield_ns = page | get_metafields("namespace") /}} {{#metafield_tag metafield_ns.key /}} |
| 客户 | {{#var metafield_ns = customer | get_metafields("namespace") /}} {{#metafield_tag metafield_ns.key /}} |
| 博客 | {{#var metafield_ns = article | get_metafields("namespace") /}} {{#metafield_tag metafield_ns.key /}} |
| 博客集合 | {{#var metafield_ns = blog | get_metafields("namespace") /}} {{#metafield_tag metafield_ns.key /}} |
| 订单 | {{#var metafield_ns = order | get_metafields("namespace") /}} {{#metafield_tag metafield_ns.key /}} |
未定义的元字段
元字段分为 已定义 和 未定义 两种：
已定义的元字段：已经在店铺后台建立定义，并指定了数据类型（如文字、数字、布尔值、媒体文件等）。这类元字段会显示在后台界面，方便直接输入和管理。
未定义的元字段：指没有在店铺后台建立定义的元字段，通常是通过 API 或第三方应用写入的数据。这些元字段不会自动显示在后台设置页面，但依然存在于系统数据中。
您可以进入未定义的元字段标签页，统一管理这些字段。在这里您可以：
编辑：点击元字段后，可以修改名称，并将其转为已定义的元字段。
删除：如果该元字段不再需要，可以直接删除。
实操建议
自主拓展字段，灵活定制商品详情页
好的商品详情页能够为买家提供让他们做出购买决策所需的充足信息。在竞争激烈的跨境电商市场，细节常常决定成败。如果卖家能在商品详情页向买家展示与众不同的细节，也能帮助卖家获取到买家更多的好感和信任，形成差异化竞争，从而超越竞争对手。
比如某个卖家想为某款商品添加洗涤说明，可以在该商品中创建洗涤说明的拓展字段，这样买家就能在该商品详情页中看到洗涤说明提醒，提升对商品的信任感和好感，并且更不容易因为洗涤出错发生退货情况。
除了洗涤说明，像商品的材质、产地、体型等信息，只要有需求，卖家都可以通过元字段进行添加，展示在商品详情页中。
简单代码定制，实现个性化功能需求
除了能够灵活展示更多的信息，元字段还能够基于特定业务场景，通过简单代码定制来实现个性化功能需求，有效降低卖家在店铺定制化过程中面临的技术成本和技术门槛。
比如商品描述实现TAB切换、添加相关资料下载区、添加相关商品推荐区等。
商品描述实现TAB切换
有时候商品详情页需要展示的信息较多，如果这些信息全部放在商品详情页会显得杂乱拥挤，让买家难以第一时间找到他们想要的信息，导致购物体验不佳，容易造成客户流失。
这时卖家可以使用TAB切换模板，将信息进行分类归纳，统一置于一个内容框中展示，让买家可以通过TAB切换来浏览不同类别的信息。这样既能保证商品详情页展示的信息全面，又能兼顾页面美观性。
以往卖家如果想要在页面中增加该功能，需要额外花钱请技术人员进行创建，并不方便。有了元字段管理工具后，卖家可以自主创建一个新的拓展字段，将简单的TAB切换模板代码复制粘贴上去，这样就能够轻松搭建好一个商品描述TAB切换模板，并展示在商品详情页。
添加相关材料下载区
并不是所有的信息都能够直接在商品详情页进行展示，有一些必要的材料说明，由于内容较多，以文件的形式展示给消费者会更合适，比如安装说明书、材料成分说明。
使用元字段，卖家可以给需要的商品添加相关材料的下载链接，并支持买家点击下载后，直接在本地查阅。
添加相关商品推荐区
数据表明，在单个商品详情页加入相关商品推荐，不仅能够有效增加消费者在页面的浏览时长，还能够提高店铺客单价。
以往卖家想要实现相关商品推荐，需要借助特定的插件功能。有了元字段管理工具，卖家可以随时随地创建一个相关商品推荐模块。
除了允许卖家为商品、品类、顾客、订单、博客、页面和店铺等资源对象创建额外的拓展字段并存储一些特定的信息，元字段还能通过Admin API实现跟其他电子商务系统（CRM/IMS/ERP）之间的数据传输和交互，让SHOPLINE店铺能更开放、更轻松地对接到其它系统，卖家也能更方便地管理和查看各种数据。