ストアフロントの設定
このガイドでは、Adobe Edge 配信サービスを使用して Adobe Commerce Optimizer インスタンスのストアフロントを設定する手順について説明します。 ストアフロントには、ボイラープレートコード、サンプルコンテンツ、製品詳細ページと製品検出(検索とフィルタリング)のサポートが含まれています。
完了までの推定時間: 30 ~ 45 分
前提条件
- リポジトリを作成でき、ローカル開発用に設定されている GitHub アカウント (github.com)
- サンプルデータ Adobe Commerce Optimizer設定済みのカタログビューとポリシーを備えた インスタンス
- 設定手順については、 サンプルデータの追加 を参照してください。
必要なインスタンスデータ
開始する前に、Adobe Commerce Optimizer インスタンスから次の情報を収集します。
- テナント ID (インスタンス ID とも呼ばれます)
- インスタンスの詳細ページ から使用できます。
- お使いのインスタンスの GraphQL エンドポイント
- インスタンスの詳細ページ から使用できます。
- グローバル カタログ ビューの カタログ ビュー ID
- カタログの詳細ページ から使用できます
- カタログビューの 0}Source ロケール }
- サンプルデータのデフォルトは
en_US
です
- サンプルデータのデフォルトは
ステップの設定
-
ストアフロントプロジェクトを作成 - サイト作成ツール を使用して、ボイラープレートコード、サンプルコンテンツ、設定ファイルを含む新しいストアフロントプロジェクトを作成します。
-
ストアフロント設定のカスタマイズ - リポジトリの
config.json
ファイルを更新して、Adobe Commerce Optimizer インスタンスに接続します。 -
設定を確認してください (10 分)
- ストアフロントサイトのプレビュー
- 製品詳細ページと検索機能のテスト
ストアフロントプロジェクトの作成
Site Creator ツールは、次のコンポーネントを含む完全なストアフロントプロジェクトを作成します。
- サイト:ボイラープレートコンテンツを含んだストアフロントのランディングページ
- コード:ボイラープレートソースファイルを含むリポジトリ
- コンテンツ:サイトコンテンツファイルを含むドキュメントオーサー環境
- Commerce設定: インスタンス固有の設定用の
config.json
ファイル
手順 1:プロジェクトの生成
-
サイト作成ツール を開きます。
-
「新しいサイトを作成(コードとコンテンツ)」を選択します。
-
サイト設定を完了します。
- GitHub 組織/ユーザー名:GitHub のユーザー名または組織名を入力します
- サイト名:ストアフロントのわかりやすい名前を選択します
- Commerce GraphQL エンドポイント(オプション):お使いの Adobe Commerce Optimizer インスタンスのGraphQL エンドポイントを入力します
-
サイトを作成 をクリックして、ストアフロントのボイラープレートコードを使用して GitHub リポジトリを作成します。
リポジトリが作成されると、サイト作成者が更新され、コード同期アプリをインストールするように求められます。
手順 2:コード同期アプリのインストール
-
「Install AEM Code Sync App」をクリックして、コード同期インストーラーを新しいタブで開きます。
-
コード同期アプリを設定します。
- GitHub 組織を選択し、「Configure」をクリックします。
- コード同期インターフェイスで、「同期」をクリック Only select repositories ます。
- Select repositories メニューをクリックし、作成したストアフロントコードリポジトリを選択します。
- 「Save」をクリックしてリポジトリを登録します。
-
サイト作成者が開いているブラウザーウィンドウに戻り、「サイトを作成」をクリックします。
Site Creator は、ストアフロントのボイラープレートコンテンツをドキュメントオーサー環境にコピーします。 このプロセスには 1~2 分かかります。
手順 3:プロジェクトリンクの保存
-
「サイトの詳細」セクションで、ストアフロントプロジェクトのリンクを確認します。
これらのリンクを使用して、ストアフロントのコード、コンテンツ、設定を管理します。
-
今後の参照用に、これらのリンクをコピーして保存します。**Copy をクリックします。
ストアフロントの設定
ストアフロント設定を更新して、Adobe Commerce Optimizer インスタンスに接続します。
-
先ほど保存したリンクを使用して Configuration Manager を開きます。
https://da.live/sheet#/<username or org>/<repo name>/config.json
-
設定で
cs
(カタログサービス)」セクションを見つけます。 -
プレースホルダーの値をインスタンスの値に置き換えます。 前提条件 を参照してください。
code language-json "cs": { "AC-View-ID": "{catalogViewId}", "AC-Environment-ID": "{tenantId}", "AC-Source-Locale": "en_US" }
-
設定ファイルを保存します。
設定を確認
ストアフロントをテストし、Adobe Commerce Optimizer インスタンスに正しく接続されていることを確認します。
手順 1:ストアフロントのホームページを表示する
-
ライブプレビュー URL に移動します。
https://main--{SITE}--{ORG}.aem.live
{ORG}
と{SITE}
を GitHub の組織とサイト名に置き換えます。 -
成功基準:ボイラープレートコンテンツが含まれたストアフロントのホームページが表示されます。
手順 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 インスタンスから取得したデータ
手順 3:デフォルトの検索機能のテスト
検索やフィルタリングを含む、デフォルトの製品機能をテストする。
-
店頭ホームページで、ヘッダーの虫眼鏡アイコンをクリックします。
-
検索文字列
tires
を入力し、Enter キーを押します。 -
成功基準:次が表示されます。
- タイヤ製品の検索結果ページ
- サイドバーのフィルタリングオプション
- 画像と価格を含む製品リスト
-
タイヤ製品をクリックすると、詳細ページが表示されます。
トラブルシューティング
セットアップ中に問題が発生した場合は、web ページ検査コンソールを使用してエラーを確認します。 また、ブラウザーのキャッシュをクリアするか、別のブラウザーを使用してみてください。
一般的な問題を確認するには、次のガイダンスを使用します。
よくある問題
- GitHub 組織に管理者アクセス権があることを確認します。
- 組織ではなく個人用リポジトリを使用してみてください。
- GitHub の権限を確認して、もう一度試してください。
- サイトの 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で、ストアフロントのヘッダー設定で使用したポリシー、ロケール、価格台帳の設定を確認します。
- 属性メタデータ設定 が検索に対して正しく設定されていることを確認します。
検証チェックリスト
次の手順に進む前に、次の点を確認して、ストアフロントが正常に機能していることを確認します。
ヘルプを表示
問題が解決しない場合:
次の手順
ストアフロントを設定して検証すると、次の操作を実行できます。
-
Sidekickのインストール - Web サイトから直接コンテンツを編集、プレビュー、公開するためのブラウザー拡張機能
-
ローカル開発環境の設定 - ストアフロントコードとコンテンツをカスタマイズするローカル環境を作成します
の学習と探索
-
エンドツーエンドの使用例を完了 - Adobe Commerce Optimizer を使用したストアフロントのセットアップとカタログ管理の詳細
-
ストアフロントのカスタマイズの詳細 – 高度なセットアップと設定オプションについて説明します
-
Commerce ドロップダウンを使用してストアフロントのエクスペリエンスをカスタマイズ 事前定義済みコンポーネントを追加して、ストアフロントのエクスペリエンスを強化