將Commerce資料連線至Adobe Experience Platform
安裝Data Connection擴充功能時,在Commerce Admin 的 服務 下的 系統 功能表中會出現兩個新的設定頁面。
- Commerce服務聯結器
- Data Connection
若要將您的Adobe Commerce執行個體連線到Adobe Experience Platform,您必須設定這兩個聯結器,從Commerce服務聯結器開始,然後以Data Connection擴充功能完成。
設定Commerce服務聯結器
如果您先前已安裝Adobe Commerce服務,表示您可能已設定Commerce服務聯結器。 如果沒有,則您必須在Commerce服務聯結器頁面上完成下列工作:
- 登入您的Commerce帳戶以擷取您的生產和沙箱API金鑰。
- 選取SaaS資料空間。
- 登入您的Adobe帳戶以擷取您的組織ID。
設定Commerce Services聯結器後,再設定Data Connection擴充功能。
設定Data Connection擴充功能
在本節中,您將瞭解如何設定Data Connection擴充功能。
新增服務帳戶和認證詳細資料
如果您計畫收集並傳送歷史訂單資料或客戶設定檔資料,您必須新增服務帳戶與認證詳細資料。 此外,如果您正在設定Audience Activation擴充功能,則必須完成這些步驟。
如果您只收集和傳送店面或後台資料,您可以跳至一般區段。
步驟1:在Adobe Developer Console中建立專案
在Adobe Developer Console中建立可驗證Commerce的專案,以便進行Experience Platform API呼叫。
若要建立專案,請依照驗證及存取Experience PlatformAPI教學課程中概述的步驟進行。
進行教學課程的過程中,請確定您的專案具備下列專案:
此步驟的結果會建立您在下一步中使用的組態檔。
步驟2:下載設定檔
下載工作區組態檔。 將此檔案的內容複製並貼到Commerce管理員的 服務帳戶/認證詳細資料 頁面。
-
在Commerce管理員中,瀏覽至 商店 >設定> 設定 > 服務 > Data Connection。
-
選取您從 Adobe Developer Authorization Type 功能表實作的伺服器對伺服器授權方法。 Adobe建議使用OAuth。 已棄用JWT。 深入瞭解。
-
(僅限JWT)將
private.key
檔案的內容複製並貼到 使用者端密碼 欄位。 使用下列指令來複製內容。code language-bash cat config/private.key | pbcopy
請參閱服務帳戶(JWT)驗證,以取得有關
private.key
檔案的詳細資訊。 -
將
<workspace-name>.json
檔案的內容複製到 服務帳戶/認證詳細資料 欄位。{width="700" modal="regular"}
-
按一下 儲存設定。
-
按一下 Test connection 按鈕,確定您輸入的服務帳戶與認證資訊正確無誤。
一般
-
在Admin中,移至 系統 >服務> Data Connection。
{width="700" modal="regular"}
-
在「一般」下的「設定」標籤上,確認與您的Adobe Experience Platform帳戶相關聯的ID (如Commerce Services Connector中所設定)。 組織ID為全域。 每個Adobe Commerce例項只能關聯一個組織ID。
-
在 領域 下拉式清單中,將內容設定為 網站。
-
(選擇性)如果您已將AEP Web SDK (alloy)部署至您的網站,請啟用核取方塊並新增AEP Web SDK的名稱。 否則,請將這些欄位留空,Data Connection擴充功能會為您部署一個擴充功能。
note note NOTE 如果您指定自己的AEP Web SDK,Data Connection擴充功能會使用與該SDK相關聯的資料流ID,而非此頁面上指定的資料流ID (如果有的話)。
資料彙集
您可以在此段落中指定您要收集並傳送至Experience Platform邊緣的資料型別。 有三種型別的資料:
若要確保您的Adobe Commerce執行個體可以開始資料收集,請檢閱必要條件。
-
若要傳送店面行為資料,請選取 店面活動。
-
如果您要傳送訂單狀態資訊,例如訂單已下達、已取消、已退款或已出貨,請選取 後台事件。
note note NOTE 如果您選取 後台事件,所有後台資料都會傳送到Experience Platform邊緣。 如果購物者選擇退出資料收集,您必須在Experience Platform中明確設定購物者的隱私權偏好設定。 這與店面事件不同,店面事件收集器已根據購物者偏好設定處理同意。 深入瞭解在Experience Platform中設定購物者的隱私權偏好設定。 -
(如果您使用自己的AEP Web SDK,請略過此步驟。) 在Adobe Experience Platform中建立資料流,或選取要用於集合的現有資料流。 在 資料流識別碼 欄位中輸入該資料流識別碼。
-
輸入您要包含Commerce資料的 資料集識別碼。 若要尋找資料集ID:
- 開啟Experience PlatformUI,然後在左側導覽中選取 資料集 以開啟 資料集 儀表板。 控制面板會列出貴組織的所有可用資料集。 系統會顯示每個列出資料集的詳細資料,包括其名稱、資料集所遵守的結構描述,以及最近一次擷取執行的狀態。
- 開啟與資料流相關聯的資料集。
- 在右側窗格中,檢視資料集的詳細資訊。 複製資料集ID
-
若要確保根據cron工作的排程更新後台事件資料,您必須將
Sales Orders Feed
索引變更為Update by Schedule
。-
在 管理員 側邊欄上,移至 System > Tools>Index Management。
-
選取
Sales Orders Feed
索引器的核取方塊。 -
將 Actions 設為
Update by Schedule
。 -
如果您是第一次啟用後台資料,請執行以下命令來重新索引並觸發重新同步。 只要cron工作設定正確,後續的重新同步就會自動發生。
code language-bash bin/magento index:reindex sales_order_data_exporter_v2
code language-bash bin/magento saas:resync --feed orders
-
欄位說明
上線後,店面資料開始流入Experience Platform邊緣。 後端辦公室資料大約需要5分鐘才會顯示在邊緣。 後續更新會根據cron排程顯示在邊緣。
傳送客戶設定檔資料
您可傳送兩種型別的設定檔資料至Experience Platform:設定檔記錄和時間序列設定檔事件。
個人資料記錄包含購物者在Commerce執行個體中建立個人資料時所儲存的資料,例如購物者的姓名。 當您的結構描述和資料集已正確設定時,設定檔記錄會傳送至Experience Platform並轉送至Adobe的設定檔管理和細分服務: Real-Time CDP。
時間序列設定檔事件包含購物者設定檔資訊的相關資料,例如是否他們在您的網站上建立、編輯或刪除帳戶。 將設定檔事件資料傳送至Experience Platform時,該資料會位於資料集中,以供其他DX產品使用。
-
請確定您已提供個服務帳戶和認證詳細資料。
-
確定您有為設定檔記錄資料擷取和時間序列設定檔事件資料擷取指定的結構描述和資料集。
-
如果您要傳送設定檔資料給Experience Platform,請在 客戶設定檔 核取方塊中加上核取記號。
-
輸入 設定檔資料集識別碼。
個人檔案記錄資料使用的資料集必須與您目前用於行為和後台事件資料的資料集不同。
-
如果您不想透過用於行為和後台資料的相同資料流ID串流設定檔事件,請透過相同的資料流ID 從 串流客戶設定檔中移除核取記號,然後輸入您要改用的資料流ID。
在Real-Time CDP中使用設定檔記錄大約需要10分鐘。 設定檔事件會立即開始串流。
欄位說明
傳送歷史訂單資料
Adobe Commerce最多會收集五年的歷史訂單資料和狀態。 您可以使用Data Connection擴充功能將該歷史資料傳送至Experience Platform,讓您的客戶設定檔更為豐富,並根據這些過去的訂單來個人化客戶體驗。 資料儲存在Experience Platform內的資料集中。
雖然Commerce已收集歷史訂單資料,但您必須完成數個步驟,才能將該資料傳送至Experience Platform。
觀看此影片以進一步瞭解歷史訂單,然後完成下列步驟以實施歷史訂單收集。
設定Order Sync服務
訂單同步服務使用訊息佇列架構與RabbitMQ。 完成這些步驟後,訂單狀態資料可以同步至SaaS,這會在傳送至Experience Platform之前是必要的。
啟用訂單同步服務後,您就可以在 Data Connection 頁面中指定歷史訂單日期範圍。
指定訂單歷史記錄日期範圍
指定您要傳送給Experience Platform之歷史訂單的日期範圍。
-
在Admin中,移至 系統 >服務> Data Connection。
-
選取「訂單歷史記錄」標籤。
{width="700" modal="regular"}
-
在 訂單歷程記錄同步 下,從設定複製資料集ID 核取方塊已經啟用。 這可確保您使用的資料集與 設定 索引標籤中指定的資料集相同。
-
在 From 與 To 欄位中,指定您要傳送之歷史訂單資料的日期範圍。 您無法選取超過五年的日期範圍。
-
選取 Start Sync 以觸發同步處理開始。 歷史訂單資料是批次處理資料,而非使用串流資料的店面和後台資料。 批次資料需約45分鐘才能送達Experience Platform。
欄位說明
資料自訂
在 資料自訂 索引標籤上,您可以檢視Commerce中設定並傳送給Experience Platform的任何自訂屬性。
{width="700" modal="regular"}
建立訂單的自訂屬性並將其傳送至Experience Platform時,Commerce中的屬性名稱必須與Experience Platform上Commerce結構描述中的屬性名稱相符。 如果兩者不符,就很難辨識差異。 如果名稱不相符,自訂訂單屬性 表格可協助解決問題。
自訂訂單屬性 表格可顯示Commerce後台與Experience Platform中的Commerce結構描述之間的自訂訂單屬性組態與對應。 此表格可讓您檢視不同來源的訂單層次與訂單料號層次自訂屬性,讓您更容易識別遺失或不對齊的屬性。 它也會顯示資料集ID,以協助區分即時和歷史資料集,因為每個資料集都可以有自己的自訂屬性。
如果您在表格中的自訂屬性名稱旁邊沒有看到綠色核取記號,表示來源中的屬性名稱不符。 在一個來源中更正屬性名稱,將會出現綠色核取記號,表示名稱現在相符。
- 如果屬性名稱在Experience Platform的結構描述中更新,您必須將組態儲存在 資料自訂 索引標籤上,以觸發Experience Platform結構描述變更。 當您按一下 Refresh 按鈕時,此變更將會反映在 自訂訂單屬性 表格中。
- 如果屬性名稱在Commerce中更新,則必須產生訂單事件以更新 自訂訂單屬性 資料表中的名稱。 此變更將在60分鐘左右反映出來。
深入瞭解如何設定自訂屬性。
欄位說明
確認已收集事件資料
若要確認正在從您的Commerce存放區收集資料,請使用Adobe Experience Platform Debugger來檢查您的Commerce網站。 確認資料正在收集後,您可以執行查詢,從您建立的資料集傳回資料,以確認店面和後台事件資料是否出現在邊緣。
-
在Experience Platform的左側導覽中選取 查詢,然後按一下Create Query。
-
當查詢編輯器開啟時,輸入從資料集中選取資料的查詢。
例如,您的查詢可能如下所示:
code language-sql SELECT * from `your_dataset_name` ORDER by TIMESTAMP DESC
-
查詢執行之後,結果會顯示在 主控台 標籤旁邊的 結果 標籤中。 此檢視顯示查詢的表格輸出。
在此範例中,您會看到來自commerce.productListAdds
、commerce.productViews
、web.webpagedetails.pageViews
等的事件資料。 此檢視可讓您驗證Commerce資料是否到達邊緣。
如果結果不符合您的預期,請開啟您的資料集並尋找任何失敗的批次匯入。 深入瞭解疑難排解批次匯入。
驗證設定檔資料是否出現在Experience Platform中
如果您在Experience Platform中看不到設定檔資料,請參閱Commerce知識庫以取得疑難排解建議。
後續步驟
將Commerce資料傳送至Experience Platform邊緣時,其他Adobe Experience Cloud產品(例如Adobe Journey Optimizer)可以使用該資料。 例如,您可以設定Journey Optimizer監聽特定事件,並根據該事件資料為首次使用者或如果有捨棄的購物車時,觸發電子郵件。 瞭解如何透過在Journey Optimizer中建立客戶歷程來擴充您的Commerce平台。