您现在可以在在shopify.app.toml中声明的metafield和metaobject定义上启用analytics_queryable功能,商家随后可以在Shopify Analytics和ShopifyQL中使用这些metafield和metaobject作为维度和筛选条件。此前,您只能通过GraphQL Admin API设置此功能。
变更内容
声明式定义接受一个新功能:capabilities.analytics_queryable。当它处于true状态时,定义的值的查询方式与通过metafieldDefinitionCreate、metafieldDefinitionUpdate、metaobjectDefinitionCreate和metaobjectDefinitionUpdate突变设置analyticsQueryable时相同,使其在分析中可查询。
[customer.metafields.app.membership_level] name = "Membership level" type = "single_line_text_field" capabilities.analytics_queryable = true [metaobjects.app.ingredient] name = "Ingredient" capabilities.analytics_queryable = true [metaobjects.app.ingredient.fields.name] type = "single_line_text_field" name = "Name" [metaobjects.app.ingredient.fields.calories] type = "number_integer" name = "Calories"使用shopify app deploy发布您的应用版本,Shopify会将该定义分发到您应用已安装的所有商店。
需要了解的内容
- 此功能适用于客户、订单、商品和商品变体元字段定义。
- 并非所有metafield类型都能在分析中查询。要确认某个定义是否可以使用此功能,请检查其analyticsQueryable功能上的eligible字段。
- 仅当元对象定义的至少一个字段具有与分析兼容的类型时,该元对象定义才能使用此功能。
如需更多信息,请参阅以下资源:
- 使用元字段功能
- 元字段定义的 TOML 参考
- Admin API中可用的Metaobject分析可查询功能。

