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 目的地,您必須擁有 綱要, a 資料集、和 對象 建立於 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 服務金鑰可讓您存取 SAP Subscription Billing 透過Experience Platform的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

若要更新中的Experience Platform對象狀態 SAP Subscription Billing,您需要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

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

支援的身分 supported-identities

SAP Commerce 支援下表中描述的身分更新。 進一步瞭解 身分.

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

支援的對象 supported-audiences

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

此目的地支援啟用透過Experience Platform產生的所有對象 分段服務.

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

對象型別
說明
Segmentation Service
✓ (A)
自訂上傳

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

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

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

連線到目標 connect

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

若要連線至此目的地,請遵循以下說明的步驟: 目的地設定教學課程. 在設定目標工作流程中,填寫以下兩個區段中列出的欄位。

範圍 目的地 > 目錄,搜尋 SAP Commerce. 或者,您可以在 電子商務 類別。

驗證目標 authenticate

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

欄位
說明
使用者端ID
的值 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屬性。
    Platform UI熒幕擷取畫面選取「姓氏」作為來源屬性。
  3. 選取目標欄位 視窗,選擇 選取自訂屬性 類別並輸入的名稱 SAP Subscription Billing 客戶清單中的屬性 綱要 屬性。
    Platform UI熒幕擷取畫面,其中lastName定義為target屬性。
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

執行 排程對象匯出 步驟,您必須手動將平台對象對應至 屬性 在 SAP Subscription Billing.

排程對象匯出步驟的範例,其位置為 SAP Commerce 對應ID 反白顯示,如下所示:
來自Platform的影像,顯示填入對應ID的排程對象匯出。

要執行此操作,請選取每個區段,然後輸入自訂參照的名稱 SAP Subscription Billing 在 SAP Commerce 對應ID 目的地聯結器欄位。 如需建立自訂參考資料的指引,請參閱 在中建立自訂參考 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