在 OS 3.0 主题编辑器中配置动态源 (Metafield) – SHOPLINE 常见问题

动态源 (Metafield) 允许您在店铺前台动态引用店铺内部的实时数据，用以取代手动输入的静态内容。通过将组件连接至动态源，您可以确保商品特性或系列标签等独特细节在整个店铺中保持实时更新与一致。目前，该功能主要支持【商品】、【商品分类】以及【商品款式】资源的元字段。

本文将说明如何定义自定义数据（元字段）、理解三种数据抓取维度，以及如何利用「最邻近资源」逻辑实现商品列表的自动化展示。

注意：元字段和元对象是两种互补的动态源类型。本文介绍元字段——附加在商品或分类等特定资源上的自定义属性。如需了解元对象（店铺级别的可复用数据记录），请参阅《在 OS 3.0 主题编辑器中调用元对象（Metaobject）》。

在配置动态源前创建元字段

在展示动态内容之前，您必须先定义自定义数据字段（元字段）并为商品、商品分类或商品款式赋值。

在 SHOPLINE admin 后台，前往【设置】>【自定义数据】。
选择您想要创建的资源类型（例如【商品】、【商品分类】或【商品款式】）。
点击【添加字段】以创建新字段。
前往具体项目（例如：商品或商品款式），在【元字段】区域为该项目输入所需字段。然后，点击【添加】以保存设置。

注意： 有关如何创建和管理元字段的详细指南，请参阅《元字段 (Metafields) 功能使用指南》。

三大动态资源解析

OS 3.0 主题编辑器采用了一套通用的底层机制，适用于所有 OS 3.0 主题（包括官方、第三方及自定义主题）与组件。根据组件在页面中所处位置的不同，系统提供以下三种数据抓取逻辑，以满足多样化的展示需求：

当前页面资源

运作逻辑： 这是一种固定的数据逻辑，完全由消费者当前访问的「页面网址 (URL)」决定。
应用场景： 适用于商品详情页或商品分类页的固定位置。
效果： 当消费者访问 A 商品页时，系统自动识别 URL 并锁定 A 商品的元字段。组件只要连接至「当前商品」，即可自动抓取该页面的专属资料。

当前组件资源

运作逻辑： 基于「组件自身层级」的设定，不依赖所在页面。组件层级配置了什么数据，底下的模块就会读取什么数据。
应用场景： 适用于可放置在任意页面（如首页）的独立组件，如「特色推荐商品」组件。
效果： 商家必须先在组件的最高层级手动绑定一个资源（如：夏季促销分类）。绑定后，内部模块选择「当前组件」，即可精准抓取该分类资料，避免因找不到源头而显示空白。

理解与使用「最邻近资源」

最邻近资源机制是实现自动化布局的核心突破。在处理大量商品展示时，最邻近资源能确保每个商品卡片都能精准展示对应的独特属性（如：饮料的酒精含量或服装的面料构成）。

为什么使用最邻近资源

自动化： 您无需再为商品中的每个独立卡片手动分配数据。
精细化展示： 直接在列表或搜索结果的商品卡片上展示特定属性（例如：饮料的酒精含量或衣服的面料类型）。

如何配置最邻近资源

在 OS 3.0 主题编辑器中，前往包含商品列表的页面（例如：商品详情页）。
选中商品详情模板内的某个组件（例如：【商品描述】组件）。
点击旁边的【添加动态源】图标。
在【当前组件】分类下选择【最邻近商品】。
选择您想要展示的具体【元字段】并点击【保存】。

展示商品款式元字段

除了商品和商品分类的元字段外，OS 3.0 主题编辑器现在也可以拉取【商品款式】元字段的数据。这样您就可以展示与顾客当前所选具体款式（SKU）相对应的内容例如，为同一商品的不同颜色选项展示不同的护理说明标签。

商品款式元字段支持的数据类型

商品款式元字段支持的数据类型与商品元字段完全相同，包括是否支持多值列表在内的所有格式。完整的元字段数据类型列表，请参阅《元字段 (Metafields) 功能使用指南》。

为商品款式元字段选择正确的动态源维度

将组件连接到商品款式元字段时，请在【当前组件】类别下选择【最邻近商品】这与商品列表中使用的维度相同。这样可确保区块能正确解析到当前情境下的具体商品与款式，无论该组件位于商品详情页、商品列表卡片，还是独立分区中。

注意：为简化配置并避免显示错误，将组件连接到商品款式元字段时，请始终选择【最邻近商品】。

为商品款式元字段启用款式选择器

若要让展示内容在顾客切换款式时自动更新，该页面或区块中必须包含【款式选择器】组件。

注意：如果没有【款式选择器】，该区块将只显示第一个款式的元字段数值，且顾客与页面互动时该数值不会发生变化。

使用场景：商品列表 vs. 独立组件

选择正确的资源维度取决于组件在页面中的应用方式：

场景一：商品列表页
- 应用位置： 位于商品列表页或搜索结果页的商品。
- 配置方式： 为商品卡片内的模块选择【最邻近资源】。
- 效果： 这能确保商品中的每一张卡片都能自动匹配其对应的商品特性，实现批量展示。
场景二：在任意页面添加商品展示分区
- 应用位置： 当您在首页或自定义页面上添加「特色推荐商品」或「商品列表」等组件。
- 配置方式： 您必须先在组件层级手动指定一个固定的数据源（例如绑定「夏季新品」分类）。
- 效果： 允许您在非商品模板页面上，精准展示特定范围的商品动态信息，实现更灵活的店铺布局。

重要： 若未先在组件层级指定数据源，下方的模块将无法「向上查找」到数据源，导致内容显示为空。

元字段常见问题

Q1. 如何在商品分类页的商品列表上，让每张商品卡片显示個別商品的元字段？

您必须使用「最近资源」机制。

常见误区： 在商品分类页中，系统默认的「当前页面资源」抓取的是整个「商品分类」的资料。如果直接套用，卡片将无法获取单个商品的独特属性（如：酒精含量、面料材质）。
正确解法： 请在编辑器中点击商品卡片内的特定模块（如文本框），将动态源设定为寻找最近资源下的最近商品。
背后原理： 当系统产生商品列表时，会自动将单体商品数据赋予对应的卡片。设定为最近资源后，该模块会「由下往上」精准抓取最靠近它的那笔商品元字段数据，从而实现差异化展示。

Q2. 元字段与元对象有什么区别？

元字段是直接附加在某个资源（如商品或分类）上的自定义属性，例如某款精华液的「主要成分」或某款面霜的「适用肤质」它属于这件商品，跟着这件商品走。

元对象则是独立的、可复用的数据记录，不附属于任何特定商品或分类，可以被多个商品、页面或组件引用。举个例子：如果您的店铺有多个保养系列，「系列理念与研发故事」这类内容可能需要在同一系列的所有商品页面上共同呈现，这时就适合用元对象集中管理，避免在每件商品上重复填写相同内容。如需了解元对象，请参阅《在 OS 3.0 主题编辑器中调用元对象（Metaobject）》。

Q3. 如何展示会随顾客切换 SKU 而更新的特定款式元字段数值？

将组件连接到【商品款式】元字段，并使用【最邻近商品】维度，同时确保该页面或分区已启用【款式选择器】组件。完整说明请参阅上方的「展示商品款式元字段」。目前该场景仅支持单行文本和多行文本类型的元字段。