ドキュメントCommerceOptimizer Connector

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

基本を学ぶ

最終更新日： 2026年6月1日

作成対象：

  • {"id":"b5a62a22-46f7-4f0d-b151-3fc640bef588"}
  • {"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

Adobe Commerce Optimizer Connectorをインストールして設定し、Adobe Commerce カタログデータをAdobe Commerce Optimizerと同期してから、データ同期ステータスを監視して、ストアフロントが最新であることを確認します。

IMPORTANT
サンドボックス Optimizer インスタンスは必ず実稼動以外の環境に、実稼動インスタンスは実稼動環境に接続してください。 環境が一致していないと、カタログデータ、検索結果、レコメンデーションに一貫性がなくなります。

統合の使用要件 requirements-to-use-the-integration

  • Adobe Commerce 2.4.7+

    • PHP 8.2、8.3、または8.4
    • Composer 2.x

  • プロビジョニングされたサンドボックスインスタンスを使用するCommerce Optimizer ライセンス。

  • Composerを使用してコネクタメタパッケージをダウンロードするための認証キー。

  • Commerce Optimizer サンドボックスインスタンス ​への管理者アクセス。

統合を構成するAdobe Commerce ユーザーには、次の要件が必要です。

競合する拡張機能の削除 remove-conflicting-extensions

次のいずれかの拡張機能がインストールされている場合は、Adobe Commerce Optimizer Connectorをインストールする前にアンインストールしてください。

  • Adobe Commerce Live Search (magento/live-search)
  • Adobe Commerce Product Recommendations (magento/product-recommendations)
  • Adobe Commerce Catalog Service (magento/catalog-service, magento/catalog-service-installer)
  • Data Management Dashboard (magento-catalog-sync-admin)

これらの拡張機能に関連付けられたデータは、引き続きCommerce データベースで使用できます。 ただし、コネクタが有効になっている場合は、Commerce Optimizerに書き出されません。 コネクタを有効にした後、これらの拡張機能によって提供される検索およびマーチャンダイジング機能を実装するには、Commerce Optimizer 管理UIからそれらを設定します。

IMPORTANT
コネクタを有効にする前にこれらの拡張機能が削除されない場合、接続済みサービスで拡張機能とコネクタが認証する方法の競合により、同じデータがコネクタと既存の拡張機能の両方から書き出されるため、設定画面が壊れ、Commerce Optimizerにデータが重複し、ログに401または403のエラーが発生する可能性があります。
style
shade-box

設定手順 configuration-steps

次の手順に従って、Adobe Commerce Optimizer Connectorを有効にし、Adobe CommerceからCommerce Optimizer インスタンスへのデータの同期を開始します。

  1. Composerを使用して Adobe Commerce Optimizer Connector パッケージ​をインストールし、Adobe Commerce インスタンスをCommerce Optimizerに接続します。

  2. 管理者からCommerce スコープの書き出し設定​をカスタマイズします。

  3. ​ Commerce Optimizer 統合​を有効にします。

  4. データ同期が機能していることを確認します。

Adobe Commerce Optimizer Connector パッケージのインストール install-the-adobe-commerce-optimizer-connector-package

Adobe Commerce Optimizer Connectorは、Commerce Optimizerのアクティブなライセンスを持つすべてのCommerce マーチャントが利用できるComposer メタパッケージとして配信されます。

インストール手順

  1. Composerを使用してadobe-commerce/commerce-data-export-aco-adapter モジュールを追加します。

    code language-shell 
    composer require adobe-commerce/commerce-data-export-aco-adapter

  2. Adobe Commerce ステージング環境に変更をデプロイします。

    デプロイメントが完了すると、Commerce Optimizer オプションがCommerce管理メニューから使用できるようになります。 「Commerce Optimizer」を選択して、Commerce管理者から直接Commerce Optimizer インスタンスを開きます。

NOTE
拡張機能のインストール手順について詳しくは、次のガイドを参照してください。
​ クラウドインフラストラクチャ ​の Adobe Commerce に拡張機能をインストールする
​ オンプレミス ​に拡張機能をインストールする Adobe Commerce

Commerce スコープ書き出し設定のカスタマイズ customize-the-commerce-scopes-export-configuration

デフォルトでは、すべてのCommerce スコープ（web サイト、カスタマーグループ、ストアビュー）でカタログデータの同期が有効になっています。 ビジネスニーズに基づいて、特定の範囲のデータのみを同期するように書き出し設定をカスタマイズできます。 例えば、同じ言語を共有する複数のストアビューがある場合、ストアビューの1つだけのデータを書き出し、Commerce Optimizerの複数のカタログビューの​ カタログソース ​として使用することを選択できます。

IMPORTANT
書き出し設定を変更すると、カタログのサイズに応じて大幅な時間がかかる場合がある、完全なインデックス再作成がトリガーされます。 Adobeでは、統合を有効にして最初のデータ同期を開始する前に、Commerce スコープをCommerce Optimizerに同期するように設定することをお勧めします。

次の表に、各範囲レベルで書き出されるデータを示します。

範囲
書き出されたデータ
メモ
web サイトと顧客グループ
価格と価格表
各価格セットは、命名規則<website>::<SHA1 of customer group ID>を使用して価格表として書き出されます。 Web サイトのすべての顧客グループが含まれます。
ストアビュー
製品と製品属性
各ストアビューは、Commerce Optimizerに個別の​ カタログソース ​を作成します。

Commerce Optimizerの同期設定を使用したストアグリッド ​ {width="600" modal="regular"}

範囲の書き出し設定を変更するには

  1. Commerce Adminで、Stores > Settings > All Stores​に移動します。

  2. 設定するweb サイトまたはストアビューを選択します。

  3. Commerce Optimizerエクスポーター設定​で、チェックボックスを使用して、必要に応じてデータ同期を有効または無効にします。

    ​ データ同期設定の更新 {width="500" modal="regular"}

  4. 変更を保存します。

ビヘイビアーを有効または無効にする

アクション
結果
ストアビューを無効にする
同期を無効にすると、ストアフロントからカタログデータが削除されます。 カタログ ソースはCommerce Optimizerに残りますが、次回のcron実行時にすべての同期データが削除されます。
ストアビューを無効にして再度有効にする
同じカタログソースに、完全なデータ再同期が再入力されます。

Commerce Optimizer統合を有効にする enable-the-adobe-commerce-optimizer-integration

統合を有効にし、aco:config:init CLI コマンドを実行してデータ同期を開始します。 このコマンドは、次の手順を完了します。

  1. コマンドライン引数として指定された資格情報を使用して、IMS アクセストークンを取得します。
  2. https://ccm.api.commerce.adobe.com/api/v1/tenants/{tenantId}/owner/{orgId}のCommerce Cloud Manager （CCM） サービスを呼び出して、テナントを検証し、取り込みURLとCommerce Optimizer Studio URLを抽出します。
  3. すべての設定（クライアントシークレットが暗号化）をcore_config_dataに保存します。
  4. すべてのCommerce Optimizer フィードのインデクサーを無効にすることで、最初の完全同期をスケジュールします。
IMPORTANT
データ同期処理は、設定が完了するとすぐにバックグラウンドで開始されます。 カタログのサイズによっては、データ同期プロセスに数分から数時間かかる場合があります。

必要な接続の詳細を取得

Adobe Developer Consoleから、Commerce Optimizer取り込みサービスに対して有効な新しいプロジェクトを作成し、OAuth サーバー間の資格情報を生成します。 詳細な手順については、マーチャンダイジング開発者ガイド​のIMS資格情報の取得を参照してください。

資格情報ページから次の値を保存します。

  • 組織ID （org_id）
  • クライアント ID （client_id）
  • クライアント秘密鍵 （client_secret）

Adobe Developer Console プロジェクトページから資格情報の詳細を取得 {width="500" modal="regular"}

Commerce Optimizer インスタンスの詳細を取得

テナント ID​を、Commerce Optimizer インスタンス Instance details ページ ​の​ Instance Id ​フィールドまたはインスタンスへのアクセスに使用したURLから取得します。 例：https://experience.adobe.com/#/@<your organization>/in:<tenant ID>/commerce-optimizer-studio/home。

  1. Commerce管理者から「Adobe Commerce Optimizer」を選択し、手順を含む設定ページを表示します。

    Commerce Optimizer設定ページ ​ {width="500" modal="regular"}

  2. コマンドラインから、SSHを使用してAdobe Commerce ステージング環境に接続します。

  3. 次のAdobe Commerce CLI コマンドを実行して統合を設定し、プレースホルダー値をCommerce Optimizer プロジェクトの値に置き換えます。

    code language-shell 
    bin/magento aco:config:init --org_id=your-org --tenant_id=your-tenant --client_id=your-client-id --client_secret=your-secret

  4. Commerce管理者に戻り、Adobe Commerce Optimizer オプションを選択して、接続を確認します。

    オプションを選択すると、新しいタブでCommerce Optimizer UIが開きます。

データ同期が機能していることを確認します verify-that-the-data-sync-is-working

データがCommerce管理者から正常にエクスポートされ、データがCommerce Optimizerに正常に配信されたことを確認します。 Commerce Adminで書き出しから開始し、Commerce Optimizerで配信を確定します。

  1. Commerce管理者の同期ステータスを確認：

    System > Data Transfer > Data Feed Sync Status​に移動します。

    ​ フィード項目のステータスがレポートされるデータフィードの同期ステータス ページ ​ {width="700" modal="regular"}

    同期を実行すると、フィード データに正常に送信されたレコードが表示されます。 フィードを選択して、詳細を表示したり、同期の問題をトラブルシューティングしたりします。

  2. 確認データがCommerce Optimizerに配信されました：

    Commerce Optimizer メニューから、Data Sync​を選択します。

    同期されたカタログデータを表示するAdobe Commerce Optimizerの ​ データ同期ページ ​ {width="700" modal="regular"}

    予想される商品、価格、属性が表示されることを確認します。

同期が期待どおりに機能している場合：

  • Data Feed Sync Status​は、コネクタフィードに対して正常に送信されたレコードを表示しますが、未解決のアイテムレベルのエラーはありません。
  • Commerce Optimizerの​ Data Sync ​には、予想されるカタログ ソース、製品、価格および属性が一覧表示されます。
TIP
データ同期に問題がある場合は、​ トラブルシューティング ​ ガイドを参照してください。

次のステップ

  1. カタログ ビューとポリシーCommerce Optimizerを設定

    Commerce Optimizer UIでカタログ ビューとポリシーを作成します。 価格表は、Adobe Commerce個の顧客グループから自動的に作成されます。 手順については、Commerce Optimizerユーザーガイド​の​ カタログビューおよび​ ポリシーのドキュメントを参照してください。

  2. Edge Delivery Services​にCommerce ストアフロントを設定

    ​ ストアフロント設定ドキュメント ​に従って、ストアフロントをCommerce Optimizer インスタンスに接続し、パーソナライズされたコマースエクスペリエンスの提供を開始します。

recommendation-more-help
commerce-help-aco-connector