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

Commerce Admin で、に移動します。 ストア > 設定 > 設定 > サービス > Data Connection.

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

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

cat config/private.key | pbcopy

参照： サービスアカウント（JWT）認証 について private.key ファイル。

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

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

クリック 設定を保存.

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

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

が含まれる 範囲 ドロップダウンで、コンテキストをに設定 Web サイト.

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

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

を選択 バックオフィスイベント 注文が行われた、キャンセルされた、払い戻された、出荷されたかなど、注文ステータス情報を送信する場合。

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

を入力 データセット ID Commerce データを含める。 データセット ID を見つけるには：

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

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

1. 日 Admin サイドバー、に移動 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 を入力します。

次が揃っていることを確認します 提供 サービスアカウントと資格情報の詳細。

Enable （有効） RabbitMQ。

の cron ジョブによるメッセージキューコンシューマーの有効化 .magento.env.yaml 使用 CRON_CONSUMERS_RUNNER 環境変数。

   stage:
     deploy:
       CRON_CONSUMERS_RUNNER:
         cron_run: true

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

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

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

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

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

を選択 クエリ Experience Platformの左側のナビゲーションで、 Create Query.

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

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

SELECT * from `your_dataset_name` ORDER by TIMESTAMP DESC

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