ハイブリッド実装向け Einstein アクティビティ

Reports & Dashboards を使用すると、B2C Commerce データに基づいて、時系列での傾向を把握し、より的確なビジネス上の意思決定を行うことができます。

Reports & Dashboards の分析は、Web アダプターのログまたは Einstein Activities API からのみ取得できます。デフォルトでは、SFRA と SiteGenesis の分析データは Web アダプターのログに保存され、PWA Kit は分析データを Einstein Activities API に送信します。

PWA Kit によって提供されるページと、SFRA または SiteGenesis によって提供されるページが混在するハイブリッド実装ガイダンスを進めていて、サイト全体で Reports & Dashboards を使用したい場合は、Einstein Activities API を使用するように SFRA または SiteGenesis の実装を更新する必要があります。これにより、買い物客が PWA Kit、SFRA、SiteGenesis のいずれを利用しているかにかかわらず、API で買い物客体験全体を取得できるようになります。

このページ内のリンクには、既存のお客様のみがアクセスできるものがあります。Commerce Cloud リポジトリにアクセスする方法については Salesforce Commerce Cloud GitHub リポジトリとアクセスを参照してください。

このガイドでは Einstein Activities API を SFRA の注文手続きに統合する方法を説明します。これにより、PWA Kit の注文手続きと同じアクティビティを送信できるようになります。

段階的なロールアウトで、SFRA または SiteGenesis 上に分析データを Web アダプターのログに送信するページが追加されている場合は、それらのページについても、このガイドで説明されているプロセスと同様の手順を実行できます。Retail React App の対応するページを確認し、どのアクティビティが送信されているかを確認してください。その後、SFRA または SiteGenesis ページで同じアクティビティを送信する必要があります。参考として、この Einstein アクティビティの概要では、それらのアクティビティをどこで使用することが想定されているかが示されています。

SiteGenesis とコンポーザブルストアフロントを組み合わせた実装は、公式にはサポートされていません。

提供されているコード例を統合する場合はよく注意を払い、本番環境にプッシュする前に必ずコードを徹底的にテストしてください。

既存のコードに追加する行には加算 (+) 記号が付けられ、削除する行には減算 (-) 記号が付いています。

このチュートリアルのコマンドを実行する前に、プレースホルダーを実際の値に置き換えてください。プレースホルダーは、$PLACEHOLDER のような形式で記載されています。

まず注文手続きコントローラーを更新して、現在の買い物カゴ ID を含めます。

注文手続きに使用する ISML テンプレートを更新します。この変更により、買い物カゴ ID、商品項目、合計金額がブラウザー上で利用できるようになります。

ヘルパー関数を含む js/einsteinHelpers.js という名前の JavaScript ファイルを作成します。

プレースホルダー $YOUR_SITE_ID$YOUR_CLIENT_ID を必ず実際の値に置き換えてください。

checkout.js のスクリプトを更新してアクティビティを記録します。次の require() 呼び出しを注文手続きスクリプトの先頭に追加する必要があり、既存の import がある場合は、その後に記述してください。

注文手続きステージが変更されたときに checkoutStep アクティビティをトリガーします。次のコードを updateUrl メソッドの末尾に追加します。

updateUrl メソッドで checkoutStep アクティビティをトリガーすると、ある注文手続きのステージから次の (または前の) ステージへのすべての遷移が追跡されます。

注文手続きコードの initialize 関数の末尾で、beginCheckout アクティビティをトリガーします。

beginCheckout アクティビティは、注文手続き中のページ読み込みごとに 1 回だけトリガーされます。アクティビティデータの準備は自動的に処理されます。

以上で完了です。Einstein アクティビティと SFRA の注文手続きの統合は正常に完了しました。Reports & Dashboards の設定を完了するには、Reports & Dashboards の手順を実施してください。