ドキュメントCommerceAdobe Commerce Optimizer Connector 統合ガイド

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

基本を学ぶ

Last update: Tue Mar 03 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • ユーザー

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

統合を使用するための要件

  • Adobe Commerce 2.4.7 以降

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

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

  • repo.magento.com にアクセスし、Composer を使用してCommerce コネクタ メタパッケージをダウンロードします。

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

統合を設定するAdobe Commerce ユーザーには、次が必要です。

recommendation-more-help

前提条件

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

  • Adobe Commerce Live Search （magento/live-search）
  • Adobe Commerceの製品に関する推奨事項（magento/product-recommendations）
  • Adobe Commerce カタログサービス （magento/catalog-service、magento/catalog-service-installer）
  • データ管理ダッシュボード（magento-catalog-sync-admin）

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

style
shade-box

設定手順

  1. 統合の設定

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

    2. 管理者で データの書き出しの設定を確認してカスタマイズ します。

    3. CommerceとCommerce Optimizer間の接続を確立するために必要な API 資格情報を取得 します。

    4. 統合を有効 Adobe Commerce Optimizer します。

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

Commerce Optimizer コネクタパッケージのインストール

Adobe Commerce Optimizer コネクタは、Adobe 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の管理者メニューから「Commerce Optimizer」オプションを使用できます。 「Commerce Optimizer」をクリックして、Commerce管理者から直接Commerce Optimizer インスタンスを開きます。

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

必要な接続の詳細を取得

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

TIP
Data Ingestion API で設定された Developer プロジェクトが、Commerce Optimizer インスタンスと同じ IMS 組織にすでに存在する場合は、既存の OAuth サーバー間資格情報を再利用できます。

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

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

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

Adobe Commerce Optimizer インスタンスからインスタンス ID （テナント ID とも呼ばれます）を保存します。 インスタンスへのアクセスに使用される URL で確認できます。 例えば、https://experience.adobe.com/#/@<project-id>/in:TToyu73daQRn66KAYaq8YZ/commerce-optimizer-studio/home では、インスタンス ID は TToyu73daQRn66KAYaq8YZ です。

Commerce データの書き出し設定のカスタマイズ

デフォルトでは、すべてのCommerce スコープ（web サイトおよびストアビュー）でカタログデータ同期が有効になっています。 書き出し設定をカスタマイズして、ビジネスニーズに基づいて特定の範囲のデータのみを同期できます。 例えば、複数のストアビューがあり、そのうち 1 つのビューのデータのみを書き出す場合、他のストアビューのエクスポーターを無効にできます。

IMPORTANT
書き出し設定を変更すると、完全なインデックス再作成がトリガーされます。カタログのサイズによっては、この再作成に時間がかかる可能性があります。 パフォーマンスへの影響を最小限に抑えるために、トラフィックが少ない時間帯にこれらの変更を計画します。

範囲別のデータのエクスポート

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

範囲
書き出されたデータ
備考
Web サイト
価格と価格台帳
価格の各セットは、命名規則 ​ を使用して ​ 価格台帳 website::customergroupcode として書き出されます。 Web サイトのすべての顧客グループが含まれます。
ストア表示
製品と製品属性
各ストア表示では、Adobe Commerce Optimizer に個別のカタログソースが作成されます。

動作を有効または無効にする

アクション
結果
ストア表示の無効化
カタログのソースは Adobe Commerce Optimizer のままですが、すべてのデータが削除されます。
ストア表示を無効にしてから再度有効にする
同じカタログソースに、完全なデータ再同期が再入力されます。

書き出し設定の更新

コネクタパッケージをインストールすると、管理者のストアグリッドにCommerce Optimizerの書き出し設定が表示されるようになりました。

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

Web サイトまたはストア表示の設定を変更するには：

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

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

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

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

  4. 変更を保存します。

Adobe Commerce Optimizer 統合の有効化

IMPORTANT
データ同期処理は、設定コマンドを実行するとすぐに開始されます。 デフォルトでは、すべてのCommerce スコープ（web サイトおよびストアビュー）でカタログデータ同期が有効になっています。 カタログのサイズによっては、データ同期プロセスに数分から数時間かかる場合があります。

前の手順で収集した API 資格情報とインスタンスの詳細を使用して、Commerce インスタンスと Adobe Commerce Optimizer インスタンスの統合を設定できるようになりました。

  1. Commerce Admin で「Adobe Commerce Optimizer」を選択すると、手順を示す設定ページが表示されます。

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

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

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

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

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

    このオプションをクリックすると、Adobe Commerce Optimizer UI が新しいタブで開きます。

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

統合を有効にすると、データ同期が自動的に開始されます。 カタログのサイズによっては、最初の同期に数分から数時間かかる場合があります。

  1. Commerce Admin で同期ステータスを確認します。

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

    ​ フィード項目のステータスレポートを含むデータフィード同期のステータスページ ​ {width="500" modal="regular"}

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

  2. Commerce Optimizerに到着したデータを確認：

    Adobe Commerce Optimizer メニューから「Data Sync」を選択します。

    ​ データ同期 ​ {width="500" modal="regular"}

    期待される製品、価格および属性が表示されることを確認します。

TIP
データ同期で問題が発生した場合は、「SaaS データの書き出し ​ ドキュメントの トラブルシューティング の節を参照してください。

次の手順

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

    Adobe Commerce Optimizer Guide のカタログ ビューとポリシーを作成します。 価格台帳は、Adobe Commerce顧客グループから自動的に作成されます。

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

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

e1dcc642-2c5f-4635-bc38-06204a0a8155