적격 프로모션 API
적격 프로모션 API를 사용하여 고객에게 고객 장바구니에 적격인 프로모션 목록을 제공합니다. API는 연락처, 계정 및 충성도 프로그램 구성원에 대한 적격 프로모션 목록을 가져올 수 있습니다.
필수 Edition
| 지원 제품: Lightning Experience |
| 지원 제품: 실시간 프로모션 관리 기능을 갖춘 엔터프라이즈, 무제한 및 개발자 에디션 |
고객에게 장바구니에 적격한 프로모션 목록을 제공합니다. API는 요청으로 고객의 장바구니 세부 사항을 가져오고 응답으로 장바구니에 대한 적격 활성 프로모션 세부 사항을 제공합니다. 항목에 대한 적격 프로모션을 찾을 때 API가 제품의 범주 계층의 5개 수준을 스캔합니다.
장바구니에 Salesforce 카탈로그에 없는 제품이 포함되어 있는 경우 API는 행 수준 및 교차 행 수준 프로모션을 평가하면서 동기화되지 않은 제품을 무시하고 장바구니에 적합한 프로모션을 표시합니다.
조직에 글로벌 프로모션 관리 유형 규칙 라이브러리가 여러 개 있는 경우 시스템 통합자가 API가 실행하는 규칙 라이브러리를 지정해야 합니다. 또한 API 요청에 장바구니를 평가하기 위해 규칙 라이브러리의 컨텍스트 정의에 필요한 값이 포함되어 있는지 확인해야 합니다.
API 응답은 다음 프로모션 세부 사항을 제공합니다.
- 시작 및 종료 일자와 같은 프로모션의 기본 세부 사항
- 프로모션의 사용자 정의 필드 값
- 프로모션 제한
- 고객의 장바구니에 적격한 프로모션 규칙
- 프로모션 컨텍스트 정의에 매핑되는 프로모션의 사용자 정의 필드 값입니다.
고객에게 적격 프로모션을 실시간으로 제공하려면 적격 프로모션 API를 고객 장바구니를 관리하는 외부 시스템과 통합합니다. 적격 프로모션을 참조하십시오.
프로모션 사용이 특정 장바구니에 대한 프로모션 제한을 충족하면 적격 프로모션 API가 API 출력에서 고객에게 보상을 제공하지 않습니다. 고객의 보상 사용이 프로모션의 고객 수준 제한을 충족하면 적격 프로모션 API가 더 이상 고객에게 보상을 제공하지 않습니다.
다음은 Cloud Kicks의 온라인 쇼핑 사이트에서 API가 실행될 때 적격 프로모션 API의 요청이 표시되는 방식입니다.
{
"cart":{
"Accessory":[
{
"activityStartDate":"2023-06-14T12:45:19Z",
"contactId":"003xx000004WjzAAAS",
"transactionAmount":85,
"currencyISOCode":"INR",
"cartLineDetails":[
{
"CartLineProductCategory":"Sneaker Shields",
"cartLineProductCatalogId:"0ZSSB0000002d8X4AQ"",
"AttributeKey:"Premium"
}
]
}
]
}
}쿠폰이 있는 프로모션에 대한 적격 프로모션 API
쿠폰이 프로모션에 추가되면 적격 프로모션 API가 고객의 장바구니 세부 사항을 요청으로 가져와 고객의 장바구니에 적격한 프로모션에 대한 활성 쿠폰 세부 사항으로 응답합니다. 고객은 장바구니에 적용할 프로모션 쿠폰을 사용할 수 있습니다.
쿠폰을 포함하는 적격 프로모션의 경우 API의 응답에 다음 쿠폰 세부 사항이 포함됩니다.
- 쿠폰 코드
- 시작 및 종료 일자
- 상태
API는 고객의 활동 날짜에 대해 활성 및 유효한 쿠폰이 하나 이상 있는 프로모션만 반환합니다. 프로모션은 여러 쿠폰으로 구성될 수 있지만 API는 다음 시나리오에서 쿠폰 코드를 표시하지 않습니다.
- 활동 날짜에 적격한 활성 쿠폰이 여러 개 있는 경우
- 활동 날짜에 활성화된 쿠폰이 없는 경우
- 적격 활성 쿠폰이 사용 제한에 도달한 경우
