為Adobe Commerce Optimizer設定AEM Assets
僅[SaaS]{class="badge positive" title="僅適用於Adobe Commerce Optimizer專案。"}
適用於Adobe Commerce Optimizer的AEM Assets整合可讓商家使用AEM Assets作為產品影像的集中式數位資產管理解決方案。 本指南涵蓋Commerce Optimizer的特定組態。
不同於Adobe Commerce (PaaS)或Adobe Commerce as a Cloud Service (ACCS),Commerce Optimizer沒有管理員設定UI。 若要啟用整合,請使用您的Adobe Commerce Optimizer和AEM Assets詳細資料建立支援票證。 Adobe支援會設定整合,並在Assets整合服務中註冊您的租使用者。
下圖為Adobe Commerce Optimizer與AEM Assets整合之間的產品同步概觀。
此整合有兩個主要流程:
-
從AEM Assets:當資產被核准、拒絕或移除時,事件會透過Adobe Pipeline傳輸至Assets Integration Service。 此服務會將資產與使用
match-by-SKU(中繼資料導向)或自訂比對器(App Builder)的產品比對,然後將product-asset對應傳送至Commerce Optimizer,以儲存為產品層。 -
從Adobe Commerce Optimizer:當產品在Commerce Optimizer中更新時,事件會透過Adobe管道傳輸到Assets整合服務。 此服務會將任何符合的資產對應同步回Adobe Commerce Optimizer。
先決條件
在設定整合之前,請確定您具備:
- 具有產品視覺效果權益的有效Adobe Commerce Optimizer執行個體,或具有Dynamic Media的任何AEM Assets授權。
- 存取AEM Assets as a Cloud Service環境。
- 同一Adobe IMS組織中的Commerce Optimizer和AEM Assets。
- 在您的AEM Assets環境中啟用OpenAPI的Dynamic Media 。
入門
若要將AEM Assets與Commerce Optimizer整合,您必須建立支援票證。
Adobe支援會使用您票證中的資訊,向Assets Integration Service註冊您的租使用者,並設定整合。
在您的支援票證中包含下列資訊:
- 在您的 Adobe Commerce OptimizerURL或Commerce Cloud Manager UI中找到 租使用者識別碼Commerce Optimizer (執行個體識別碼)。
- AEM計畫識別碼。
- AEM環境識別碼。
- 符合規則:符合SKU或外部符合專案(App Builder)。
- 階層:要登入租使用者的目錄階層名稱。 視需要指定自訂名稱。 否則,會使用預設
AEM-Assets。 - 地區設定:要向註冊租使用者的目錄來源地區設定(例如,
en-US)。
Adobe支援處理完您的票證後,便會設定整合,並且您的租使用者會向Assets Integration Service註冊。
上線完成後:
-
向Assets Integration Service註冊:您的Commerce Optimizer租使用者已使用Adobe Commerce Optimizer租使用者ID、AEM方案ID、AEM環境ID和租使用者向Assets Integration Service註冊。
-
驗證設定: IMS服務權杖驗證設定在Commerce Optimizer與Assets整合服務之間,以進行安全通訊。
-
事件訂閱: Assets Integration Service訂閱:
- AEM Assets事件(資產已核准、更新、已移除)
- Commerce Optimizer個目錄事件(已建立、已更新的產品)
限制
Commerce Optimizer整合有下列限制:
- 每個商家一個圖層—AEM Assets整合支援每個商家一個AEM-Assets圖層(每個租使用者一個來源)。 目前不支援為每個商家設定多個圖層。
- 僅限影像 — 整合不支援視訊或其他媒體型別。
- 沒有類別影像 — 無法使用類別影像同步處理。 不支援AEM Assets中用於Assets選擇器(UI插入)的類別影像。
- 沒有多網站區別 — 整合不會處理多網站;與產品相關的影像在所有管道和原則上都顯示相同。
- 影像位置/順序 — 不支援影像位置和順序。
- 產品必須存在 — 如果產品不存在於Commerce Optimizer中,將不會為該產品 — 資產對應建立圖層。
- 圖層欄位覆寫 — 圖層中的值覆寫基底目錄。 如果欄位沒有在圖層裝載中傳送,則可能會以空值覆寫。 對AEM Assets內容使用專用圖層;若將現有圖層重複用於其他用途,可能會導致非預期的資料遺失。
設定您的AEM Assets
Commerce Optimizer的AEM Assets安裝與設定程式與Adobe Commerce as a Cloud Service相同。 如需完整步驟,請參閱設定AEM Assets專案以支援Commerce中繼資料。
確保您的AEM Assets環境準備就緒:
-
AEM Assets設定:設定Commerce中繼資料設定檔。 請參閱設定中繼資料設定檔。
-
啟用Dynamic Media:確認已在您的AEM Assets環境中啟用具有OpenAPI功能的Dynamic Media。
設定AEM Assets
若要啟用產品與資產同步化,請設定AEM Assets環境。
步驟1:使用OpenAPI啟用Dynamic Media
必須在您的AEM Assets環境中啟用具有OpenAPI的Dynamic Media 。 產品視覺效果和新的AEM Assets授權可讓您透過Cloud Manager以自助方式啟用。 舊版AEM Assets授權需要Adobe支援才能啟用。 如需啟用步驟,請參閱設定AEM Assets專案。
步驟2:選擇性。 設定Commerce中繼資料設定檔
在AEM Assets中設定中繼資料設定檔,以儲存Commerce專屬的中繼資料。
如需詳細指示,請參閱設定中繼資料設定檔。
步驟3:將中繼資料套用至資產
將Commerce中繼資料新增至AEM Assets中的產品影像。
檢視AEM Commerce套件內容以取得欄位定義,以及設定中繼資料設定檔以取得設定步驟。
資產必須處於 已核准 狀態,資料同步才會觸發。 單獨儲存中繼資料不會觸發事件。
AEM-Assets圖層指派給您的目錄檢視。 如果未指定圖層,產品影像資料可能會意外覆寫。同步
設定之後,整合會自動同步product-asset對應。
如需詳細資訊,請參閱自訂自動比對。
依SKU工作流程範例比對
將現有資產新增至新產品時的典型流程:
-
在Commerce Optimizer中建立產品(透過API或資料擷取)。 產品一開始可能沒有影像。
-
在AEM Assets中,開啟您要對應至產品的資產。
-
將產品SKU新增至 commerce:skus 中繼資料並指派影像角色(例如,
thumbnail、image)。 -
核准要傳送的資產。 這會觸發Assets Integration Service處理的事件。
-
Assets整合服務會將產品影像對應傳送至Commerce Optimizer。 Commerce Optimizer中的產品已使用資產中的影像更新。
-
確認影像可見。 留出時間讓同步完成(通常在幾分鐘內),然後檢查Commerce Optimizer UI中的產品(例如,資料同步或目錄檢視),或查詢店面API (目錄服務、即時搜尋、店面GraphQL API)以確認傳回影像。
影像角色處理
當產品有多個資產使用相同的影像角色時(例如,兩個資產具有thumbnail角色),整合可確保只有一個資產會保留該角色,以避免Commerce Optimizer層中的重複角色和非預期的店面行為。
行為:從AEM Assets傳送更新時,最近更新的資產會收到影像角色(例如,thumbnail),而該角色會從具有它的先前資產中移除。 這可防止店面中出現重複的影像角色。