Commerce データのAdobe Experience Platformへの接続

Commerce管理者で、ストア/設定/設定/サービス/Data Connection に移動します。

実装したサーバー間認証方法を Adobe Developer認証タイプ メニューから選択します。 Adobeでは、OAuth を使用することをお勧めします。 JWT は非推奨（廃止予定）になりました。 詳細情報。

（JWT のみ） private.key ファイルの内容をコピーして、「クライアントの秘密鍵」フィールドに貼り付けます。 次のコマンドを使用して、コンテンツをコピーします。

cat config/private.key | pbcopy

private.key ファイルについて詳しくは、 サービスアカウント（JWT）認証を参照してください。

<workspace-name>.json ファイルの内容を「サービスアカウント /資格情報の詳細」フィールドにコピーします。

{width="700" modal="regular"}

「設定を保存」をクリックします。

[Test connection] ボタンをクリックし、入力したサービス アカウントと認証情報が正しいことを確認します。

管理者で、システム/サービス/Data Connection に移動します。

{width="700" modal="regular"}

一般 の下の 設定 タブで、Commerce サービスコネクタで設定されているように、Adobe Experience Platform アカウントに関連付けられている ID を確認します。 組織 ID はグローバルです。 Adobe Commerce インスタンスごとに関連付けることができる組織 ID は 1 つだけです。

範囲 ドロップダウンで、コンテキストを Web サイト に設定します。

（オプション） AEP Web SDK （alloy）が既にサイトにデプロイされている場合は、このチェックボックスを有効にして、AEP Web SDK の名前を追加します。 それ以外の場合は、これらのフィールドを空白のままにすると、Data Connection 拡張機能によって自動的にデプロイされます。

ストアフロントの行動データを送信する場合は、「ストアフロントイベント」を選択します。

注文が行われた、キャンセルされた、返金された、発送されたかなど、注文ステータス情報を送信する場合は、バックオフィスイベント を選択します。

（独自の AEP Web SDK を使用している場合は、この手順をスキップします）。 作成Adobe Experience Platformのデータストリーム、または収集に使用する既存のデータストリームを選択します。 そのデータストリーム ID を データストリーム ID フィールドに入力します。

Commerce データを格納する データセット ID を入力します。 データセット ID を見つけるには：

1. Experience PlatformUI を開き、左側のナビゲーションで データセット を選択して データセット ダッシュボードを開きます。 ダッシュボードには、組織で使用可能なすべてのデータセットが一覧表示されます。 リストに表示された各データセットに関する詳細（名前、データセットが準拠するスキーマ、最新の取得実行のステータスなど）が表示されます。
2. データストリームに関連付けられたデータセットを開きます。
3. 右側のパネルで、データセットに関する詳細を表示します。 データセット ID をコピーします。

cron ジョブに従ってスケジュールに基づいてバックオフィスイベントデータが確実に更新されるようにするには、Sales Orders Feed インデックスを Update by Schedule に変更する必要があります。

1. 管理者 サイドバーで、System/Tools/Index Management ​に移動します。

2. Sales Orders Feed インデクサーのチェックボックスを選択します。

3. Actions を Update by Schedule に設定します。

4. 初めてバックオフィスのデータを有効にする場合は、次のコマンドを実行して再インデックスを実行し、再同期をトリガーします。 cron ジョブが正しく設定されている限り、それ以降の再同期は自動的に実行されます。

   code language-bash
   bin/magento index:reindex sales_order_data_exporter_v2

   code language-bash
   bin/magento saas:resync --feed orders

サービスアカウントと資格情報の詳細が 指定されていることを確認します。

プロファイルレコードデータの取り込みおよび 時系列プロファイルイベントデータの取り込み用にスキーマとデータセットが指定されていることを確認します。

プロファイルデータをExperience Platformに送信する場合は、「顧客プロファイル」チェックボックスにチェックマークを付けます。

プロファイルデータセット ID を入力します。

プロファイルレコードデータでは、行動およびバックオフィスイベントデータに現在使用しているデータセットとは異なるデータセットを使用する必要があります。

行動データとバックオフィスデータに使用しているものと同じデータストリーム ID でプロファイルイベントをストリーミングしない場合は、同じデータストリーム ID で顧客プロファイルをストリーミングする のチェックマークを削除し、代わりに使用するデータストリーム ID を入力します。

サービスアカウントと資格情報の詳細が 指定されていることを確認します。

有効にするRabbitMQ。

環境変数を使用して、.magento.env.yaml の cron ジョブでメッセージキューコンシューマー CRON_CONSUMERS_RUNNER 有効にします。

   stage:
     deploy:
       CRON_CONSUMERS_RUNNER:
         cron_run: true

管理者で、システム/サービス/Data Connection に移動します。

「注文履歴」タブを選択します。

{width="700" modal="regular"}

注文履歴の同期 で、「設定からデータセット ID をコピー」チェックボックスが既に有効になっています。 これにより、「設定 タブで指定したデータセットと同じデータセットを使用していることになります。

From および To フィールドで、送信する過去の注文データの日付範囲を指定します。 日付範囲は 5 年を超えることはできません。

「Start Sync」を選択すると、開始する同期がトリガーされます。 注文の履歴データは、ストリーミングデータであるストアフロントおよびバックオフィスデータとは対照的に、バッチデータです。 バッチ処理されたデータがExperience Platformに到着するまで約 45 分かかります。

Experience Platformの左側のナビゲーションで「クエリ」を選択し、「Create Query」をクリックします。

クエリエディターが開いたら、データセットからデータを選択するクエリを入力します。

例えば、クエリは次のようになります。

SELECT * from `your_dataset_name` ORDER by TIMESTAMP DESC

クエリを実行すると、結果が「コンソール タブの横の「結果 タブに表示されます。 このビューには、クエリの表形式出力が表示されます。