SAP Commerce個連線
SAP Commerce (先前稱為Hybris)是適用於B2B和B2C企業的雲端型電子商務平台解決方案,可作為SAP客戶體驗產品組合的一部分提供。 SAP 訂閱帳單是產品組合下的產品,可透過標準化的整合,透過簡化的銷售和付款體驗來啟用完整的訂閱生命週期管理。
此Adobe Experience Platform 目的地使用SAP Subscription Billing 客戶管理API,在啟用後於SAP Commerce內從現有的Experience Platform對象更新您的客戶詳細資料。
向目的地驗證區段中進一步說明如何向您的SAP Commerce執行個體進行驗證。
使用案例 use-cases
為協助您更清楚瞭解您應如何及何時使用SAP Commerce目的地,以下是Adobe Experience Platform客戶可藉由使用此目的地解決的範例使用案例。
SAP Commerce客戶會儲存與您業務互動的個人或組織實體的相關資訊。 您的團隊使用SAP Commerce中現有的客戶來建置Experience Platform對象。 將這些對象傳送到SAP Commerce後,其資訊會更新,並且會為每個客戶指派屬性,其值會作為對象名稱,指出客戶屬於哪個對象。
先決條件 prerequisites
請參閱以下各節,瞭解您必須在Experience Platform和SAP Commerce中設定的任何先決條件,以及使用SAP Commerce目的地之前必須收集的資訊。
Experience Platform必要條件 prerequisites-in-experience-platform
在啟用資料至SAP Commerce目的地之前,您必須在Experience Platform中建立結構描述、資料集和對象。
如果您需要對象狀態的指引,請參閱對象成員資格詳細資料結構描述欄位群組的Experience Platform檔案。
SAP Commerce目的地的先決條件 prerequisites-destination
若要將資料從Platform匯出至您的SAP Commerce帳戶,請注意下列必要條件:
您必須擁有SAP Subscription Billing帳戶 prerequisites-account
若要將資料從Platform匯出至您的SAP Commerce帳戶,您需要有SAP Subscription Billing帳戶。 如果您沒有有效的帳單帳戶,請連絡您的SAP帳戶管理員。 如需其他詳細資訊,請參閱SAP 平台組態檔案。
產生服務金鑰 prerequisites-service-key
-
SAP Commerce服務金鑰可讓您透過Experience Platform存取SAP Subscription Billing API。 請參考SAP Commerce 使用使用者端ID和使用者端密碼建立服務金鑰,以建立服務金鑰。 SAP Commerce 需要下列項目:
- 用戶端 ID
- 用戶端密碼
- URL。 URL模式如下:
https://subscriptionbilling.authentication.eu10.hana.ondemand.com
。 此值稍後將用於取得Region
和Endpoint
的值。
code language-json |
---|
|
在SAP Subscription Billing中建立自訂參考 prerequisites-custom-reference
若要在SAP Subscription Billing中更新Experience Platform對象狀態,您需要在Platform中為每個選取的對象設定一個自訂參考欄位。
若要建立自訂參考,請登入您的SAP Subscription Billing帳戶,並導覽至 [主要資料和組態] > [自訂參考] 頁面。 接著,選取「建立」,為Platform中選取的每個對象新增參考。 在後續排程對象匯出和範例步驟中,您將需要這些參考欄位名稱。
以下顯示如何在SAP Subscription Billing內建立自訂 參考型別 的範例:
如需其他指南,請參閱SAP Subscription Billing 自訂參考資料檔案。
收集必要的認證 gather-credentials
若要將SAP Commerce連線至Experience Platform,您必須提供下列連線屬性的值:
clientId
值。clientSecret
值。url
值類似https://subscriptionbilling.authentication.eu10.hana.ondemand.com
。url
中,其值類似於eu10
或us10
。 例如,如果url
是https://eu10.revenue.cloud.sap/api
,您需要eu10
。護欄 guardrails
對SAP Cloud Management service的API要求受限於速率限制。 超過速率限制時,您會遇到HTTP 429 Too Many Requests
回應狀態代碼。
支援的身分 supported-identities
SAP Commerce支援下表中描述的身分更新。 深入瞭解身分。
customerNumberSAP
支援的對象 supported-audiences
本節說明您可以匯出至此目的地的所有對象。
此目的地支援啟動所有透過Experience Platform細分服務產生的對象。
此目的地也支援下表所述的對象啟用。
匯出型別和頻率 export-type-frequency
請參閱下表以取得目的地匯出型別和頻率的資訊。
- 您正在匯出對象的所有成員,以及所需的結構描述欄位 (例如:電子郵件地址、電話號碼、姓氏) (根據您的欄位對應)。
- 針對Platform中選取的每個對象,相對應的SAP Commerce個額外屬性會從Platform更新其對象狀態。
連線到目標 connect
若要連線到此目的地,請依照目的地組態教學課程中所述的步驟進行。 在設定目標工作流程中,填寫以下兩個區段中列出的欄位。
在 目的地 > 目錄 內,搜尋SAP Commerce。 或者,您可以在 電子商務 類別下找到它。
驗證目標 authenticate
填寫以下必填欄位。 如需任何指引,請參閱產生服務金鑰區段。
clientId
值。clientSecret
值。url
值類似https://subscriptionbilling.authentication.eu10.hana.ondemand.com
。url
中,其值類似於eu10
或us10
。 例如,如果url
是https://eu10.revenue.cloud.sap/api
,您需要eu10
。若要驗證到目的地,請選取 連線到目的地。
如果提供的詳細資料有效,UI會顯示帶有綠色勾號的 已連線 狀態。 然後您可以繼續下一步驟。
填寫目標詳細資訊 destination-details
若要設定目的地的詳細資訊,請填寫下方的必填和選用欄位。 UI中欄位旁的星號表示該欄位為必填欄位。
- 名稱:您日後可辨識此目的地的名稱。
- 描述:可協助您日後識別此目的地的描述。
- 客戶型別:根據您對象內的實體,選取 個人 或 公司。 SAP Subscription Billing 結構描述會根據對應至
customerType
屬性的這個選取專案切換必要欄位。 如果選取專案是 公司,則會忽略個別客戶所需的強制對應,例如firstName
和lastName
,且company
會成為強制對應,反之亦然。
啟用警示 enable-alerts
您可以啟用警報以接收有關傳送到您目的地的資料流狀態的通知。 從清單中選取警報以訂閱接收有關資料流狀態的通知。 如需警示的詳細資訊,請參閱使用UI訂閱目的地警示的指南。
當您完成提供目的地連線的詳細資訊後,請選取 下一步。
啟動此目標的對象 activate
閱讀將設定檔和對象啟用至串流對象匯出目的地,以瞭解啟用此目的地對象的指示。
對應屬性和身分 map
若要將對象資料從Adobe Experience Platform正確傳送至SAP Commerce目的地,您必須完成欄位對應步驟。 對應包括在Platform帳戶中的Experience Data Model (XDM)結構描述欄位與來自目標目的地的對應對應專案之間建立連結。 若要將您的XDM欄位正確對應到SAP Commerce目的地欄位,請遵循下列步驟:
對應customerNumberSAP
身分
customerNumberSAP
識別是這個目的地的必要對應。 請依照下列步驟進行對應:
- 在 對應 步驟中,選取 新增對應。 您現在可以在畫面上看到新的對應列。
- 在 選取來源欄位 視窗中,選擇 選取身分名稱空間 並選取
customerNumberSAP
。
- 在 選取目標欄位 視窗中,選擇 選取身分名稱空間 並選取
customerNumber
身分。
IdentityMap: customerNumberSAP
Identity: customerNumber
具有身分對應的範例如下所示:
對應屬性
若要在XDM設定檔結構描述與SAP Subscription Billing帳戶之間新增任何其他要更新的屬性,請重複下列步驟:
- 在 對應 步驟中,選取 新增對應。 您現在可以在畫面上看到新的對應列。
- 在 選取來源欄位 視窗中,選擇 選取屬性 類別並選取XDM屬性。
- 在 選取目標欄位 視窗中,選擇 選取自訂屬性 類別,並從客戶結構描述屬性清單中輸入SAP Subscription Billing屬性的名稱。
country
,您應該改用countryCode
。 SAP Subscription Billing支援alpha-2 (ISO 3166)國家/地區代碼。 值區分大小寫,且必須介於0到3個字元之間,因此請確定您所提供的內容與定義完全相同,否則您會遇到錯誤: The country code {} does not exist
或size must be between 0 and 3
。對應所選客戶型別的mandatory
屬性
強制屬性對應取決於您選取的 客戶 型別。 若要對應必要屬性,請從下列選項中選取:
table 0-row-3 1-row-3 2-row-3 | ||
---|---|---|
來源欄位 | 目標欄位 | 強制 |
xdm: person.lastName |
Attribute: lastName |
是 |
xdm: workAddress.countryCode |
Attribute: countryCode |
是 |
table 0-row-3 1-row-3 2-row-3 | ||
---|---|---|
來源欄位 | 目標欄位 | 強制 |
xdm: b2b.companyName |
Attribute: company |
是 |
xdm: workAddress.countryCode |
Attribute: countryCode |
是 |
對應其他屬性
然後,您可以在XDM設定檔結構描述與客戶的SAP Subscription Billing 結構描述屬性之間新增任何其他對應,如下所示:
table 0-row-3 1-row-3 2-row-3 3-row-3 | ||
---|---|---|
來源欄位 | 目標欄位 | 強制 |
xdm: person.name.firstName |
Attribute: firstName |
無 |
xdm: workAddress.street1 |
Attribute: street |
無 |
xdm: workAddress.city |
Attribute: city |
無 |
以下是客戶為個人的強制和選用屬性對應的範例:
table 0-row-3 1-row-3 2-row-3 | ||
---|---|---|
來源欄位 | 目標欄位 | 強制 |
xdm: workAddress.street1 |
Attribute: street |
無 |
xdm: workAddress.city |
Attribute: city |
無 |
以下是客戶為公司的具有強制和選擇性屬性對應的範例:
當您完成提供目的地連線的對應時,請選取 下一步。
排程對象匯出和範例 schedule-segment-export-example
執行排程對象匯出步驟時,您必須手動將Platform對象對應到SAP Subscription Billing中的屬性。
以下顯示反白顯示SAP Commerce 對應ID 位置的排程對象匯出步驟範例:
若要這麼做,請選取每個區段,然後在SAP Commerce 對應ID 目的地聯結器欄位中,輸入來自SAP Subscription Billing的自訂參考名稱。 如需建立自訂參考的指引,請參閱在 SAP Subscription Billing中建立自訂參考區段。
![影像指示您不應該使用自訂參考標籤值來對應。](./media_1e8ab7aa5d6d02ba2078cebf94a546a4da1b68d4b.png?width=750&format=png&optimize=medium)
例如,若您選取的Experience Platform對象為sap_audience1
,而您想要將其狀態更新為SAP Subscription Billing自訂參考SAP_1
,請在SAP_Commerce 對應ID 欄位中指定此值。
以下顯示來自SAP Subscription Billing的範例 參考型別:
已選取某個對象,並反白顯示其對應的SAP Commerce 對應ID 的「排程」對象匯出步驟的範例如下:
如圖所示,對應ID 欄位中的值應完全符合SAP Subscription Billing 參考型別 值。
對每個已啟用的平台對象重複此章節。
根據上方顯示的影像,您已選取兩個對象,對應將會如下所示:
| SAP Commerce對象名稱 | SAP Subscription Billing 參考型別 | SAP Commerce 對應ID 值 |
| — | — | — |
| sap_audience1 | SAP_1
| SAP_1
|
| SAP對象2 | SAP_2
| SAP_2
|
驗證資料匯出 exported-data
若要驗證您是否已正確設定目的地,請遵循下列步驟:
登入SAP Subscription Billing帳戶,然後導覽至 連絡人 頁面以檢查對象狀態。 清單可設定為顯示自訂參考的欄,並顯示對應的對象狀態。
資料使用與控管 data-usage-governance
處理您的資料時,所有Adobe Experience Platform目的地都符合資料使用原則。 如需Adobe Experience Platform如何強制資料控管的詳細資訊,請參閱資料控管概觀。
錯誤與疑難排解 errors-and-troubleshooting
請參閱SAP Subscription Billing 錯誤型別檔案頁面,以取得可能的錯誤型別及其回應代碼清單。
其他資源 additional-resources
SAP檔案中的其他實用資訊如下:
Changelog
本節擷取此目的地聯結器的功能和重要檔案更新。
table 0-row-3 1-row-3 layout-auto | ||
---|---|---|
發行月份 | 更新型別 | 說明 |
2024 年 1 月 | 首次發行 | 初始目的地版本和檔案發佈。 |