[僅限PaaS]{class="badge informative" title="僅適用於雲端專案（Adobe管理的PaaS基礎結構）和內部部署專案的Adobe Commerce 。"}
開始使用
安裝並設定Adobe Commerce Optimizer Connector，將您的Adobe Commerce目錄資料與Adobe Commerce Optimizer同步，然後監視資料同步狀態，以確保您的店面為最新狀態。
使用整合的需求 requirements-to-use-the-integration
-
Adobe Commerce 2.4.7+
- PHP 8.2、8.3或8.4
- Composer 2.x
-
具有已布建沙箱執行個體的Commerce Optimizer授權。
-
驗證金鑰，以使用Composer下載聯結器中繼套件。
設定整合的Adobe Commerce使用者必須具有：
-
Commerce管理員的管理員存取權。
-
對 Adobe Commerce 應用程式伺服器的命令列存取權。
-
開發人員存取已布建Commerce Optimizer專案的IMS組織。
移除衝突的擴充功能 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進行設定。
設定步驟 configuration-steps
請依照下列步驟來啟用Adobe Commerce Optimizer Connector，並開始將資料從Adobe Commerce同步至您的Commerce Optimizer執行個體。
-
使用Composer安裝 Adobe Commerce Optimizer Connector 封裝，以將您的Adobe Commerce執行個體連線到Commerce Optimizer。
安裝Adobe Commerce Optimizer Connector封裝 install-the-adobe-commerce-optimizer-connector-package
Adobe Commerce Optimizer Connector會以撰寫器中繼資料的形式傳送，以供具有Commerce Optimizer的有效授權之所有Commerce商家使用。
安裝步驟
-
使用撰寫器新增
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執行個體。
自訂Commerce範圍匯出設定 customize-the-commerce-scopes-export-configuration
依預設，所有Commerce範圍（網站、客戶群組和商店檢視）的目錄資料同步已啟用。 您可以根據業務需求自訂匯出設定，以僅同步特定範圍的資料。 例如，如果您有多個共用相同語言的存放區檢視，您可以選擇只匯出其中一個存放區檢視的資料，並在Commerce Optimizer中作為多個目錄檢視的目錄來源。
下表說明會在每個範圍層級匯出哪些資料：
若要變更範圍匯出設定
-
在Commerce Admin中，前往Stores > Settings > All Stores。
-
選取您要設定的網站或商店檢視。
-
在 Commerce Optimizer匯出程式設定 中，視需要使用核取方塊來啟用或停用資料同步處理。
-
儲存您的變更。
啟用和停用行為
啟用Commerce Optimizer整合 enable-the-adobe-commerce-optimizer-integration
您透過執行aco:config:init CLI命令來啟用整合，並起始資料同步處理。 此指令會完成下列步驟：
- 使用作為命令列引數提供的憑證取得IMS存取權杖。
- 呼叫位於
https://ccm.api.commerce.adobe.com/api/v1/tenants/{tenantId}/owner/{orgId}的Commerce Cloud Manager (CCM)服務以驗證租使用者並擷取內嵌URL和Commerce Optimizer Studio URL。 - 將所有設定（使用者端密碼已加密）儲存至
core_config_data。 - 讓所有Commerce Optimizer摘要索引器失效，以排程初始完整同步。
取得必要的連線詳細資料
從Adobe Developer Console，建立啟用Commerce Optimizer內嵌服務的新專案，並產生OAuth伺服器對伺服器認證。 如需詳細指示，請參閱 銷售開發人員指南 中的取得IMS認證。
從證明資料頁面儲存下列值：
- 組織識別碼 (
org_id) - 使用者端識別碼 (
client_id) - 使用者端密碼 (
client_secret)
取得Commerce Optimizer執行個體詳細資料
從Commerce Optimizer執行個體Instance details 頁面上的 Instance Id 欄位或用來存取執行個體的URL取得_租使用者識別碼_。 例如，在https://experience.adobe.com/#/@<your organization>/in:<tenant ID>/commerce-optimizer-studio/home中。
-
從Commerce Admin中，選取 Adobe Commerce Optimizer 以顯示包含指示的設定頁面。
-
從命令列，使用SSH連線到Adobe Commerce中繼環境。
-
執行下列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 -
返回Commerce管理員並選取Adobe Commerce Optimizer選項，以驗證連線。
當您選取選項時，它會在新索引標籤中開啟Commerce Optimizer UI。
確認資料同步處理運作正常 verify-that-the-data-sync-is-working
確認資料已成功從Commerce管理員匯出，且資料已成功傳遞至Commerce Optimizer。 從Commerce管理員中的匯出開始，然後在Commerce Optimizer中確認傳遞。
-
在Commerce管理員中檢查同步狀態：
前往System > Data Transfer > Data Feed Sync Status。
同步執行時，摘要資料會顯示已成功傳送的記錄。 選取摘要以檢視詳細資料或疑難排解同步問題。
-
確認資料已傳遞至Commerce Optimizer：
從Commerce Optimizer功能表選取Data Sync。
Adobe Commerce Optimizer中的
確認已出現預期的產品、價格和屬性。
當同步如預期運作時：
- Data Feed Sync Status顯示聯結器摘要的成功傳送記錄，沒有未解決的專案層級錯誤。
- Commerce Optimizer中的 Data Sync 列出預期的目錄來源、產品、價格和屬性。