ドキュメントCommerceAdobe Commerce 向けサービス

Commerce Services Connector

Last update: Tue Jul 30 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • 管理者
  • ユーザー

Adobe CommerceとMagento Open Sourceの一部の機能は Commerce Services を利用し、SaaS （software as a service）としてデプロイされます。 これらのサービスを使用するには、実稼動およびサンドボックス API キーを使用して Commerce インスタンスを接続し、configuration でデータ領域を指定する必要があります。 接続の設定は、Commerce インスタンスごとに 1 回だけ行う必要があります。

利用可能なサービス availableservices

Commerce Services Connector からアクセスできる Commerce の機能は次のとおりです。

サービス
対象
Product Recommendations powered by Adobe Sensei
Adobe Commerce
Live Search powered by Adobe Sensei
Adobe Commerce
Payment Services
Adobe CommerceとMagento Open Source
Site-Wide Analysis Tool
Adobe Commerce
Catalog Service
Adobe Commerce
Data Connection
Adobe Commerce

アーキテクチャ

大まかに言えば、Commerce Services Connector は次のコア要素で構成されています。

Commerce サービスコネクタのアーキテクチャ

次のセクションでは、これらの各要素について詳しく説明します。

資格情報 apikey

実稼働およびサンドボックスの API キーは、 ライセンス所有者の Commerce アカウントから生成されます。 Commerce アカウントは、一意の Commerce ID （MageID）で識別されます。 アカウントが有効である限り、販売代理店のライセンス所有者は、Product Recommendationsや Live Search などのサービスの API キーを生成できます。

キーは、ライセンス所有者の代わりにプロジェクトや環境を管理するシステムインテグレーターまたは開発チームと、「必要な情報」ベースで共有できます。 ライセンス所有者から Shared Access を付与された開発者は、マーチャントの組織がアカウントの Switch Accounts ドロップダウンに存在する場合でも、自分の代わりにキーを生成することはできません。

さらに、ソリューションインテグレーターは Commerce Services も使用できます。 ソリューションインテグレーターの場合は、Commerce パートナー契約の署名者が API キーを生成する必要があります。

NOTE
ライセンスオーナーは通常、Adobe Commerce アカウントのプライマリ連絡先であり、クラウドインフラストラクチャプロジェクトにおけるAdobe Commerceのプロジェクトオーナーと同じでないことがあります。

実稼動およびサンドボックス API キーの生成 genapikey

  1. Commerce アカウント（https://account.magento.com{:target="_blank"}）にログインします。

  2. 「Magento」タブで、サイドバーの API ポータル を選択します。

  3. 環境 メニューから、「実稼動」または「サンドボックス」を選択します。

  4. API キー セクションに名前を入力し、新規追加 をクリックして、新しいキーをダウンロードするためのダイアログを開きます。

    秘密鍵のダウンロード

    note warning
    WARNING
    このダイアログでは、キーのコピーまたはダウンロードが必要になる唯一の機会を提供します。

  5. 「ダウンロード」をクリックし、「キャンセル」をクリックします。

  6. 各環境（実稼動環境とサンドボックス）で上記の手順を繰り返します。

    API キー セクションに API （公開）キーが表示されるようになりました。 SaaS プロジェクトを選択または作成する場合は、実稼動用キーとサンドボックス用キー（公開+秘密）の両方が必要です。

SaaS 設定 saasenv

Commerce インスタンスは、データを適切な場所に送信できるように、SaaS プロジェクトと SaaS データ領域を使用して設定する必要が Commerce Services ります。 SaaS プロジェクトは、すべての SaaS データ スペースをグループ化します。 SaaS データ スペースは、Commerce Services ーザーが作業できるようにするデータの収集および保存に使用されます。 このデータの一部は Commerce インスタンスから書き出され、一部はストアフロントの買い物客の行動から収集される場合があります。 そのデータは、セキュリティで保護されたクラウドストレージに保持されます。

Product Recommendations えば、SaaS データ スペースには、カタログと行動データが含まれています。 Commerce 設定で 選択することにより、Commerce インスタンスを SaaS データ空間にポイントできます。

WARNING
データの競合を避けるために、実稼動 Commerce ースのインストールにのみ実稼動 SaaS データ領域を使用します。 そうしないと、テストデータで実稼動サイトデータが汚染され、デプロイメントの遅延が発生するリスクがあります。 例えば、実稼動製品のデータが、ステージング URL などのステージングデータと誤って上書きされる可能性があります。

SaaS データ領域のプロビジョニング

すべてのマーチャントは、SaaS プロジェクトごとに 1 つの実稼動データスペースと 2 つのテストデータスペースにアクセスできます。 複数のステージング環境を使用するAdobe Commerce Cloud Pro プロジェクトの場合は、 サポートリクエストを送信することで、ステージング環境ごとに追加のテストデータスペースをリクエストできます。

SaaS プロジェクトの選択または作成 createsaasenv

SaaS プロジェクトを選択または作成するには、ストアの Commerce ライセンス所有者に Commerce API キーをリクエストします。

NOTE
Commerce の設定に Commerce Services Connector のセクションが表示されない場合は、目的の Commerce サービスに Commerce モジュールをインストールする必要があります。

  1. 管理者 サイドバーで、システム/サービス/Commerce サービスコネクタ に移動します。

    Commerce の設定に Commerce Services Connector のセクションが表示されない場合は、目的の Commerce サービスに Commerce モジュールをインストールします。 また、magento/module-services-id パッケージがインストールされていることを確認します。

  2. Sandbox API Keys ​セクションと​ Production API Keys セクションに、キー値を貼り付けます。

    秘密鍵は、鍵の先頭に ----BEGIN PRIVATE KEY---、鍵の末尾に ----END PRIVATE KEY---- を含める必要があります。

  3. 保存 をクリックします。

キーに関連付けられている SaaS プロジェクトは、[SaaS Identifier] セクションの [プロジェクト] フィールドに表示されます。

  1. SaaS プロジェクトが存在しない場合は、[プロジェクトの作成] をクリックします。 次に、プロジェクト フィールドに、SaaS プロジェクトの名前を入力します。

  2. Commerce ストアの現在の設定に使用する データスペース を選択します。

NOTE
Commerce サービスと統合するための個別のインスタンスがある場合は、 サポートチケットを送信して、追加のインスタンスごとに新しい SaaS プロジェクトをリクエストします。 サポートが SaaS プロジェクトを作成したら、同じ API キーを使用してインスタンスのCommerce Services 統合を設定し、データ空間用の新しい SaaS プロジェクトを選択します。
WARNING
マイアカウントの API ポータルセクションで新しいキーを生成した場合、直ちに管理設定の API キーを更新します。 新しいキーを生成し、管理者でそれらを更新しない場合、SaaS 拡張機能は機能しなくなり、貴重なデータが失われます。

SaaS プロジェクトまたはデータ領域の名前を変更するには、どちらかの横にある 名前の変更 をクリックします。 名前を変更しても、サービスには影響しません。名前は、プロジェクトとデータ スペースを識別および区別するのに役立つラベルにすぎないからです。

IMS 組織（オプション） organizationid

Adobe Commerce インスタンスをAdobe Experience Platformに接続するには、Adobe IDを使用してAdobeアカウントにログインします。 ログインすると、Adobeアカウントに関連付けられた IMS 組織がこのセクションに表示されます。

SaaS データのエクスポート

Commerce インスタンスが Commerce Services に正常に接続されると、SaaS データ書き出しプロセスによって、Commerce データが Commerce サーバーから Commerce SaaS Services に書き出され、接続されたCommerce Services に同期できるようになります。 管理者では、 データ管理ダッシュボードを使用して、同期ステータスを確認できます。 詳細については、「SaaS データ書き出しガイド」を参照してください。

recommendation-more-help
3d5a1200-3287-4b90-a075-6c594f65d80e