2月 21, 2026

`trackingParameters`が`Product`、`Collection`、`Article`、`Post`、`SearchQuerySuggestion`のGraphQL型で利用可能に

2月 21, 2026

`Product`、`Collection`、`Article`、`Post`、`SearchQuerySuggestion` GraphQLタイプで`trackingParameters`が利用可能になりました

Shopifyの開発者やエンジニアの皆さん、いつもお疲れ様です。今回は、ShopifyのGraphQL型に新たなフィールド`trackingParameters`が追加されたアップデートについて解説します。この新機能が、ECサイトの効果測定と最適化にどのように役立つのか、具体的な実装例とともに解説していきます。

1. 技術的課題の定義と現状分析

ECサイト上でのユーザー行動の追跡と分析は、サイト最適化やマーケティング戦略策定に不可欠な要素です。しかし、それらの行動を追跡するためのパラメータを正確に設定し、それを正確に取得・解析することは、技術的な課題を伴うことがあります。今回のアップデートでは、`search`や`predictiveSearch`からの結果として得られる`Product`、`Collection`、`Article`、`Post`、`SearchQuerySuggestion` GraphQL型に`trackingParameters`が追加され、その課題が解消されます。

2. 技術的ソリューションの提案

新たに追加された`trackingParameters`を利用することで、検索結果からのトラフィックの起源を追跡することが可能になります。それぞれの検索結果に由来するトラフィックを正確に把握することで、サイト内の各ページのパフォーマンスをより詳細に分析し、最適化を進めることができます。

3. 実装手順とコード例

まず、GraphQLのクエリ内で`trackingParameters`を含めることで、それぞれの検索結果に由来するトラフィックを追跡できます。以下に、`Product`タイプの例を示します。

{
  search(query: "example") {
    products(first: 5) {
      edges {
        node {
          id
          title
          trackingParameters
        }
      }
    }
  }
}

このクエリにより、各商品に対するトラッキングパラメータを取得できます。これをURLの一部として組み込むことで、そのURLからのトラフィックの原点を追跡することが可能になります。