[PaaS のみ]{class="badge informative" title="Adobe Commerce on Cloud プロジェクト(Adobeが管理する PaaS インフラストラクチャ)およびオンプレミスプロジェクトにのみ適用されます。"}

Adobe CommerceのデータをAdobe Experience Platformに接続する

Data Connection拡張機能をインストールすると、Commerce 管理者​の​ サービス ​の​システム メニューに2つの新しい設定ページが表示されます。

  • Commerce Services Connector
  • Data Connection

Adobe Commerce インスタンスをAdobe Experience Platformに接続するには、両方のコネクタを設定する必要があります。Commerce Services コネクタから始めて、Data Connection拡張機能で終了します。

Commerce サービスコネクタの設定

以前にAdobe Commerce サービスをインストールしたことがある場合は、Commerce サービスコネクタが既に設定されている可能性があります。 そうでない場合は、Commerce Services コネクタ ​ ページで次のタスクを実行する必要があります。

  1. Commerce アカウントにログインして実稼動およびサンドボックス API キーを取得します。
  2. SaaS データスペース ​を選択します。
  3. Adobe アカウントにログインして組織IDを取得します。

Commerce サービス コネクタを構成したら、次にData Connection拡張機能を構成します。

Data Connection拡張機能の設定

この節では、Data Connection拡張機能の設定方法について説明します。

サービスアカウントと資格情報の詳細の追加

過去の注文データ ​または顧客プロファイルデータ ​を収集して送信する場合は、サービスアカウントと資格情報の詳細を追加する必要があります。 また、Audience Activation拡張機能を設定する場合は、次の手順を実行する必要があります。

ストアフロントまたはバックオフィスのデータのみを収集して送信する場合は、general セクションにスキップできます。

手順1:Adobe Developer Consoleでのプロジェクトの作成

Commerceを認証するプロジェクトをAdobe Developer Consoleで作成し、Experience Platform API呼び出しを行えるようにします。

プロジェクトを作成するには、認証してExperience Platform APIにアクセス ​ チュートリアルで説明されている手順に従います。

チュートリアルを進める際には、プロジェクトに次の要素が含まれていることを確認します。

  • 次の製品プロファイル ​へのアクセス:既定の実稼動環境のすべてのアクセス​および​AEP既定のすべてのアクセス
  • 正しい役割と権限が設定されています
  • サーバー間の認証方法としてJSON Web Tokens (JWT)を使用することを決定した場合は、秘密鍵もアップロードする必要があります。

この手順の結果、次の手順で使用する設定ファイルが作成されます。

手順2:設定ファイルのダウンロード

​ ワークスペース設定ファイル ​をダウンロードします。 <workspace-name>.json ファイルには、Commerce管理者の​サービスアカウント/資格情報の詳細 ページに入力する必要があるすべての値が含まれています。

Data Connection管理者設定 {width="700" modal="regular"}

  1. Commerce管理者で、Stores/Settings > Configuration > Services > Data Connection​に移動します。

  2. Adobe Developer Authorization Type メニューから実装したサーバー間の認証メソッドを選択します。 Adobeでは、OAuthを使用することをお勧めします。 学習を増やす

  3. <workspace-name>.json ファイルの内容を​サービスアカウント/資格情報の詳細 フィールド("client_id""client_secrets""technical_account_email""technical_account_id"など)にコピーします。

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

  5. Test connection」ボタンをクリックして、入力したサービスアカウントと資格情報が正しいことを確認します。

一般

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

    Data Connection設定 {width="700" modal="regular"}

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

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

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

    note note
    NOTE
    独自のAEP Web SDKを指定した場合、Data Connection拡張機能は、このページで指定されたデータストリーム IDではなく、そのSDKに関連付けられたデータストリーム IDを使用します(存在する場合)。

データ収集

このセクションでは、収集してExperience Platform エッジに送信するデータのタイプを指定します。 データには3つの種類があります。

  • 行動 (クライアント側データ)は、ストアフロントに取り込まれたデータです。 これには、View PageView ProductAdd to Cart要求リスト ​など、買い物客とのやり取りが含まれます(B2B販売者の場合)。

  • バックオフィス (サーバーサイドデータ)は、Commerce サーバーにキャプチャされたデータです。 これには、注文の配送状況に関する情報(注文が行われた場合、キャンセルされた場合、返金された場合、発送された場合、完了した場合など)が含まれます。 また、過去の注文データ ​も含まれます。

  • プロファイル​は、買い物客のプロファイル情報に関連するデータです。 詳細を学習します。

Adobe Commerce インスタンスでデータ収集を開始できるようにするには、前提条件を確認してください。

​ ストアフロント ​​ バックオフィス ​​ プロファイル ​のイベントについて詳しくは、イベントのトピックを参照してください。

NOTE
データ収集 セクションのすべてのフィールドは、Web サイト​以上のスコープに適用されます。
  1. ストアフロントの行動データを送信する場合は、ストアフロントイベント​を選択します。

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

    note note
    NOTE
    バックオフィスイベント​を選択すると、すべてのバックオフィスデータがExperience Platform エッジに送信されます。 買い物客がデータ収集をオプトアウトする場合は、Experience Platformで買い物客のプライバシー設定を明示的に設定する必要があります。 これは、コレクターが買い物客の好みにもとづいて同意を既に処理しているストアフロントイベントとは異なります。 Experience Platformでの買い物客のプライバシー設定について詳細を説明します。
  3. (独自のAEP Web SDKを使用している場合は、この手順をスキップしてください。) Adobe Experience Platformでデータストリームを作成するか、収集に使用する既存のデータストリームを選択します。 「データストリーム ID」フィールドにそのデータストリーム IDを入力します。

  4. Commerce データを含める​ データセット ID ​を入力します。 データセット IDを検索するには:

    1. Experience Platform UIを開き、左側のナビゲーションで「データセット」を選択して、データセット ダッシュボードを開きます。 ダッシュボードには、組織で使用可能なすべてのデータセットが一覧表示されます。 リストされた各データセットの詳細(名前、データセットが準拠するスキーマ、最新の取り込み実行のステータスなど)が表示されます。
    2. データストリームに関連付けられているデータセットを開きます。
    3. 右側のペインで、データセットの詳細を表示します。 データセット IDをコピーします。
  5. 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
      

フィールドの説明

フィールド
説明
範囲
設定設定を適用する特定のweb サイト。
組織ID (グローバル)
ADOBE DX製品を購入した組織に属するID。 このIDは、Adobe Commerce インスタンスをAdobe Experience Platformにリンクします。
AEP Web SDKは既にサイトにデプロイされていますか?
独自のAEP Web SDKをサイトにデプロイしている場合は、このチェックボックスをオンにします
AEP Web SDK名(グローバル)
既にExperience Platform Web SDKがサイトにデプロイされている場合は、このフィールドにそのSDKの名前を指定します。 これにより、Storefront Event CollectorとStorefront Event SDKは、Data Connection拡張機能によってデプロイされたバージョンではなく、Experience Platform Web SDKを使用できるようになります。 サイトにデプロイされたExperience Platform Web SDKがない場合は、このフィールドを空白のままにして、Data Connection拡張機能が1つをデプロイします。
ストアフロントイベント
組織IDとデータストリーム IDが有効である限り、はデフォルトでオンになっています。 ストアフロントイベントは、サイトを閲覧する顧客から匿名化された行動データを収集します。
バックオフィスイベント
チェックを入れた場合、イベントペイロードには、注文が行われた場合、キャンセルされた場合、返金された場合、または発送された場合など、匿名の注文ステータス情報が含まれます。
データストリーム ID (web サイト)
ADOBE EXPERIENCE PLATFORMから他のAdobe DX製品へのデータの流れを許可するID。 このIDは、特定のAdobe Commerce インスタンス内の特定のweb サイトに関連付ける必要があります。 独自のExperience Platform Web SDKを指定する場合は、このフィールドにデータストリーム IDを指定しないでください。 Data Connection拡張機能は、そのSDKに関連付けられたデータストリーム IDを使用し、このフィールドで指定されたデータストリーム IDを無視します(存在する場合)。
データセット ID (web サイト)
COMMERCE データを含むデータセットのID。 このフィールドは、ストアフロントイベント​または​ バックオフィスイベント ​のチェックボックスを選択解除しない限り必須です。 また、独自のExperience Platform Web SDKを使用しており、データストリーム IDを指定していない場合でも、データストリームに関連付けられているデータセット IDを追加する必要があります。 それ以外の場合は、このフォームを保存できません。

オンボーディングが完了すると、ストアフロントデータがExperience Platformエッジに流れ始めます。 バックオフィスデータは、エッジに表示されるまでに約5分かかります。 後続の更新は、cron スケジュールに基づいてエッジに表示されます。

顧客プロファイルデータの送信

Experience Platformに送信できるプロファイルデータには、プロファイルレコードと時系列プロファイルイベントの2種類があります。

プロファイルレコードには、買い物客がCommerce インスタンスでプロファイル(買い物客の名前など)を作成したときに保存されるデータが含まれます。 スキーマとデータセットが適切に設定されている場合、プロファイルレコードがExperience Platformに送信され、Adobeのプロファイル管理およびセグメント化サービス Real-Time CDPに転送されます。

時系列プロファイルイベントには、顧客のプロファイル情報に関するデータが含まれます。たとえば、顧客がサイトでアカウントを作成、編集、削除するかどうかも含まれます。 プロファイルイベントデータがExperience Platformに送信されると、他のDX製品で使用できるデータセットに格納されます。

  1. 提供された サービス アカウントと資格情報の詳細があることを確認してください。

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

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

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

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

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

プロファイルレコードがReal-Time CDPで使用可能になるまでに約10分かかります。 プロファイルイベントはすぐにストリーミングを開始します。

TIP
Experience Platformにプロファイルデータが表示されない場合は、Commerce KnowledgeBaseでトラブルシューティングの候補を参照してください。

フィールドの説明

フィールド
説明
顧客プロファイル
顧客プロファイルレコードを収集して送信する場合は、このチェックボックスを選択します。
プロファイルデータセット ID
プロファイルレコードでは、行動イベントやバックオフィスイベントに使用されるデータセットとは異なるデータセットを使用する必要があります。
同じデータストリーム IDを使用した顧客プロファイルのストリーム
現在、行動イベントやバックオフィスイベントに使用しているのと同じデータストリームを使用するかどうかを決定します。
顧客プロファイル用データストリーム
顧客プロファイルレコード固有のデータストリームを指定します。

過去の注文データを送信する

Adobe Commerceは、最大5年間の過去の注文データとステータス ​を収集します。 Data Connection拡張機能を使用して、その履歴データをExperience Platformに送信し、顧客プロファイルを強化し、過去の注文に基づいて顧客体験をパーソナライズできます。 データは、Experience Platform内のデータセットに保存されます。

Commerceは既に過去の注文データを収集していますが、そのデータをExperience Platformに送信するには、いくつかのステップを完了する必要があります。

このビデオでは、過去の注文について詳しく説明し、次の手順を完了して過去の注文収集を実装します。

Order Sync サービスの設定

注文同期サービスでは、​ メッセージキューフレームワーク ​とRabbitMQを使用しています。 これらの手順を完了すると、注文状況データをSaaSに同期できるようになります。これは、Experience Platformに送信する前に必要です。

  1. 提供された サービス アカウントと資格情報の詳細があることを確認してください。

  2. RabbitMQを有効にします。

    note note
    NOTE
    RabbitMQは、既にCommerce バージョン 2.4.7以降に設定されていますが、コンシューマーを有効にする必要があります。
  3. .magento.env.yaml環境変数を使用して、CRON_CONSUMERS_RUNNERのcron ジョブでメッセージキューコンシューマーを有効にします。

    code language-yaml
       stage:
         deploy:
           CRON_CONSUMERS_RUNNER:
             cron_run: true
    
    note note
    NOTE
    使用可能なすべての設定オプションについて詳しくは、変数のデプロイに関するドキュメント ​を参照してください。

注文同期サービスが有効になっている場合は、Data Connection ページで過去の注文日付範囲を指定できます。

注文履歴の日付範囲の指定

Experience Platformに送信する履歴オーダーの日付範囲を指定します。

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

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

    Data Connection注文履歴 {width="700" modal="regular"}

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

  4. 差出人​および​差出人 フィールドで、送信する履歴注文データの日付範囲を指定します。 5年を超える日付範囲は選択できません。

  5. Start Sync​を選択して同期をトリガーし、開始します。 過去の注文データは、ストアフロントやバックオフィスのデータがストリーミングされるのではなく、バッチデータです。 バッチ処理は、Experience Platformに到着するまでに約45分かかります。

フィールドの説明
フィールド
説明
設定からデータセット IDをコピー
設定」タブで入力したデータセット IDをコピーします。
データセット ID (web サイト)
COMMERCE データを含むデータセットのID。 このフィールドは、ストアフロントイベント​または​ バックオフィスイベント ​のチェックボックスを選択解除しない限り必須です。 また、独自のExperience Platform Web SDKを使用しており、データストリーム IDを指定していない場合でも、データストリームに関連付けられているデータセット IDを追加する必要があります。 それ以外の場合は、このフォームを保存できません。
送信者
注文履歴データの収集を開始する日付。
注文履歴データの収集を終了する日付。
同期を開始
注文履歴データをExperience Platform エッジに同期するプロセスを開始します。 Dataset ID フィールドが空白であるか、データセット IDが無効な場合、このボタンは無効になります。

データのカスタマイズ

Data Customization」タブでは、Commerceで設定され、Experience Platformに送信されたカスタム属性を表示できます。

Data Connection データのカスタマイズ ​ {width="700" modal="regular"}

IMPORTANT
​ データ収集」タブで​ 指定したデータストリーム ID ​が、カスタム属性を取り込むためにスキーマにリンクされているIDと一致していることを確認します。

注文のカスタム属性を作成してExperience Platformに送信する場合、Commerceの属性名は、Experience PlatformのCommerce スキーマの属性名と一致する必要があります。 それらが一致しない場合、違いを特定するのは難しい場合があります。 名前が一致しない場合は、カスタム注文属性 テーブルを使用すると、問題の解決に役立ちます。

カスタム注文属性 テーブルは、Experience PlatformのCommerce バックオフィスとCommerce スキーマ間のカスタム注文属性の設定とマッピングを可視化します。 このテーブルでは、様々なソースの注文レベルと注文アイテムレベルのカスタム属性を表示できるため、欠落している属性や不整合している属性を簡単に特定できます。 また、データセット IDを表示して、ライブデータセットと過去のデータセットを区別できます。各データセットには、独自のカスタム属性を設定できます。

テーブル内のカスタム属性名の横に緑色のチェックマークが表示されない場合は、ソース内の属性名が一致していないことを示します。 1つのソースで属性名を修正すると、名前が一致したことを示す緑色のチェックマークが表示されます。

  • Experience Platformのスキーマで属性名が更新された場合は、「Data Customization」タブに設定を保存して、Experience Platform スキーマの変更をトリガーする必要があります。 この変更は、ボタンをクリックすると、 カスタム注文属性​Refresh テーブルに反映されます。
  • Commerceで属性名が更新された場合、カスタム注文属性 テーブルの名前を更新するには、注文イベントを生成する必要があります。 約60分で変更が反映されます。

カスタム属性を設定する方法について詳しくは、こちらを参照してください。

フィールドの説明

フィールド
説明
データセット
カスタム属性を含むデータセットが表示されます。 ライブデータセットと履歴データセットには、独自のカスタム属性を設定できます。
Adobe Commerce
Commerce バックオフィスで作成されたカスタム属性を表示します。
Experience Platform
Experience PlatformのCommerce スキーマで指定されたカスタム属性を表示します。
更新
Experience PlatformのCommerce スキーマからカスタム属性名を取得します。

イベントデータが収集されていることを確認する

Commerce ストアからデータが収集されていることを確認するには、Adobe Experience Platform debuggerを使用してCommerce サイトを調べます。 データが収集されていることを確認したら、作成した​ データセット ​からデータを返すクエリを実行して、ストアフロントとバックオフィスのイベントデータがエッジに表示されていることを確認できます。

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

    クエリエディター

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

    クエリを作成

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

    code language-sql
    SELECT * from `your_dataset_name` ORDER by TIMESTAMP DESC
    
  3. クエリの実行後、結果は​コンソール タブの横にある​結果 タブに表示されます。 このビューには、クエリの表形式の出力が表示されます。

    クエリエディター

この例では、commerce.productListAddscommerce.productViewsweb.webpagedetails.pageViewsなどのイベントデータが表示されています。 このビューでは、Commerce データがエッジに届いたことを確認できます。

期待した結果と異なる場合は、データセットを開き、失敗したバッチインポートを探します。 ​ バッチ インポートのトラブルシューティング ​の詳細をご覧ください。

Experience Platformにプロファイルデータが表示されることを確認する

Experience Platformにプロファイルデータが表示されない場合は、Commerce KnowledgeBaseでトラブルシューティングの候補を参照してください。

次のステップ

Commerce データがExperience Platform エッジに送信されると、Adobe Journey Optimizerなどの他のAdobe Experience Cloud製品で、そのデータを使用できます。 例えば、特定のイベントをリッスンするようにJourney Optimizerを設定し、そのイベントデータに基づいて、初めてのユーザーやカート放棄のトリガーメールを送信することができます。 Journey Optimizerで​ カスタマージャーニーを作成することにより、Commerce プラットフォームを拡張する方法について説明します。

recommendation-more-help
1dd1eb92-da61-46c0-8ff9-3831f21eb23e