ドキュメントCommerceはじめに

Commerce Admin とのExperience Cloud統合の設定

最終更新日： 2024年7月14日
  • トピック：

作成対象：

  • 初心者
  • 中級
  • 管理者
  • リーダー

Commerce Admin の統合エクスペリエンスおよびCommerce Events 拡張機能を使用するようにCommerce Experience Cloudを設定して、Commerce Admin とのアプリケーション統合を開始します。

前提条件

  • Adobe Commerceは、Adobe IMS認証を使用するように構成する必要がありす

  • アカウントのプロビジョニングと権限：管理者は、Experience Cloud統合を構成するための次のリソースにアクセスできる 🔗Adobeのビジネス・プロファイルを持っている必要があります。

    • Adobe Admin Console – 組織のAdobeユーザーおよび開発者アカウントを追加して管理します
    • Adobe Developer Console - App Builder プロジェクトを作成し、Adobe I/Oイベントサービスを使用するための接続資格情報とプロジェクト設定を生成するための開発者またはシステム管理者のアクセス権
    • クラウドインフラストラクチャプロジェクトのCommerce – 必要なモジュールをインストールし、Adobe Commerce CLI を使用してCommerce アプリケーションサーバーを設定します
    • Commerce管理者- ストア設定を更新し、Commerce ユーザーアカウントを管理します

設定の概要

統合を有効にするには、次のタスクを実行します。

  1. Commerce環境とアプリケーションの設定を確認します。

  2. Commerce Admin 統合エクスペリエンス拡張機能を有効にします。

  3. CommerceのAdobe I/Oイベントを設定する。

  4. 統合をテストします。

Commerce環境とアプリケーション設定の確認

Experience Cloudの統合を設定する前に、プロジェクトとCommerce アプリケーションが要件を満たしていることを確認します。

  1. ローカルワークステーションで、Commerce プロジェクトのプロジェクトディレクトリに移動します。

  2. Experience Cloudと統合するインスタンスの環境ブランチをチェックアウトします。

  3. Adobe IMSが有効になっていることを確認します。

    • Commerce アプリケーションサーバーに接続するには、環境に SSH アクセス URL を使用します。

    • コマンドラインから、Adobe Commerce CLI を使用して、IMS モジュールのステータスを確認します。

      bin/magento admin:adobe-ims:status

    モジュールが有効になっていない場合は IMS 統合プロジェクトの組織と資格情報を使用して有効にする。

  4. 管理者ユーザーがAdobe IDを使用してCommerce管理者にログインできることを確認します。

    • Commerceの管理者 URL に移動します。

    • ログインしている場合は、ログアウトします。

    • 管理者ユーザーがAdobe IDを使用してログインするためにリダイレクトされていることを確認します。

      Adobe Commerce Adobe IDを使用してログイン

  5. ローカルワークステーションのクラウドプロジェクトディレクトリから、Commerce Admin Unified Experience 拡張機能がインストールされていることを確認します。

    composer show *unified-experience*

    拡張機能がインストールされている場合、Composer は拡張機能の名前と説明を返します。

    magento/module-unified-experience <version> Commerce module responsible for integration with Adobe Experience Cloud

    拡張機能がインストールされていない場合は、Composer を使用してインストールします。 次に、変更をコミットし、クラウド環境を再デプロイします。

    composer require magento/module-unified-experience
composer update

Commerce Admin Unified Experience を有効にする

Commerce Admin Unified Experience 拡張機能を有効にしてから、Experience Cloudを通じてログインします。

NOTE
これらの手順は、Commerce Cloudプロジェクト管理者がAdobe Commerce CLI を使用して拡張機能を有効にする方法を示しています。 Commerce管理者ユーザーは、Commerce ストアの設定を更新して、この拡張機能を有効にすることもできます。

  1. ローカルワークステーションのクラウドプロジェクト環境のルートディレクトリから、magento-cloud CLI ツールを使用して、Commerce アプリケーションサーバーにログインします。

    magento-cloud ssh

  2. Adobe Commerce CLI を使用して magento/module-unified-experience 拡張機能を有効にします。

    bin/magento config:set admin/unified_experience/enabled 1
Admin Unified Experience integration is enabled

  3. キャッシュをクリアします。

    bin/magento cache:clean

Commerce用のAdobe I/Oイベントの設定

Experience Cloud統合が有効な場合、Commerce プロジェクトへの管理者アクセスを管理するために、Adobe I/OイベントサービスはCommerce イベントデータをExperience Cloudに送信します。 サービスを設定するには、Commerce拡張機能（magento/commerce-eventing）のAdobe I/Oイベントを有効にして、管理者でAdobe I/Oイベントサービスを設定する必要があります。

Commerce イベントを有効にする

Commerce Events 拡張機能（magento/commerce-eventing）を有効にして、カスタムイベントデータをCommerce アプリケーションからAdobe I/Oイベントサービスに送信します。

NOTE
Commerce 2.4.6 以降では、Commerce Events 拡張機能がデフォルトでインストールされます。 Commerce 2.4.5 を使用するCommerce プロジェクトの場合、最初に Composer を使用して 拡張機能をインストールしてから有効にします。

  1. ローカルのCommerce プロジェクト開発環境で、.magento.env.yaml ファイルに次の設定を追加します。

    stage:
  global:
    ENABLE_EVENTING: true
  deploy:
    CRON_CONSUMERS_RUNNER:
      cron_run: true
      max_messages: 0
      consumers: []

  2. 更新された .magento.env.yaml file を追加、コミットおよびクラウド環境にデプロイします。

TIP
.magento.env.yaml ファイルを使用した環境変数の設定と管理について詳しくは、「 デプロイメント用の環境変数の設定を参照してください。

Commerce イベント統合の設定

次のタスクを実行して、Commerce イベントの統合を設定します。 手順について詳しくは、CommerceのAdobe I/Oイベント開発者向けドキュメントを参照してください。

  1. Commerce インスタンスからイベントデータを受け取る App Builder プロジェクトを作成します。

    Commerce Admin で統合を設定するには、App Builder プロジェクトの資格情報と設定データが必要です。

  2. Adobe I/Oイベントを使用するようにAdobe Commerceを設定します。

    • Adobe I/Oイベントサービスのストア設定を更新します。

    • イベントプロバイダーを設定して、Commerce イベントを送信する。

  3. Commerce インスタンスからイベントデータを受け取るようにApp Builder プロジェクトを更新します。

    Commerce インスタンスからイベントを登録または登録しないでください。 Commerce アプリケーションのイベントプロバイダーを設定すると、イベント登録がApp Builder プロジェクトにプッシュされます。

    イベントプロバイダーをApp Builder プロジェクトに接続したら、observer.uex_commerce_instance_update イベントを登録して変更内容を保存します。

  4. 接続を確立するには、イベント プロバイダーを通じて消費者にイベントを送信します。

    • ローカルクラウドプロジェクトディレクトリのコマンドラインから SSH を使用してCommerce アプリケーションサーバーに接続するを実行します。

      magento-cloud ssh

    • Adobe Commerce CLI を使用して、管理 Unified Experience 拡張機能のステータスを確認することで、イベントデータを送信します。

      bin/magento bin/magento admin:uex:status

統合のテスト

Commerce管理者がExperience Cloudにログインして使用可能なCommerce プロジェクトを表示し、各プロジェクトの管理者およびストアフロントにアクセスできることを確認します。

  1. Commerce インスタンスに関連付けられたAdobe IDと組織を使用して 🔗Experience Cloudにログイン します。

    Experience CloudのホームページからCommerce プロジェクトにアクセスする

  2. 「Commerce」を選択して、使用可能なCommerce プロジェクトを表示します。

    Experience Cloud用のCommerce プロジェクトワークスペース

  3. Open を選択して、インスタンスの管理者を開きます。

    Experience Cloud統合が有効になっているCommerce管理者ビュー

  4. 管理者タスクを期待どおりに実行できることを確認します。

    Commerce管理者のワークフローも、同じプロセスに従う必要があります。 Experience Cloud統合を有効にした後にワークフローの変更やエラーが発生した場合は、Commerce システム管理者または Adobeのサポートチケットを送信にお問い合わせください。

AdministratorExperience Cloudを設定したら、統合を通じてCommerce プロジェクトにアクセスできるようにExperience Cloudアカウントが正しくプロビジョニングされていることを確認します。 管理者ユーザーの管理を参照してください。

recommendation-more-help
31746fd0-1ead-45b5-9192-1aaf582c5f66