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。 此值稍後將用於取得RegionEndpoint的值。
選取以檢視服務金鑰的範例
code language-json
{
    "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訂閱帳單中建立自訂參考的位置的影像。

如需其他指南,請參閱SAP Subscription Billing 自訂參考資料檔案。

收集必要的認證 gather-credentials

若要將SAP Commerce連線至Experience Platform,您必須提供下列連線屬性的值:

認證
說明
用戶端 ID
服務金鑰中的clientId值。
用戶端密碼
服務金鑰中的clientSecret值。
端點
服務機碼中的url值類似https://subscriptionbilling.authentication.eu10.hana.ondemand.com
區域
您的資料中心位置。 區域出現在url中,其值類似於eu10us10。 例如,如果urlhttps://eu10.revenue.cloud.sap/api,您需要eu10

護欄 guardrails

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

支援的身分 supported-identities

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

目標身分
說明
考量事項
customerNumberSAP
您SAP Commerce帳戶中已有個人或企業客戶的客戶識別碼。
強制

支援的對象 supported-audiences

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

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

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

客群類型
支援
說明
Segmentation Service
✓ (A)
透過Experience Platform細分服務產生的對象。
自訂上傳
✓ (A)
對象從CSV檔案匯入至Experience Platform。

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

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

項目
類型
附註
匯出類型
以設定檔為基礎
  • 您正在匯出對象的所有成員,以及所需的結構描述欄位​ (例如:電子郵件地址、電話號碼、姓氏) (根據您的欄位對應)。
  • 針對Platform中選取的每個對象,相對應的SAP Commerce個額外屬性會從Platform更新其對象狀態。
匯出頻率
串流
  • 串流目的地是「一律開啟」的API型連線。 當根據對象評估在Experience Platform中更新設定檔時,聯結器會將更新傳送至下游的目標平台。 深入瞭解串流目的地

連線到目標 connect

IMPORTANT
若要連線到目的地,您需要​ 管理目的地 存取控制許可權。 閱讀存取控制總覽或連絡您的產品管理員以取得必要的許可權。

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

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

驗證目標 authenticate

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

欄位
說明
使用者端識別碼
服務金鑰中的clientId值。
使用者端密碼
服務金鑰中的clientSecret值。
端點
服務機碼中的url值類似https://subscriptionbilling.authentication.eu10.hana.ondemand.com
地區
您的資料中心位置。 區域出現在url中,其值類似於eu10us10。 例如,如果urlhttps://eu10.revenue.cloud.sap/api,您需要eu10

若要驗證到目的地,請選取​ 連線到目的地
顯示如何驗證目的地的Platform UI影像。

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

填寫目標詳細資訊 destination-details

若要設定目的地的詳細資訊,請填寫下方的必填和選用欄位。 UI中欄位旁的星號表示該欄位為必填欄位。
來自Platform UI的影像,顯示驗證後要填寫的目的地詳細資料。

  • 名稱:您日後可辨識此目的地的名稱。
  • 描述:可協助您日後識別此目的地的描述。
  • 客戶型別:根據您對象內的實體,選取​ 個人 ​或​ 公司。 SAP Subscription Billing 結構描述會根據對應至customerType屬性的這個選取專案切換必要欄位。 如果選取專案是​ 公司,則會忽略個別客戶所需的強制對應,例如firstNamelastName,且company會成為強制對應,反之亦然。

啟用警示 enable-alerts

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

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

啟動此目標的對象 activate

IMPORTANT
  • 若要啟用資料,您需要​ 檢視目的地啟用目的地檢視設定檔 ​和​ 檢視區段 存取控制許可權。 閱讀存取控制總覽或連絡您的產品管理員以取得必要的許可權。
  • 若要匯出​ 身分,您需要​ 檢視身分圖表 存取控制許可權
    選取工作流程中反白的身分名稱空間,以啟用目的地的對象。 {width="100" modal="regular"}

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

對應屬性和身分 map

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

對應customerNumberSAP身分

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

  1. 在​ 對應 ​步驟中,選取​ 新增對應。 您現在可以在畫面上看到新的對應列。
    Platform UI熒幕擷取畫面,其中反白顯示新增對應按鈕。
  2. 在​ 選取來源欄位 ​視窗中,選擇​ 選取身分名稱空間 ​並選取customerNumberSAP
    平台UI熒幕擷圖選取電子郵件作為來源屬性,以對應為身分。
  3. 在​ 選取目標欄位 ​視窗中,選擇​ 選取身分名稱空間 ​並選取customerNumber身分。
    Platform UI熒幕擷圖選取電子郵件作為目標屬性,以對應為身分。
來源欄位
目標欄位
強制
IdentityMap: customerNumberSAP
Identity: customerNumber

具有身分對應的範例如下所示:
來自Platform UI的影像,顯示customerNumber身分對應範例。

對應屬性

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

  1. 在​ 對應 ​步驟中,選取​ 新增對應。 您現在可以在畫面上看到新的對應列。
    Platform UI熒幕擷取畫面,其中反白顯示新增對應按鈕。
  2. 在​ 選取來源欄位 ​視窗中,選擇​ 選取屬性 ​類別並選取XDM屬性。
    平台UI熒幕擷圖選取姓氏作為來源屬性。
  3. 在​ 選取目標欄位 ​視窗中,選擇​ 選取自訂屬性 ​類別,並從客戶結構描述屬性清單中輸入SAP Subscription Billing屬性的名稱。
    將lastName定義為目標屬性的平台UI熒幕擷取畫面。
IMPORTANT
目標欄位名稱區分大小寫,且應符合SAP Subscription Billing屬性名稱。 唯一的例外是country,您應該改用countryCode。 SAP Subscription Billing支援alpha-2 (ISO 3166)國家/地區代碼。 值區分大小寫,且必須介於0到3個字元之間,因此請確定您所提供的內容與定義完全相同,否則您會遇到錯誤: The country code {} does not existsize 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

以下是客戶為個人的強制和選用屬性對應的範例:
來自Platform UI的影像,顯示具有強制和選擇性屬性對應的範例,其中客戶為個人。

公司客戶
table 0-row-3 1-row-3 2-row-3
來源欄位 目標欄位 強制
xdm: workAddress.street1 Attribute: street
xdm: workAddress.city Attribute: city

以下是客戶為公司的具有強制和選擇性屬性對應的範例:
來自Platform UI的影像,顯示具有強制和選擇性屬性對應的範例,其中客戶為公司。

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

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

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

以下顯示反白顯示SAP Commerce 對應ID ​位置的排程對象匯出步驟範例:
來自Platform的影像,顯示填入對應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訂閱帳單中建立自訂參考的位置的影像。

已選取某個對象,並反白顯示其對應的SAP Commerce 對應ID ​的「排程」對象匯出步驟的範例如下:
來自Platform的影像,顯示填入對應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帳戶,然後導覽至​ 連絡人 ​頁面以檢查對象狀態。 清單可設定為顯示自訂參考的欄,並顯示對應的對象狀態。
SAP訂閱帳單影像,顯示客戶概觀頁面,其欄標題顯示對象名稱和儲存格對象狀態

資料使用與控管 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 月 首次發行 初始目的地版本和檔案發佈。
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6