GraphQL Admin API 中的 analyticsQueryable 功能现已在 MetafieldDefinition 类型中可用,使您能够指定元字段是否可在 Shopify Analytics 中查询。此增强功能允许商家利用自定义元字段值对数据进行过滤和分组,从而更深入地了解其商店的性能。
您可以通过 MetafieldDefinition.capabilities 字段访问此功能。在使用 metafieldDefinitionCreate 和 metafieldDefinitionUpdate 变更操作创建或更新元字段定义时,可以设置该功能。
启用后,元字段将成为 ShopifyQL 和 Shopify Analytics 中的维度和过滤器,赋能商家完善数据分析。目前,此功能支持以下 MetafieldDefinition.ownerType 值:
- PRODUCT
- PRODUCTVARIANT
- ORDER
- CUSTOMER
示例:在新 Metafield 定义中启用 Analytics Queryable
以下 GraphQL 变更操作演示了如何为新元字段定义启用 analyticsQueryable 功能。此示例为产品设置了元字段,使其可用于分析查询:
mutation { metafieldDefinitionCreate(definition: { name: "Fabric" namespace: "custom" key: "fabric" type: "single_line_text_field" ownerType: PRODUCT capabilities: { analyticsQueryable: { enabled: true } } }) { createdDefinition { id capabilities { analyticsQueryable { enabled } } } userErrors { field message } } }此变更操作创建了一个新的元字段定义,并启用了 analyticsQueryable 功能,使其可在 Shopify Analytics 中使用。

