ストアフロントの設定
このガイドでは、Adobe Edge Delivery Servicesを使用してAdobe Commerce Optimizer インスタンスのストアフロントを設定する方法について説明します。 ストアフロントには、定型文コード、サンプルコンテンツ、商品詳細ページおよび商品発見(検索とフィルタリング)のサポートが含まれます。
完了までの推定時間: 30 ~ 45分
前提条件
- リポジトリを作成でき、ローカル開発用に設定されているGitHub アカウント (github.com)
- サンプルデータと設定されたカタログビューとポリシーを含むAdobe Commerce Optimizerインスタンス
- 設定手順については、 サンプルデータの追加を参照してください。
必要なインスタンスデータ
開始する前に、Adobe Commerce Optimizer インスタンスから次の情報を収集します。
- テナント ID (インスタンス IDとも呼ばれます)
- インスタンスの詳細ページ から入手できます
- インスタンスのGraphQL エンドポイント
- インスタンスの詳細ページ から入手できます
- グローバル カタログ ビューのカタログ ビューID
- カタログの詳細ページ から入手できます
- カタログ ビューのSource ロケール
- サンプルデータのデフォルトは
en-USです
- サンプルデータのデフォルトは
ステップの設定
-
ストアフロントプロジェクトを作成- サイト作成ツール を使用して、定型文コード、サンプルコンテンツ、設定ファイルを含む新しいストアフロントプロジェクトを作成します。
-
ストアフロント設定をカスタマイズ – リポジトリ内の
config.jsonファイルを更新して、Adobe Commerce Optimizer インスタンスに接続します。 -
設定を確認 (10分)
- ストアフロントサイトのプレビュー
- 商品詳細ページと検索機能のテスト
ストアフロントプロジェクトの作成
サイト作成ツールは、次のコンポーネントを含む完全なストアフロントプロジェクトを作成します。
- サイト:ボイラープレートコンテンツを含むストアフロントのランディングページ
- コード:定型文ソースファイルを含むリポジトリ
- コンテンツ: サイト コンテンツ ファイルを含むドキュメント オーサー環境
- Commerce Config: Commerce ストアフロント設定 (インスタンス固有の設定)
ステップ 1:プロジェクトの生成
-
サイト作成者ツール を開きます
{width="700" modal="regular"}
-
新しいサイトを作成(コードとコンテンツ)を選択します。
-
サイト設定を完了します。
- GitHub Organization/Username: GitHub ユーザー名または組織名を入力してください
- サイト名: ストアフロントにわかりやすい名前を選択します
- Commerce GraphQL エンドポイント (オプション): Adobe Commerce Optimizer インスタンスのGraphQL エンドポイントを入力します
-
「サイトを作成」をクリックして、ストアフロントのボイラープレートコードを使用してGitHub リポジトリを作成します。
リポジトリが作成されると、サイト作成者が更新され、Code Sync アプリのインストールを求めるメッセージが表示されます。
手順2:Code Sync アプリのインストール
-
「Install AEM Code Sync App」をクリックして、Code Sync インストーラーを新しいタブで開きます。
-
Code Sync アプリを設定します。
- GitHub組織を選択し、Configureをクリックします。
- コード同期インターフェイスで、Only select repositoriesをクリックします。
- Select repositories メニューをクリックし、作成したストアフロントコードリポジトリを選択します。
- Saveをクリックしてリポジトリを登録します。
-
サイト作成者が開いているブラウザーウィンドウに戻り、サイトを作成をクリックします。
サイト作成者は、ストアフロントのボイラープレートコンテンツをDocument Author環境にコピーします。 このプロセスには1~2分かかります。
手順3:プロジェクトリンクの保存
-
「サイトの詳細」セクションで、ストアフロントプロジェクトのリンクを確認します。
{width="700" modal="regular"}
これらのリンクを使用して、ストアフロントコード、コンテンツ、設定を管理します。
-
将来の参照のために、これらのリンクをコピーして保存します:**Copyをクリックします。
ストアフロントの設定
ストアフロント設定を更新して、Adobe Commerce Optimizer インスタンスに接続します。
-
config.jsonファイルをボイラープレートコードリポジトリで開きます。https://github.com/<username or org>/<repo name>/config.json -
設定の
cs(カタログサービス)セクションを探します。 -
プレースホルダーの値をインスタンスの値に置き換えます。 前提条件を参照してください。
code language-json "cs": { "AC-View-ID": "{catalogViewId}", "AC-Source-Locale": "en-US", "AC-Price-Book-ID": "{priceBookId}" }note note NOTE 価格表IDを見つけるには、の カタログ表示設定の詳細Adobe Commerce Optimizerを確認して、割り当てられた価格表を確認します。 価格表が割り当てられていない場合は、このヘッダーを設定ファイルから削除できます。 価格表がカタログ ビューに割り当てられたときに再度追加します。 -
設定ファイルを保存します。
設定の変更が反映されるまでに数分かかる場合があります。 データがすぐに表示されない場合は、トラブルシューティングの2~3分前に待ってください。
設定を確認
ストアフロントをテストして、Adobe Commerce Optimizer インスタンスに正しく接続されていることを確認します。
ステップ 1:ストアフロントホームページを表示する
-
ライブプレビューURLに移動します。
https://main--{SITE}--{ORG}.aem.live{ORG}と{SITE}をGitHub組織とサイト名に置き換えます。 -
成功基準:定型文のコンテンツを含むストアフロントのホームページが表示されます。
{width="700" modal="regular"}
ステップ 2:商品詳細ページのテスト
デフォルトの製品詳細ページを表示して、製品データが正しく読み込まれていることを確認します。
-
サンプル製品ページに移動します。
https://main--{SITE}--{ORG}.aem.live/products/placeholder/{sku}サンプルデータから任意のSKUを使用します。例えば、次のようになります。
https://main--{SITE}--{ORG}.aem.live/products/placeholder/aur-flu-tir-std-2017デフォルトのストアフロントでは、ルートの
placeholder値を使用して製品を表示できます。 ストアフロントのカスタマイズを開始する際には、ストアフロントコードをカスタマイズして、カタログで定義された製品ルートに基づいて、製品詳細ページへのパスを設定できます。note tip TIP インスタンスの データ同期Adobe Commerce Optimizer ページから使用可能なSKUを表示します。 -
成功基準: ページに次の情報を表示する必要があります:
- 製品名、説明、価格
- 製品画像
- カートに追加機能
- Adobe Commerce Optimizer インスタンスから取得したデータ
{width="700" modal="regular"}
手順3:デフォルトの検索機能をテストする
検索やフィルタリングなど、商品のデフォルト機能をテストできます。
-
ストアフロントのホームページで、ヘッダーの虫眼鏡アイコンをクリックします。
-
検索文字列
tiresを入力し、Enterを押します。 -
成功基準:次が表示されます。
- タイヤ商品の検索結果ページ
- サイドバーのフィルターオプション
- 画像と価格設定が掲載された商品リスト
{width="675" modal="regular"}
-
任意のタイヤ製品をクリックして、その詳細ページを表示します。
{width="675" modal="regular"}
トラブルシューティング
設定中に問題が発生した場合は、web ページインスペクターコンソールを使用してエラーを確認します。 また、ブラウザーのキャッシュをクリアするか、別のブラウザーを使用してみてください。
一般的な問題を確認するには、次のガイダンスを使用します。
一般的な問題
- GitHub組織への管理者アクセス権があることを確認します。
- 組織の代わりに個人リポジトリを使用してみてください。
- GitHub権限を確認して、もう一度試してください。
- サイト URL形式を確認してください:
https://main--{SITE}--{ORG}.aem.live - Code Sync アプリが適切にインストールされていることを確認します。
- リポジトリが公開されているか、適切に設定されていることを確認します。
config.jsonで設定値を確認してください- Adobe Commerce Optimizer インスタンスで、データ同期ページを確認して、サンプル製品が読み込まれていることを確認します。 使用可能な製品がない場合は、サンプルデータをリロードするか、Data Ingestion APIを使用して製品を追加します。 設定変更が反映されるまで数分待ちます。
- マーチャンダイジングサービス 製品クエリ を使用して、
config.jsonファイルで設定されているのと同じヘッダーを使用して、製品の詳細を取得してみてください。 データを取得できる場合は、カタログビューの設定に関する問題またはインデックスエラーが発生している可能性があります。
- マーチャンダイジングサービス productSearch クエリ を使用して、
config.jsonファイルで設定された同じヘッダーを使用して、製品検索結果を取得できることを確認します。 データを取得できる場合は、カタログビューの設定に関する問題またはインデックスエラーが発生している可能性があります。 config.jsonファイルのカタログビューIDがAdobe Commerce OptimizerのカタログビューIDと一致することを確認します。- Adobe Commerce Optimizerで、ストアフロントヘッダー設定で使用したポリシー、ロケール、価格表の設定を確認します。
- 属性メタデータ設定が検索用に正しく設定されていることを確認します。
検証チェックリスト
次の手順に進む前に、次の点を確認して、ストアフロントが正しく機能していることを確認します。
と一致しています
ヘルプを表示
問題が解決しない場合:
次のステップ
- ローカル開発環境の設定 – ローカル環境を作成して、ストアフロントコードとコンテンツをカスタマイズします。
- ユニバーサルエディターを有効にする- ユニバーサルエディターを使用すると、レンダリングされたページのコンテキストでストアフロントコンテンツを編集できます。 コンテンツはドキュメント作成(DA.live)プロジェクトに保存され、ローカライゼーション、一括公開、スナップショットなど、ほとんどのコンテンツオーケストレーションアプリを使用できます。
学習と探索
-
エンドツーエンドのユースケースを完了-Adobe Commerce Optimizerを使用したストアフロントの設定とカタログ管理について詳しく説明します。
-
ストアフロントのカスタマイズ の詳細な設定と設定オプションについて説明します。
-
Commerce ドロップインを使用してストアフロント エクスペリエンスをカスタマイズする – 事前定義済みコンポーネントを追加して、ストアフロント エクスペリエンスを強化します。
-
ストアフロント設定サービスへの移行 – 最初のストアフロントを作成した後、設定を移行して、再帰設定やオーバーレイなどの高度なユースケースをサポートする設定サービスを使用できます。 詳しくは、Adobe Experience ManagerのConfiguration Service ドキュメントを参照してください。