Adobe Commerceの Catalog Service

Catalog Service for Adobe Commerce拡張機能は、専用のGraphQL API を通じて最適化された読み取り専用カタログデータを提供することで、ストアフロントの読み込み時間を向上させます。 このサービスは、製品関連のページエクスペリエンスを強化するように特別に設計されており、結果として、ページの読み込みが速くなり、コンバージョン率が向上します。

Catalog Service が提供する豊富な表示モデルのデータには、製品の詳細、属性、在庫、価格が含まれており、次のような製品関連のストアフロントのエクスペリエンスをすばやくレンダリングできます。

主なメリットと機能

アーキテクチャの概要

Catalog Service は GraphQL を使用して、商品、商品属性、在庫、価格などのカタログデータをリクエストおよび受け取ります。 GraphQLは、フロントエンドクライアントが、Adobe Commerceなどのバックエンドで定義されたアプリケーションプログラミングインターフェイス（API）との通信に使用するクエリ言語です。 GraphQLは軽量で、システムインテグレーターが各応答の内容と順序を指定できるため、一般的な通信方法です。

Adobe Commerceには、異なる目的に使用する 2 つのGraphQL システムが用意されています。

コアGraphQLシステム

カタログサービスGraphQLシステム

カタログサービスで使用可能なデータは、SaaS データエクスポート拡張機能によって配信されます。 この拡張機能では、Commerce アプリケーションと接続されたCommerce サービスの間でデータを同期し、サービス GraphQL API エンドポイントへのクエリが最新のカタログデータを返すようにします。 SaaS データ書き出し操作の管理とトラブルシューティングについては、『 SaaS データ書き出しガイド』を参照してください。

Catalog Service のお客様は、より迅速な価格更新と同期時間を提供する SaaS 価格インデクサーを使用できます。

アーキテクチャの詳細

次の図は、コア GraphQL システムと Catalog Service GraphQL システムのアーキテクチャの違いを示しており、これらのシステムが連携してストアフロントのパフォーマンスを最適化する仕組みを示しています。

システムの仕組み

コアGraphQLシステム（従来のアプローチ）:
プログレッシブ web アプリケーション（PWA）は、Commerce アプリケーションにリクエストを直接送信します。このアプリケーションは、複数のサブシステムを介して各リクエストを処理してから応答を返します。 この複数ステップのラウンドトリップにより、ページの読み込み時間が遅くなり、コンバージョン率が低下する可能性があります。

カタログサービス（最適化されたアプローチ）:
カタログサービスは、製品の詳細、属性、バリアント、価格、カテゴリを含む専用の最適化されたデータベースにアクセスするストアフロントサービスゲートウェイとして機能します。 このサービスは、自動インデックス作成を通じてAdobe Commerceとの同期を維持し、従来のリクエスト – 応答サイクルを回避して待ち時間を大幅に短縮します。

コアおよびサービスのGraphQL システムは、相互に直接通信しません。 異なる URL から各システムにアクセスする場合、呼び出しには異なるヘッダー情報が必要です。 2 つのGraphQL システムは、一緒に使用するように設計されています。 Catalog Service GraphQL システムは、コアシステムを強化して、製品ストアフロントのエクスペリエンスを高速化します。

オプションで、Adobe Developer App Builderの API メッシュを実装して、2 つのAdobe Commerce GraphQL システムをAdobe Developerを使用してプライベートおよびサードパーティの API やその他のソフトウェアインターフェイスと統合できます。 メッシュは、各エンドポイントにルーティングされる呼び出しにヘッダーの正しい認証情報が含まれるように設定できます。

アーキテクチャの詳細

以下の節では、2 つのGraphQL システムの違いの一部を説明します。

スキーマ管理

カタログサービスはサービスとして機能するので、インテグレーターはCommerceの基盤となるバージョンについて心配する必要はありません。 クエリの構文は、すべてのバージョンで同じです。 また、このスキーマはすべてのマーチャントで一貫しています。 この一貫性により、ベストプラクティスの確立が容易になり、ストアフロントウィジェットの再利用が大幅に増加します。

製品タイプの簡素化

このスキーマにより、製品タイプの多様性は次の 2 つのユースケースに限定されます。

製品ビュー属性

シンプルな製品と複雑な製品にはどちらも、ストアフロントに表示できる顧客定義の属性があります。 これらの属性は ProductViewAttributes として返されます。 Adobe Commerceでは、使用可能な属性は商品の作成時に定義されます。 属性は、Adobe Commerce バックエンドから、またはプログラムを使用して追加できます。 SaaS データ書き出しフィードデータの拡張とカスタマイズを参照してください。

価格

単純な製品は、価格のある基本販売単位を表します。 Catalog Service は、割引前の通常価格と、割引後の最終価格を計算します。 価格の計算には、固定製品税を含めることができます。 パーソナライズされたプロモーションは除外されます。

複雑な製品には定価がありません。 代わりに、カタログサービスはリンクサンプルの価格を返します。 例えば、マーチャントは最初に設定可能な商品のすべてのバリエーションに同じ価格を割り当てることができます。 特定のサイズや色が人気がない場合、商人はそれらのバリアントの価格を下げることができます。 したがって、最初の複雑な（設定可能な）製品の価格は、標準的なバージョンと人気のないバージョンの両方の価格を反映して、価格範囲を示しています。 買い物客が使用可能なすべてのオプションの値を選択すると、ストアフロントに単一価格が表示されます。

カタログサービスは、大きな値（最大 16 桁）と高い小数点精度（最大 4 桁）の価格をサポートすることで、正確な価格の更新と計算を保証します。

実装

実装プロセスには、以下が含まれます。