記事のサマリー(TL;DR)
- shopify.app.toml内で宣言するmetafieldおよびmetaobject定義に、analytics_queryable機能を有効化できるようになりました。
- 有効化すると、マーチャントはそれらのmetafieldやmetaobjectをShopify AnalyticsおよびShopifyQLでディメンションやフィルタとして利用できます。
- これまでこの機能はGraphQL Admin APIからのみ設定可能でした。
利用条件・操作手順
宣言的な定義(declarative definitions)は、新しい機能としてcapabilities.analytics_queryableを受け付けます。これをtrueに設定すると、metafieldDefinitionCreate、metafieldDefinitionUpdate、metaobjectDefinitionCreate、metaobjectDefinitionUpdateの各ミューテーションでanalyticsQueryableを設定した場合と同様に、定義の値がアナリティクスでクエリ可能になります。アプリのバージョンはshopify app deployでリリースする必要があり、これによりShopifyはそのアプリがインストールされているすべてのストアに定義を配布します。
詳細
変更内容
shopify.app.tomlで宣言するmetafieldおよびmetaobject定義に対して、analytics_queryable機能を有効化できるようになりました。これにより、マーチャントはこれらのmetafieldおよびmetaobjectをShopify AnalyticsとShopifyQLにおいてディメンションおよびフィルタとして使用できます。
以前は、この機能はGraphQL Admin APIを通じてのみ設定可能でした。
宣言的な定義は新しい機能capabilities.analytics_queryableを受け付けます。この値をtrueに設定すると、metafieldDefinitionCreate、metafieldDefinitionUpdate、metaobjectDefinitionCreate、metaobjectDefinitionUpdateの各ミューテーションでanalyticsQueryableを設定した場合と同様に、その定義の値がアナリティクスでクエリ可能になります。
アプリのバージョンはshopify app deployコマンドでリリースします。これにより、Shopifyはそのアプリがインストールされているすべてのストアに定義を配布します。