Commerce Services Connector

最後更新： 2025年3月6日
  • 主題：

建立對象：

  • 管理員
  • 使用者

部分Adobe Commerce和Magento Open Source功能由Commerce Services提供技術支援，並部署為SaaS （軟體即服務）。 若要使用這些服務，您必須使用生產及沙箱API金鑰連線您的Commerce執行個體，並在設定中指定資料空間。 您只需要為每個執行個體設定一次連線。

可用的服務

以下列出您可以透過Commerce Services Connector存取的Commerce功能：

服務可用性
Product Recommendations powered by Adobe SenseiAdobe Commerce
Live Search powered by Adobe SenseiAdobe Commerce
Payment ServicesAdobe Commerce和Magento Open Source
Site-Wide Analysis ToolAdobe Commerce
Catalog ServiceAdobe Commerce
Data ConnectionAdobe Commerce

架構

從高層次來看，Commerce Services Connector由下列核心元素組成：

Commerce服務聯結器架構

以下各節會更詳細地討論這些元素。

認證

從授權擁有者的Commerce帳戶產生生產和沙箱API金鑰。 Commerce帳戶由唯一的Commerce ID (MageID)識別。 只要帳戶處於良好狀態，商家組織的授權擁有者就能為產品推薦或Live Search等服務產生API金鑰。

這些金鑰可在「需知」基礎上與系統整合商或開發團隊分享，後者代表授權持有人管理專案和環境。 已獲授權擁有者授予Shared Access的開發人員，無法代表其產生金鑰，即使商家組織出現在其帳戶的Switch Accounts下拉式清單中。

此外，解決方案整合經銷商也有權使用Commerce Services。 如果您是解決方案整合商，Commerce合作夥伴合約的簽署者應該產生API金鑰。

NOTE
金鑰識別碼​ Production ​和​ Sandbox ​未參考您的環境。 您對每個環境（例如本機、開發、預備或生產環境）使用與的相同API金鑰集。
授權擁有者通常是Adobe Commerce帳戶的主要聯絡人，並不一定與雲端基礎結構專案的Adobe Commerce專案擁有者相同。

產生生產和沙箱API金鑰

  1. 在https://account.magento.com登入您的Commerce帳戶。

  2. 在​ Magento ​標籤下，選取側邊欄上的​ API入口網站。

  3. 從​ 環境 ​功能表，選取​ 生產 ​或​ 沙箱。

    NOTE
    生產 ​和​ 沙箱 ​是指資料儲存在Adobe SaaS後端系統中的資料空間環境。 它並非指您將使用金鑰的商務環境。

  4. 在​ API金鑰 ​區段中輸入名稱，然後按一下​ 新增 ​以開啟對話方塊下載新金鑰。

    下載私密金鑰

    WARNING
    此對話方塊提供您複製或下載金鑰的唯一機會。

  5. 按一下​ 下載，然後按一下​ 取消。

  6. 對每個環境（生產和沙箱）重複上述步驟。

    API金鑰 ​區段現在會顯示您的API （公開）金鑰。 當您在與授權相關的任何環境或安裝中選取或建立SaaS專案時，您需要所有四個金鑰（生產金鑰和沙箱金鑰，均為Public+Private）。

SaaS設定

Commerce執行個體必須設定有SaaS專案和SaaS資料空間，這樣Commerce Services才能將資料傳送到正確的位置。 SaaS專案會將所有SaaS資料空間分組。 SaaS資料空間用於收集和儲存可讓Commerce Services運作的資料。 某些資料可從Commerce執行個體匯出，而某些資料可從店面的購物者行為收集。 然後，這些資料會持續儲存以保護雲端儲存空間。

針對Product Recommendations，SaaS資料空間包含目錄和行為資料。 您可以在Commerce設定中選取執行個體，以將Commerce執行個體指向SaaS資料空間。

WARNING
請在生產Commerce安裝中只使用您的​ 生產SaaS資料空間，以避免資料衝突。 否則，您可能會使用測試資料汙染生產網站資料，進而導致部署延遲。 例如，中繼資料（例如中繼URL）可能會錯誤地覆寫您的生產產品資料。
如果發生這種狀況，請提交支援要求以要求清除資料。

SaaS資料空間布建

所有Adobe Commerce商戶都可以存取每個SaaS專案一個生產資料空間和兩個測試資料空間。

只要不同時在多個環境中使用相同的資料空間，您就可以在任何非生產環境中使用測試資料空間。 若要在不同的環境中使用測試資料空間，請先執行資料清理，然後再在該環境中選取和設定資料空間。

對於具有多個中繼環境的Adobe Commerce Cloud Pro專案，您可以透過提交支援請求，為每個中繼環境請求額外的測試資料空間。 不過，如果您只有一個測試環境，且需要額外的測試資料空間，您有以下選項：

  • 請聯絡客戶成功團隊或您指派的客戶成功案例經理，以要求額外的測試環境。
  • 提交支援要求以要求額外的測試資料空間，並指明額外資料空間的商業理由。 此請求有待核准。

使用Adobe付款服務的Magento Open Source客戶可能也會要求額外的資料空間。 請在提交支援要求以要求測試資料空間之前，先連絡付款團隊以取得其他資料空間的預先核准。

擁有多個雲端專案或內部部署（即時/生產）安裝的客戶，也可透過提交支援要求，要求每個專案或執行個體的額外生產及測試資料空間。

選取或建立SaaS專案

若要選取或建立SaaS專案，請向商店的Commerce授權擁有者要求Commerce API金鑰：

NOTE
如果您在Commerce設定中沒有看到​ Commerce Services Connector ​區段，則必須為所需的Commerce 服務安裝Commerce模組。

  1. 在​ 管理員 ​側邊欄上，前往​ 系統 >服務> Commerce服務聯結器。

    如果您在Commerce設定中沒有看到​ Commerce Services Connector ​區段，請為所需的Commerce 服務安裝Commerce模組。 此外，請確定已安裝magento/module-services-id套件。

  2. 在​ Sandbox API Keys ​和_Production API Keys_​區段中，貼上您的金鑰值。

    • 私密金鑰必須在金鑰開頭包含----BEGIN PRIVATE KEY---，並在金鑰結尾包含----END PRIVATE KEY----。
    • 如果您沒有實際金鑰的副本，請向帳戶擁有者索取，然後將值插入設定中。
    WARNING
    如果您透過查詢資料庫備份或快照集並將這些值貼到組態中來新增金鑰值，則會套用額外的加密層，且金鑰將無法運作。

  3. 按一下​ 儲存。

任何與您的金鑰相關聯的SaaS專案都會顯示在​ SaaS識別碼 ​區段的​ 專案 ​欄位中。

  1. 如果沒有SaaS專案，請按一下​ 建立專案。 然後在​ 專案 ​欄位中，輸入您的SaaS專案名稱。
NOTE
為避免混淆，請勿使用特定的Commerce服務作為專案的名稱，例如​ 即時搜尋、產品建議 ​或​ 資料連線。 除非您的授權已布建在多個SaaS專案，否則您可以對多個服務使用相同的SaaS專案。
  1. 選取​ 資料空間，以用於您Commerce存放區的目前組態。
NOTE
如果您有要與Commerce服務整合的個別執行個體，請提交支援票證，為每個額外的執行個體請求新的SaaS專案。 在支援建立SaaS專案後，請使用相同的API金鑰為例項設定Commerce Services整合，並為資料空間選取新的SaaS專案。
WARNING
如果您在「我的帳戶」的「API入口網站」區段中產生新金鑰，請立即更新「管理員」設定中的API金鑰。 如果您產生新金鑰，但未在Admin中更新，您的SaaS擴充功能即無法運作，而您會遺失寶貴資料。

若要變更SaaS專案或資料空間的名稱，請按一下其中任何一個專案旁邊的​ 重新命名。 變更名稱不會影響您的服務，因為名稱只是一個標籤，可協助您識別並區分專案和資料空間。

IMS組織（選用）

若要將您的Adobe Commerce執行個體連結至Adobe Experience Platform，請使用您的Adobe ID登入您的Adobe帳戶。 登入後，與您的Adobe帳戶相關聯的IMS組織會顯示在此區段中。

SaaS資料匯出

當您的Commerce執行個體成功連線至Commerce Services時，SaaS資料匯出程式會將Commerce資料從您的Commerce伺服器匯出至Commerce SaaS Services，以便同步處理至連線的Commerce服務。 在Admin中，您可以使用資料管理儀表板來檢查同步處理狀態。 如需詳細資訊，請參閱SaaS資料匯出指南。

上一頁發行說明
下一頁目錄同步

Commerce