[SaaSのみ]{class="badge positive" title="Adobe Commerce as a Cloud Serviceおよび Adobe Commerce Optimizer プロジェクトにのみ適用されます(Adobeで管理されるSaaS インフラストラクチャ)。"}

ストアフロントの設定

このガイドでは、Adobe Edge Delivery Servicesを使用してAdobe Commerce Optimizer インスタンスのストアフロントを設定する方法について説明します。 ストアフロントには、定型文コード、サンプルコンテンツ、商品詳細ページおよび商品発見(検索とフィルタリング)のサポートが含まれます。

完了までの推定時間: 30 ~ 45分

前提条件

  • リポジトリを作成でき、ローカル開発用に設定されている​GitHub アカウント (github.com)
  • サンプルデータと設定されたカタログビューとポリシーを含む​Adobe Commerce Optimizerインスタンス

必要なインスタンスデータ

開始する前に、Adobe Commerce Optimizer インスタンスから次の情報を収集します。

NOTE
体験版アクセスのお客様は、インスタンスの作成時に受信したようこそメールにGraphQL エンドポイントを見つけることができます。 体験版インスタンスには、サンプルデータ、カタログビュー、ポリシーが事前に設定されています。

ステップの設定

  1. ストアフロントプロジェクトを作成-​ サイト作成ツール ​を使用して、定型文コード、サンプルコンテンツ、設定ファイルを含む新しいストアフロントプロジェクトを作成します。

  2. ストアフロント設定をカスタマイズ – リポジトリ内のconfig.json ファイルを更新して、Adobe Commerce Optimizer インスタンスに接続します。

  3. 設定を確認 (10分)

    • ストアフロントサイトのプレビュー
    • 商品詳細ページと検索機能のテスト

ストアフロントプロジェクトの作成

サイト作成ツールは、次のコンポーネントを含む完全なストアフロントプロジェクトを作成します。

  • サイト:ボイラープレートコンテンツを含むストアフロントのランディングページ
  • コード:定型文ソースファイルを含むリポジトリ
  • コンテンツ: サイト コンテンツ ファイルを含むドキュメント オーサー環境
  • Commerce Config: Commerce ストアフロント設定 (インスタンス固有の設定)

ステップ 1:プロジェクトの生成

  1. ​ サイト作成者ツール ​を開きます

    Site Creator tool {width="700" modal="regular"}

  2. 新しいサイトを作成(コードとコンテンツ)​を選択します。

  3. サイト設定を完了します。

    • GitHub Organization/Username: GitHub ユーザー名または組織名を入力してください
    • サイト名: ストアフロントにわかりやすい名前を選択します
    • Commerce GraphQL エンドポイント (オプション): Adobe Commerce Optimizer インスタンスのGraphQL エンドポイントを入力します
  4. サイトを作成」をクリックして、ストアフロントのボイラープレートコードを使用してGitHub リポジトリを作成します。

    リポジトリが作成されると、サイト作成者が更新され、Code Sync アプリのインストールを求めるメッセージが表示されます。

手順2:Code Sync アプリのインストール

  1. Install AEM Code Sync App」をクリックして、Code Sync インストーラーを新しいタブで開きます。

  2. Code Sync アプリを設定します。

    • GitHub組織を選択し、Configure​をクリックします。
    • コード同期インターフェイスで、Only select repositories​をクリックします。
    • Select repositories メニューをクリックし、作成したストアフロントコードリポジトリを選択します。
    • Save​をクリックしてリポジトリを登録します。
  3. サイト作成者が開いているブラウザーウィンドウに戻り、サイトを作成​をクリックします。

    サイト作成者は、ストアフロントのボイラープレートコンテンツをDocument Author環境にコピーします。 このプロセスには1~2分かかります。

手順3:プロジェクトリンクの保存

  1. 「サイトの詳細」セクションで、ストアフロントプロジェクトのリンクを確認します。

    Storefront setup complete {width="700" modal="regular"}

    これらのリンクを使用して、ストアフロントコード、コンテンツ、設定を管理します。

  2. 将来の参照のために、これらのリンクをコピーして保存します:**Copyをクリックします。

ストアフロントの設定

ストアフロント設定を更新して、Adobe Commerce Optimizer インスタンスに接続します。

  1. config.json ファイルをボイラープレートコードリポジトリで開きます。

    https://github.com/<username or org>/<repo name>/config.json

  2. 設定のcs (カタログサービス)セクションを探します。

  3. プレースホルダーの値をインスタンスの値に置き換えます。 前提条件を参照してください。

    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を確認して、割り当てられた価格表を確認します。 価格表が割り当てられていない場合は、このヘッダーを設定ファイルから削除できます。 価格表がカタログ ビューに割り当てられたときに再度追加します。
  4. 設定ファイルを保存します。

    設定の変更が反映されるまでに数分かかる場合があります。 データがすぐに表示されない場合は、トラブルシューティングの2~3分前に待ってください。

設定を確認

ストアフロントをテストして、Adobe Commerce Optimizer インスタンスに正しく接続されていることを確認します。

ステップ 1:ストアフロントホームページを表示する

  1. ライブプレビューURLに移動します。

    https://main--{SITE}--{ORG}.aem.live

    {ORG}{SITE}をGitHub組織とサイト名に置き換えます。

  2. 成功基準:定型文のコンテンツを含むストアフロントのホームページが表示されます。

    ACO storefront site with boilerplate {width="700" modal="regular"}

ステップ 2:商品詳細ページのテスト

デフォルトの製品詳細ページを表示して、製品データが正しく読み込まれていることを確認します。

  1. サンプル製品ページに移動します。
    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を表示します。
  2. 成功基準: ページに次の情報を表示する必要があります:

    • 製品名、説明、価格
    • 製品画像
    • カートに追加機能
    • Adobe Commerce Optimizer インスタンスから取得したデータ

    Default product detail page showing a product from the sample data {width="700" modal="regular"}

手順3:デフォルトの検索機能をテストする

検索やフィルタリングなど、商品のデフォルト機能をテストできます。

  1. ストアフロントのホームページで、ヘッダーの虫眼鏡アイコンをクリックします。

  2. 検索文字列tiresを入力し、Enter​を押します。

  3. 成功基準:次が表示されます。

    • タイヤ商品の検索結果ページ
    • サイドバーのフィルターオプション
    • 画像と価格設定が掲載された商品リスト

    View search results page {width="675" modal="regular"}

  4. 任意のタイヤ製品をクリックして、その詳細ページを表示します。

    View product details page {width="675" modal="regular"}

トラブルシューティング

設定中に問題が発生した場合は、web ページインスペクターコンソールを使用してエラーを確認します。 また、ブラウザーのキャッシュをクリアするか、別のブラウザーを使用してみてください。

一般的な問題を確認するには、次のガイダンスを使用します。

一般的な問題

イシュー
症状
Solution
Code Syncのインストールに失敗しました
Code Sync設定を完了できません
  • GitHub組織への管理者アクセス権があることを確認します。
  • 組織の代わりに個人リポジトリを使用してみてください。
  • GitHub権限を確認して、もう一度試してください。
サイトが読み込まれていません
404または接続エラー
  • サイト 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で、ストアフロントヘッダー設定で使用したポリシー、ロケール、価格表の設定を確認します。
  • 属性メタデータ設定が検索用に正しく設定されていることを確認します。

検証チェックリスト

次の手順に進む前に、次の点を確認して、ストアフロントが正しく機能していることを確認します。

チェックリスト 設定値がインスタンス設定
と一致しています
チェックリスト ストアフロントのホームページがエラーなく読み込まれる

チェックリスト 少なくとも1つの製品詳細ページに完全な情報が表示される

チェックリスト 検索機能が関連する結果を返します

チェックリスト 製品画像が正しく読み込まれています

チェックリスト 設定値がインスタンス設定と一致しています

ヘルプを表示

問題が解決しない場合:

次のステップ

  • ローカル開発環境の設定 – ローカル環境を作成して、ストアフロントコードとコンテンツをカスタマイズします。
  • ユニバーサルエディターを有効にする- ユニバーサルエディターを使用すると、レンダリングされたページのコンテキストでストアフロントコンテンツを編集できます。 コンテンツはドキュメント作成(DA.live)プロジェクトに保存され、ローカライゼーション、一括公開、スナップショットなど、ほとんどのコンテンツオーケストレーションアプリを使用できます。

学習と探索

recommendation-more-help
1306ca2c-2841-4cc0-addb-6199acf1ad34