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

{
    "url": "https://eu10.revenue.cloud.sap/api",
    "uaa": {
        "clientid": "XXX",
        "clientsecret": "XXX",
        "url": "https://subscriptionbilling.authentication.eu10.hana.ondemand.com",
        "identityzone": "subscriptionbilling",
        "identityzoneid": "XXX",
        "tenantid": "XXX",
        "tenantmode": "dedicated",
        "sburl": "https://internal-xsuaa.authentication.eu10.hana.ondemand.com",
        "apiurl": "https://api.authentication.eu10.hana.ondemand.com",
        "verificationkey": "XXX",
        "xsappname": "XXX",
        "subaccountid": "XXX",
        "uaadomain": "authentication.eu10.hana.ondemand.com",
        "zoneid": "XXX",
        "credential-type": "binding-secret"
    },
    "vendor": "SAP"
}

在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，您必須提供下列連線屬性的值：

護欄 guardrails

對SAP Cloud Management service的API要求受限於速率限制。 超過速率限制時，您會遇到HTTP 429 Too Many Requests回應狀態代碼。

支援的身分 supported-identities

SAP Commerce支援下表中描述的身分更新。 深入瞭解身分。

支援的對象 supported-audiences

本節說明您可以匯出至此目的地的所有對象。

此目的地支援啟動所有透過Experience Platform細分服務產生的對象。

此目的地也支援下表所述的對象啟用。

匯出型別和頻率 export-type-frequency

請參閱下表以取得目的地匯出型別和頻率的資訊。

連線到目標 connect

若要連線到此目的地，請依照目的地組態教學課程中所述的步驟進行。 在設定目標工作流程中，填寫以下兩個區段中列出的欄位。

在​ 目的地 > 目錄 ​內，搜尋SAP Commerce。 或者，您可以在​ 電子商務 ​類別下找到它。

驗證目標 authenticate

填寫以下必填欄位。 如需任何指引，請參閱產生服務金鑰區段。

若要驗證到目的地，請選取​ 連線到目的地。

如果提供的詳細資料有效，UI會顯示帶有綠色勾號的​ 已連線 ​狀態。 然後您可以繼續下一步驟。

填寫目標詳細資訊 destination-details

若要設定目的地的詳細資訊，請填寫下方的必填和選用欄位。 UI中欄位旁的星號表示該欄位為必填欄位。

啟用警示 enable-alerts

您可以啟用警報以接收有關傳送到您目的地的資料流狀態的通知。 從清單中選取警報以訂閱接收有關資料流狀態的通知。 如需警示的詳細資訊，請參閱使用UI訂閱目的地警示的指南。

當您完成提供目的地連線的詳細資訊後，請選取​ 下一步。

啟動此目標的對象 activate

閱讀將設定檔和對象啟用至串流對象匯出目的地，以瞭解啟用此目的地對象的指示。

對應屬性和身分 map

若要將對象資料從Adobe Experience Platform正確傳送至SAP Commerce目的地，您必須完成欄位對應步驟。 對應包括在Platform帳戶中的Experience Data Model (XDM)結構描述欄位與來自目標目的地的對應對應專案之間建立連結。 若要將您的XDM欄位正確對應到SAP Commerce目的地欄位，請遵循下列步驟：

對應customerNumberSAP身分

customerNumberSAP識別是這個目的地的必要對應。 請依照下列步驟進行對應：

具有身分對應的範例如下所示：

對應屬性

若要在XDM設定檔結構描述與SAP Subscription Billing帳戶之間新增任何其他要更新的屬性，請重複下列步驟：

對應所選客戶型別的mandatory屬性

強制屬性對應取決於您選取的​ 客戶 ​型別。 若要對應必要屬性，請從下列選項中選取：

對應其他屬性

然後，您可以在XDM設定檔結構描述與客戶的SAP Subscription Billing 結構描述屬性之間新增任何其他對應，如下所示：

當您完成提供目的地連線的對應時，請選取​ 下一步。

排程對象匯出和範例 schedule-segment-export-example

執行排程對象匯出步驟時，您必須手動將Platform對象對應到SAP Subscription Billing中的屬性。

以下顯示反白顯示SAP Commerce 對應ID ​位置的排程對象匯出步驟範例：

若要這麼做，請選取每個區段，然後在SAP Commerce 對應ID ​目的地聯結器欄位中，輸入來自SAP Subscription Billing的自訂參考名稱。 如需建立自訂參考的指引，請參閱在 SAP Subscription Billing中建立自訂參考區段。

IMPORTANT

請勿使用自訂參考標籤作為值。

例如，若您選取的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

本節擷取此目的地聯結器的功能和重要檔案更新。