文件CommerceAdobe Commerce Optimizer Connector整合指南

[僅限PaaS]{class="badge informative" title="僅適用於雲端專案(Adobe管理的PaaS基礎結構)和內部部署專案的Adobe Commerce 。"}

開始使用

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

建立對象：

  • 使用者

安裝並設定Commerce Optimizer Connector以將您的Adobe Commerce目錄資料與Adobe Commerce Optimizer同步，然後監視資料同步狀態，以確保您的店面為最新狀態。

使用整合的需求

設定整合的Adobe Commerce使用者必須具備：

recommendation-more-help

先決條件

如果您已安裝下列任何擴充功能，請在安裝Commerce Optimizer Connector前解除安裝它們：

  • Adobe Commerce即時搜尋(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聯結器套件，以將您的Commerce執行個體連線至Adobe Commerce Optimizer。

    2. 從管理員檢閱及自訂資料匯出設定。

    3. 取得在Commerce和Commerce Optimizer之間建立連線所需的API認證。

    4. 啟用 Adobe Commerce Optimizer 整合。

    5. 確認資料同步處理正在運作。

安裝Commerce Optimizer聯結器套件

Adobe Commerce Optimizer Connector是以撰寫器中繼資料的形式提供，適用於具有Adobe Commerce Optimizer的有效授權的所有Commerce商家。

安裝步驟

  1. 使用撰寫器新增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內部部署安裝擴充功能

取得必要的連線詳細資料

從Adobe Developer Console建立啟用Adobe Commerce Optimizer內嵌服務的開發人員專案，並產生OAuth伺服器對伺服器認證。 如需詳細指示，請參閱銷售開發人員指南中的​取得IMS認證。

TIP
如果您已在與Commerce Optimizer執行個體相同的IMS組織中擁有使用資料擷取API設定的開發人員專案，您可以重複使用現有的OAuth伺服器對伺服器認證。

從證明資料頁面儲存下列值：

  • 組織識別碼 (org_id)
  • 使用者端識別碼 (client_id)
  • 使用者端密碼 (client_secret)

取得Adobe Commerce Optimizer執行個體詳細資料

從您的Adobe Commerce Optimizer執行個體儲存執行個體識別碼（也稱為租使用者識別碼）。 您可以在用來存取執行個體的URL中找到它。 例如，在https://experience.adobe.com/#/@<project-id>/in:TToyu73daQRn66KAYaq8YZ/commerce-optimizer-studio/home中，執行個體識別碼為TToyu73daQRn66KAYaq8YZ。

自訂Commerce資料匯出設定

依預設，所有Commerce範圍（網站和商店檢視）的目錄資料同步已啟用。 您可以根據業務需求自訂匯出設定，以僅同步特定範圍的資料。 例如，如果您有多個存放區檢視，但只想匯出其中一個的資料，您可以停用其他存放區檢視的匯出工具。

IMPORTANT
變更匯出設定會觸發完整的重新編列索引，這可能需要相當長的時間，視您的目錄大小而定。 在低流量期間規劃這些變更，以將對效能的影響降至最低。

依範圍匯出資料

下表說明會在每個範圍層級匯出哪些資料：

範圍
資料已匯出
附註
網站
價格與價格手冊
每組價格會使用命名慣例匯出為價格簿website::customergroupcode。 包括網站的所有客戶群組。
存放區檢視
產品和產品屬性
每個存放區檢視都會在Adobe Commerce Optimizer中建立個別的目錄來源。

啟用和停用行為

動作
結果
停用商店檢視
目錄來源仍保留在Adobe Commerce Optimizer中，但已移除所有資料。
停用然後重新啟用存放區檢視
相同的目錄來源會以完整資料重新同步重新填入。

更新匯出設定

安裝聯結器套件後，管理員中的商店格線現在會顯示Commerce Optimizer的匯出組態設定。

具有Commerce Optimizer同步設定的商店格線 {width="600" modal="regular"}

若要變更網站或商店檢視的設定：

  1. 在Commerce管理員中，導覽至「Stores > Settings > All Stores」。

  2. 選取您要設定的網站或商店檢視。

  3. 在​ Adobe Commerce Optimizer匯出程式設定 ​中，視需要使用核取方塊來啟用或停用資料同步處理。

    更新資料同步設定 {width="500" modal="regular"}

  4. 儲存您的變更。

啟用Adobe Commerce Optimizer整合

IMPORTANT
資料同步處理會在您執行設定命令後立即開始。 依預設，所有Commerce範圍（網站和商店檢視）的目錄資料同步已啟用。 視目錄大小而定，資料同步程式可能需要幾分鐘到數小時的時間。

使用您在上一步中收集的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管理員中檢查同步狀態：

    前往​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指南中建立目錄檢視和原則。 請注意，價格簿是從Adobe Commerce客戶群組自動建立的。

  2. 在Edge Delivery Services上設定Commerce店面

    依照店面設定檔案將您的店面連線到Adobe Commerce Optimizer執行個體，並開始提供個人化的商務體驗。

06310ebc-9201-4615-b4ab-0c9ee190b0c9