文件CommerceAEM Assets整合指南

設定整合

Last update: Thu Feb 19 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：
  • CMS

建立對象：

  • 使用者

將Commerce連線至AEM Assets執行個體，並選取資產同步的比對策略，以設定整合。

識別AEM Assets專案後，選取在Adobe Commerce和AEM Assets之間同步資產的相符規則。

  • Match by product SKU — 符合資產中繼資料中的SKU與Commerce產品SKU的預設規則，以確保資產與正確的產品相關聯。

  • Custom match — 符合規則，適用於需要自訂比對邏輯的較複雜案例或特定業務需求。 實作自訂比對需要在Adobe Developer App Builder中開發自訂程式碼，以定義資產與產品的比對方式。 即將推出更多詳細資料……

對於初始設定，請使用預設的​ 依產品SKU比對 ​規則。

需求

在設定AEM Assets整合之前，請確認您已完成下列步驟：

  • 設定AEM Assets專案

  • 僅[PaaS]{class="badge informative" title="僅適用於雲端專案上的Adobe Commerce (Adobe管理的PaaS基礎結構)。"} 安裝Adobe Commerce套件以新增擴充功能，並產生使用擴充功能所需的認證和連線。

IMS和使用者許可權

若要使用「資產選擇器」並在Commerce中提供更流暢的設定，需要下列許可權：

ACCS

僅[SaaS]{class="badge positive" title="僅適用於Adobe Commerce as a Cloud Service和Adobe Commerce Optimizer專案(Adobe管理的SaaS基礎結構)。"}

IMS驗證預設為啟用。 將使用者新增至​ Adobe Admin Console ​中的AEM Assets DM OpenAPI使用者 — 傳遞產品設定檔，以授與AEM Assets傳遞層的存取權。

適用於Admin Console傳遞的 AEM Assets產品設定檔 {width="600" modal="regular"}

PaaS

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

  1. 依照Commerce管理指南​ 中的指示，為Commerce ​啟用Adobe IMS。

  2. 開啟支援票證以要求資產選擇器的自訂IMS使用者端ID。

  3. 將使用者新增至​ Adobe Admin Console ​中的AEM Assets DM OpenAPI使用者 — 傳遞產品設定檔，以授與AEM Assets傳遞層的存取權。

設定連線

  1. 從「Commerce管理員」開啟AEM Assets整合設定。

    1. 移至「Store >設定> ADOBE SERVICES > AEM Assets Integration」。

      AEM Assets整合啟用整合 {width="600" modal="regular"}

INFO
AEM Assets整合僅支援全域（預設）範圍內的設定。 不支援網站層級設定。 當您嘗試在網站層級設定整合時，系統會忽略網站層級的設定，改用全域設定值。

  1. 僅[PaaS]{class="badge informative" title="僅適用於雲端專案上的Adobe Commerce (Adobe管理的PaaS基礎結構)。"}輸入​Asset Selector IMS Client ID。

    需要此ID才能啟用資產選擇器，並自動填入方案ID和環境ID欄位的功能。 檢視IMS和使用者許可權以取得此ID。 如需「資產選擇器」的詳細資訊，請參閱手動選取資產。

  2. 從下拉式功能表中選取AEM Assets環境​ Program ID ​和​Environment ID。

    下拉式清單會根據使用者的IMS工作階段自動填入。 若要使用此功能，請確定您擁有正確的IMS和使用者許可權。

    如果無法使用下拉式清單，您可以從AEM Cloud Manager URL手動輸入ID： https://author-p[Program ID]-e[EnvironmentID].adobeaemcloud.com/

    從​ Use system value ​中移除選取專案，以編輯設定值。

  3. [僅限PaaS]{class="badge informative" title="僅適用於雲端專案上的Adobe Commerce (Adobe管理的PaaS基礎結構)。"}選取Commerce integration以驗證Commerce與資產比對服務之間的要求。

  4. 將​ Synchronization enabled ​設為Yes以允許Commerce接受來自AEM Assets的傳入更新。

    啟用整合後，可使用其他設定選項來指定資產比對條件。

  5. 從​ Asset matching rule ​下拉式清單中選取其中一個資產比對規則以進行資產同步。

  6. 新增在欄位中為AEM Assets產品SKU定義的Commerce中繼資料欄位名稱​Match by product SKU attribute name，預設為commerce:skus。

  7. 選取​ Save Config ​以套用更新並啟動資產同步處理。

    設定更新會觸發初始同步流程，允許Commerce接受來自AEM Assets的傳入更新。 同步所需的時間取決於資產數量和特定配置。 整合利用自動化程式，將同步所需的時間減至最少。

同步SLA

此整合可保證以下同步處理效能等級：

  • < 5 minutes for 99% of updates

  • < 30 minutes for 99.9% of updates

這可確保產品頁面一律顯示最新影像，讓店面內容保持精確且美觀。

設定視覺效果擁有者

視覺化擁有者​設定會決定要提供整合中產品影像的系統：

  • Adobe Commerce — 使用Commerce中託管的影像。

  • AEM Assets — 使用與AEM同步的影像。

管理員會顯示該擁有者的可用影像，而其餘影像則會呈現灰色，並以​ 隱藏 ​標籤顯示。

如需影像顯示行為的詳細資訊，請參閱設定影像詳細資料主題。

TIP
從Commerce移轉至AEM Assets期間，請將​ 視覺效果擁有者 ​設定為Commerce以避免影像連結失效。 所有產品成功與AEM Assets同步後，請切換至AEM Assets擁有者以完成轉變。 這可確保整個程式中的連續影像可用性。

  1. 導覽至「Store >設定> ADOBE SERVICES > AEM Assets Integration」。

    AEM Assets整合視覺化擁有者功能 {width="400" modal="regular"}

  2. 選取​ 視覺化擁有者 ​來源以顯示影像。

  3. 按一下​ Save Config ​以套用更新並啟動資產同步處理。

選填。 設定自訂網域URL

如果AEM Assets as a Cloud Service專案已使用自訂網域名稱設定，您必須將網域名稱新增到Commerce存放區設定，好讓Commerce的AEM Assets整合能夠使用它。

  1. 導覽至「Store >設定> ADOBE SERVICES > AEM Assets Integration」。

    AEM Assets整合啟用整合 {width="700" modal="regular"}

  2. 將​ 自訂網域URL ​新增至​ Asset Custom Domain ​欄位。

  3. 按一下​ Save Config ​以套用更新並啟動資產同步處理。

下一步

  • 設定您的Commerce店面 — 若要搭配使用AEM Assets與由Edge Delivery Services支援的Commerce店面，請完成Adobe Commerce店面檔案中​ AEM Assets整合 ​主題中所述的店面設定。

  • 設定Adobe Commerce與AEM Assets整合之間的相符規則。

  • 管理Commerce資產。

recommendation-more-help
7c668478-e331-4212-aded-e9afab74d1bd