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

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

基本を学ぶ

Last update: Wed Apr 08 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

ユーザー

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

統合の使用要件

Adobe Commerce 2.4.7以降
- PHP 8.2、8.3、または8.4
- Composer 2.x
プロビジョニングされたサンドボックスインスタンスを使用するAdobe Commerce Optimizer ライセンス。
Composerを使用してCommerce Connector メタパッケージをダウンロードするための認証キー。
Adobe Commerce Optimizer サンドボックスインスタンスへの管理者アクセス。

統合を設定するAdobe Commerce ユーザーは、次の要件を満たす必要があります。

Adobe Commerce管理者への管理者アクセス。
Adobe Commerce アプリケーションサーバーへのコマンドラインアクセス。
プロジェクトがプロビジョニングされているIMS組織Adobe Commerce Optimizerへの開発者アクセス。

recommendation-more-help

前提条件

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

Adobe Commerce ライブサーチ（magento/live-search）
Adobe Commerceの商品レコメンデーション（magento/product-recommendations）
Adobe Commerce Catalog Service （magento/catalog-service, magento/catalog-service-installer）
データ管理ダッシュボード（magento-catalog-sync-admin）

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

style

shade-box

設定手順

コネクタを有効にし、CommerceからAdobe Commerce Optimizer インスタンスへのデータの同期を開始するには、次の手順に従います。

Composerを使用してCommerce Optimizer Connector パッケージをインストールし、Commerce インスタンスをAdobe Commerce Optimizerに接続します。
管理者からデータ書き出し設定を確認してカスタマイズします。
CommerceとCommerce Optimizer間の接続を確立するために必要なAPI資格情報を取得します。
 Adobe Commerce Optimizer 統合を有効にします。
データ同期が機能していることを確認します。

Commerce Optimizer Connector パッケージのインストール

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

インストール手順

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

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

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

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

NOTE

拡張機能のインストール手順について詳しくは、次のガイドを参照してください。

Cloud Infrastructure上のAdobe Commerceへの拡張機能のインストール

Adobe Commerce オンプレミスへの拡張機能のインストール

必要な接続の詳細を取得

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

TIP

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

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

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

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

インスタンス ID （テナント IDとも呼ばれます）をAdobe Commerce Optimizer インスタンスから保存します。インスタンスへのアクセスに使用される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に残りますが、すべてのデータは削除されます。

ストアビューを無効にして再度有効にする

同じカタログソースに、完全なデータ再同期が再入力されます。

書き出し設定の更新

Connector パッケージをインストールすると、AdminのStore グリッドにCommerce Optimizerの書き出し設定が表示されるようになりました。

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

Web サイトまたはストアビューの設定を変更するには：

Commerce Adminで、Stores > Settings > All Storesに移動します。
設定するweb サイトまたはストアビューを選択します。
Adobe Commerce Optimizerエクスポーター設定で、チェックボックスを使用して、必要に応じてデータ同期を有効または無効にします。

{width="500" modal="regular"}
変更を保存します。

Adobe Commerce Optimizer統合を有効にする

IMPORTANT

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

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

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

{width="500" modal="regular"}
コマンドラインから、SSHを使用してCommerce ステージング環境に接続します。
次の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

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

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

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

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

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

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

{width="500" modal="regular"}

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

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

{width="500" modal="regular"}

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

TIP

データ同期に問題がある場合は、SaaS データ書き出しドキュメントのトラブルシューティング セクションを参照してください。

次のステップ

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

カタログビューとポリシーをAdobe Commerce Optimizer ガイドで作成します。価格表は、Adobe Commerceのお客様グループから自動的に作成されることに注意してください。
Edge Delivery ServicesでのCommerce ストアフロントの設定

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

e1dcc642-2c5f-4635-bc38-06204a0a8155