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

ストアフロントの設定

このガイドでは、Adobe Edge 配信サービスを使用して 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 分)

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

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

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

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

手順 1:プロジェクトの生成

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

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

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

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

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

    リポジトリが作成されると、サイト作成者が更新され、コード同期アプリをインストールするように求められます。

手順 2:コード同期アプリのインストール

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

  2. コード同期アプリを設定します。

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

    Site Creator は、ストアフロントのボイラープレートコンテンツをドキュメントオーサー環境にコピーします。 このプロセスには 1~2 分かかります。

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

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

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

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

  2. 今後の参照用に、これらのリンクをコピーして保存します。**Copy をクリックします。

ストアフロントの設定

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

  1. 先ほど保存したリンクを使用して Configuration Manager を開きます。

    https://da.live/sheet#/<username or org>/<repo name>/config.json

  2. 設定で cs (カタログサービス)」セクションを見つけます。

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

    code language-json
    "cs": {
       "AC-View-ID": "{catalogViewId}",
       "AC-Environment-ID": "{tenantId}",
       "AC-Source-Locale": "en_US"
    }
    
  4. 設定ファイルを保存します。

NOTE
設定変更が反映されるまで数分かかる場合があります。 データがすぐに表示されない場合は、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 ページ検査コンソールを使用してエラーを確認します。 また、ブラウザーのキャッシュをクリアするか、別のブラウザーを使用してみてください。

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

よくある問題

問題
症状
解決策
コード同期のインストールに失敗
コード同期セットアップを完了できません
  • GitHub 組織に管理者アクセス権があることを確認します。
  • 組織ではなく個人用リポジトリを使用してみてください。
  • GitHub の権限を確認して、もう一度試してください。
サイトが読み込まれない
404 または接続エラー
  • サイトの URL 形式を確認してください:https://main--{SITE}--{ORG}.aem.live
  • コード同期アプリが正しくインストールされていることを確認します。
  • リポジトリが公開されているか、適切に設定されていることを確認します。
製品データが表示されません
製品ページにプレースホルダーまたはエラーが表示される
  • config.json で設定値を確認します。
  • Adobe Commerce Optimizer インスタンスで、データ同期ページをチェックして、サンプル製品が読み込まれていることを確認します。 使用できる製品がない場合は、サンプルデータを再読み込みするか、Data Ingestion API を使用して製品を追加します。 設定変更が反映されるまで数分待ちます。
  • ​ ファイルで設定されているのと同じヘッダーを使用して、マーチャンダイジングサービス ​ 製品クエリ config.json を使用して製品の詳細を取得してみてください。 データを取得できる場合は、カタログ表示の設定またはインデックスエラーの問題がある可能性があります。
検索で結果が返されない
空の検索結果ページ
  • ​ ファイルで設定されているのと同じヘッダーを使用して、マーチャンダイジングサービス ​productSearch クエリ config.json を使用して製品の検索結果を取得できることを確認します。 データを取得できる場合は、カタログ表示の設定またはインデックスエラーの問題がある可能性があります。
  • config.json ファイルのカタログ ビュー ID が Adobe Commerce Optimizer のカタログ ビュー ID と一致することを確認します。
  • Adobe Commerce Optimizerで、ストアフロントのヘッダー設定で使用したポリシー、ロケール、価格台帳の設定を確認します。
  • ​ 属性メタデータ設定 ​ が検索に対して正しく設定されていることを確認します。

検証チェックリスト

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

チェックリスト 設定値がインスタンス設定と一致する

チェックリスト ストアフロントのホームページがエラーなしで読み込まれる

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

チェックリスト 検索機能で関連する結果が返される

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

チェックリスト 設定値がインスタンス設定と一致する

ヘルプを表示

問題が解決しない場合:

次の手順

ストアフロントを設定して検証すると、次の操作を実行できます。

  1. Sidekickのインストール ​ - Web サイトから直接コンテンツを編集、プレビュー、公開するためのブラウザー拡張機能

  2. ローカル開発環境の設定 ​ - ストアフロントコードとコンテンツをカスタマイズするローカル環境を作成します

の学習と探索

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