SAP Commerce 연결

이전에 Hybris(으)로 알려졌던 SAP Commerce은(는) B2B 및 B2C 기업을 위한 클라우드 기반 전자 상거래 플랫폼 솔루션이며 SAP Customer Experience 포트폴리오의 일부로 사용할 수 있습니다. SAP 구독 청구는 포트폴리오의 제품이며 표준화된 통합을 통해 간소화된 판매 및 결제 환경을 통해 완전한 구독 라이프사이클 관리를 가능하게 합니다.

이 Adobe Experience Platform 대상은(는) SAP Subscription Billing 고객 관리 API를 사용하여 활성화 후 기존 Experience Platform 대상에서 SAP Commerce 내에 고객 세부 정보를 업데이트합니다.

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

플랫폼에서 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 대상 상태를 업데이트하려면 플랫폼에서 선택한 각 대상에 대해 사용자 지정 참조 필드가 필요합니다.

사용자 지정 참조를 만들려면 SAP Subscription Billing 계정에 로그인하고 [기본 데이터 및 구성] > [사용자 지정 참조] 페이지로 이동하십시오. 그런 다음 만들기 ​를 선택하여 플랫폼에서 선택한 각 대상에 대한 새 참조를 추가합니다. 후속 대상 내보내기 예약 및 예제 단계에서 이러한 참조 필드 이름이 필요합니다.

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에 있으며 eu10 또는 us10과(와) 유사한 값을 갖습니다. 예를 들어 url이(가) https://eu10.revenue.cloud.sap/api이면 eu10이(가) 필요합니다.

가드레일 guardrails

SAP Cloud Management service에 대한 API 요청이 속도 제한을(를) 받습니다. 속도 제한을 초과하면 HTTP 429 Too Many Requests 응답 상태 코드 가 표시됩니다.

지원되는 ID supported-identities

SAP Commerce은(는) 아래 표에 설명된 ID 업데이트를 지원합니다. ID에 대해 자세히 알아보세요.

대상 ID
설명
고려 사항
customerNumberSAP
SAP Commerce 계정에 이미 있는 개인 또는 회사 고객의 고객 식별자입니다.
필수

지원되는 대상자 supported-audiences

이 섹션에서는 이 대상으로 내보낼 수 있는 모든 대상에 대해 설명합니다.

이 대상은 Experience Platform 세그먼테이션 서비스를 통해 생성된 모든 대상의 활성화를 지원합니다.

이 대상은 아래 표에 설명된 대상의 활성화도 지원합니다.

대상자 유형
지원됨
설명
Segmentation Service
✓ 덧신
Experience Platform 세그먼테이션 서비스를 통해 생성된 대상입니다.
사용자 정의 업로드
✓ 덧신
CSV 파일에서 Experience Platform으로 대상 가져옴.

내보내기 유형 및 빈도 export-type-frequency

대상 내보내기 유형 및 빈도에 대한 자세한 내용은 아래 표를 참조하십시오.

항목
유형
참고
내보내기 유형
프로필 기반
  • 필드 매핑에 따라 원하는 스키마 필드 (예: 이메일 주소, 전화번호, 성) ​과(와) 함께 대상자의 모든 구성원을 내보냅니다.
  • 플랫폼에서 선택한 각 대상에 대해 해당 SAP Commerce 추가 특성은 Platform의 대상 상태로 업데이트됩니다.
내보내기 빈도
스트리밍
  • 스트리밍 대상은 "항상" API 기반 연결입니다. 대상자 평가를 기반으로 Experience Platform에서 프로필을 업데이트하면 커넥터가 업데이트 다운스트림을 대상 플랫폼으로 보냅니다. 스트리밍 대상에 대해 자세히 알아보세요.

대상에 연결 connect

IMPORTANT
대상에 연결하려면 대상 관리 액세스 제어 권한이 필요합니다. 액세스 제어 개요를 읽거나 제품 관리자에게 문의하여 필요한 권한을 받으십시오.

이 대상에 연결하려면 대상 구성 자습서에 설명된 단계를 따르십시오. 대상 구성 워크플로에서 아래 두 섹션에 나열된 필드를 채웁니다.

대상 > 카탈로그 내에서 SAP Commerce을(를) 검색합니다. 또는 eCommerce 범주 아래에서 찾을 수 있습니다.

대상으로 인증 authenticate

아래의 필수 필드를 입력하십시오. 자세한 내용은 서비스 키 생성 섹션을 참조하십시오.

필드
설명
클라이언트 ID
서비스 키의 clientId 값입니다.
클라이언트 암호
서비스 키의 clientSecret 값입니다.
끝점
서비스 키의 url 값은 https://subscriptionbilling.authentication.eu10.hana.ondemand.com과(와) 비슷합니다.
지역
데이터 센터 위치. 영역이 url에 있으며 eu10 또는 us10과(와) 유사한 값을 갖습니다. 예를 들어 url이(가) https://eu10.revenue.cloud.sap/api이면 eu10이(가) 필요합니다.

대상에 인증하려면 대상에 연결 ​을 선택하세요.
대상에 인증하는 방법을 보여 주는 Platform UI의 이미지.

제공된 세부 정보가 유효하면 UI에 녹색 확인 표시와 함께 연결됨 상태가 표시됩니다. 그런 다음 다음 다음 단계로 진행할 수 있습니다.

대상 세부 정보 입력 destination-details

대상에 대한 세부 정보를 구성하려면 아래의 필수 및 선택 필드를 채우십시오. UI에서 필드 옆에 있는 별표는 필드가 필수임을 나타냅니다.
인증 후 채울 대상 세부 정보를 표시하는 플랫폼 UI의 이미지.

  • 이름: 나중에 이 대상을 인식할 수 있는 이름입니다.
  • 설명: 나중에 이 대상을 식별하는 데 도움이 되는 설명입니다.
  • 고객 유형: 대상 내의 엔터티에 따라 개인 또는 회사 ​를 선택합니다. SAP Subscription Billing schema은(는) customerType 특성에 매핑된 이 선택 항목에 따라 필수 필드를 전환합니다. 선택 항목이 회사 ​인 경우 개별 고객에 필요한 firstNamelastName과(와) 같은 필수 매핑이 무시되고 company이(가) 필수가 되며 그 반대의 경우도 마찬가지입니다.

경고 활성화 enable-alerts

경고를 활성화하여 대상에 대한 데이터 흐름 상태에 대한 알림을 받을 수 있습니다. 목록에서 경고를 선택하여 데이터 흐름 상태에 대한 알림을 수신합니다. 경고에 대한 자세한 내용은 UI를 사용하여 대상 경고 구독에 대한 안내서를 참조하십시오.

대상 연결에 대한 세부 정보를 모두 제공했으면 다음 ​을 선택합니다.

이 대상으로 대상자 활성화 activate

IMPORTANT
  • 데이터를 활성화하려면 대상 보기, 대상 활성화, 프로필 보기세그먼트 보기 액세스 제어 권한이 필요합니다. 액세스 제어 개요를 읽거나 제품 관리자에게 문의하여 필요한 권한을 받으십시오.
  • ID ​을(를) 내보내려면 ID 그래프 보기 액세스 제어 권한이 필요합니다.
    대상자를 대상으로 활성화하려면 워크플로에서 강조 표시된 ID 네임스페이스를 선택하십시오. {width="100" modal="regular"}

이 대상으로 대상을 활성화하는 방법에 대한 지침은 프로필 및 대상을 스트리밍 대상 내보내기 대상으로 활성화를 참조하십시오.

속성 및 ID 매핑 map

대상 데이터를 Adobe Experience Platform에서 SAP Commerce 대상으로 올바르게 보내려면 필드 매핑 단계를 거쳐야 합니다. 매핑은 Platform 계정의 XDM(Experience Data Model) 스키마 필드와 대상 대상의 해당 필드 간에 링크를 만드는 것으로 구성됩니다. XDM 필드를 SAP Commerce 대상 필드에 올바르게 매핑하려면 아래 단계를 따르십시오.

customerNumberSAP ID 매핑

customerNumberSAP ID는 이 대상에 대한 필수 매핑입니다. 매핑하려면 아래 단계를 따르십시오.

  1. 매핑 단계에서 새 매핑 추가 ​를 선택합니다. 이제 새 매핑 행이 화면에 표시됩니다.
    새 매핑 추가 단추가 강조 표시된 플랫폼 UI 스크린샷입니다.
  2. 소스 필드 선택 창에서 ID 네임스페이스 선택 ​을(를) 선택하고 customerNumberSAP을(를) 선택합니다.
    ID로 매핑할 소스 특성으로 이메일을 선택하는 플랫폼 UI 스크린샷
  3. 대상 필드 선택 창에서 ID 네임스페이스 선택 ​을(를) 선택하고 customerNumber ID를 선택합니다.
    ID로 매핑할 대상 특성으로 이메일을 선택하는 플랫폼 UI 스크린샷
소스 필드
대상 필드
필수
IdentityMap: customerNumberSAP
Identity: customerNumber

다음은 ID 매핑의 예입니다.
customerNumber ID 매핑의 예를 보여 주는 플랫폼 UI의 이미지

속성 매핑

XDM 프로필 스키마와 SAP Subscription Billing 계정 사이에 업데이트할 다른 특성을 추가하려면 아래 단계를 반복합니다.

  1. 매핑 단계에서 새 매핑 추가 ​를 선택합니다. 이제 새 매핑 행이 화면에 표시됩니다.
    새 매핑 추가 단추가 강조 표시된 플랫폼 UI 스크린샷입니다.
  2. 소스 필드 선택 창에서 특성 선택 범주를 선택하고 XDM 특성을 선택합니다.
    성을 소스 특성으로 선택하는 플랫폼 UI 스크린샷
  3. 대상 필드 선택 창에서 사용자 지정 특성 선택 범주를 선택하고 스키마 특성 목록에서 SAP Subscription Billing 특성 이름을 입력하십시오.
    lastName이 대상 특성으로 정의된 플랫폼 UI 스크린샷.
IMPORTANT
대상 필드 이름은 대/소문자를 구분하며 SAP Subscription Billing 특성 이름과 일치해야 합니다. 이에 대한 유일한 예외는 country이며 대신 countryCode을(를) 사용해야 합니다. SAP Subscription Billing은(는) 알파-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 아니요

고객이 개인인 필수 및 선택적 속성 매핑의 예가 아래에 나와 있습니다.
고객이 개인인 필수 및 선택적 특성 매핑의 예를 보여 주는 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 위치가 강조 표시된 대상 내보내기 예약 단계의 예는 다음과 같습니다.
매핑 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 ​가 강조 표시된 대상 내보내기 예약 단계의 예는 다음과 같습니다.
매핑 ID가 채워진 대상자 내보내기 일정을 표시하는 플랫폼의 이미지입니다.

표시된 대로 매핑 ID 필드 내의 값은 SAP Subscription Billing 참조 형식 값과 정확히 일치해야 합니다.

활성화된 각 Platform 대상에 대해 이 섹션을 반복합니다.

두 대상을 선택한 위에 표시된 이미지에 따라 매핑은 다음과 같습니다.
| 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 설명서의 추가 유용한 정보는 다음과 같습니다.

변경 로그

이 섹션에서는 이 대상 커넥터에 대한 기능 및 중요 설명서 업데이트를 캡처합니다.

변경 로그 보기
table 0-row-3 1-row-3 layout-auto
릴리스 월 업데이트 유형 설명
2024년 1월 초기 릴리스 초기 대상 릴리스 및 설명서 게시.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6