이벤트 참여내역
- 신성석
- X2BEE 관리자
이벤트 참여내역 조회 기능은 로그인한 회원이 '마이페이지 - 참여내역'에서 참여한 이벤트 응모내역을 확인할 수 있습니다. 참여내역은 '이벤트 참여'와 '구매 사은 응모'로 나뉘어지며, '구매 사은 응모'에서는 해당 이벤트 응모 내역만 확인할 수 있습니다.
주요 기능
이벤트 참여내역 조회
로그인한 회원이 참여한 이벤트 목록을 조회합니다.
구매 사은 이벤트 제외한 이벤트 참여내역을 확인합니다.
기간 검색 구분 코드(1주, 1개월, 3개월)로 해당 기간 내의 이벤트 참여내역을 조회합니다.
필터링 구분 코드(당첨, 진행중, 종료)를 받아 해당 조건에 해당하는 이벤트 참여내역을 조회합니다.
구매 사은 이벤트 참여내역 조회
로그인한 회원이 참여한 구매 사은 이벤트 목록을 조회합니다.
기간 검색 구분 코드(1주, 1개월, 3개월)로 해당 기간 내의 구매 사은 이벤트 참여내역을 조회합니다.
필터링 구분 코드(당첨, 진행중, 종료)를 받아 해당 조건에 해당하는 구매 사은 이벤트 참여내역을 조회합니다.
이벤트 배송지 정보 변경
리워드가 경품/사은품인 경우, Default 배송지는 회원의 기본 배송지로 들어갑니다.
이벤트 배송지 저장 API를 통해 변경이 가능하며, 수정 시 리워드 배송지(경품/사은품)가 변경된 주소로 저장됩니다.
프로세스 정의
번호 | 구분 | 설명 |
|---|---|---|
1 | 마이페이지 이동 | 회원이 마이페이지에 접근할 때 로그인 상태일 시 회원의 정보를 노출시켜주고 비로그인 상태일 시 로그인 페이지로 이동됩니다. |
2 | 이벤트 참여내역 | 참여내역 접근 시, 기본 Default값으로 1주 내에 있는 이벤트 참여내역을 조회합니다. 기간 검색 코드 값과 필터링 값(진행중, 종료, 당첨)을 통해 조회 조건을 바꿔 조회가 가능합니다. |
3 | 이벤트 배송지 저장 | 지급이 되지 않았으며, 리워드가 사은품/경품인 경우 수령지 변경 선택을 하여 이벤트 배송지 변경하여 저장할 수 있습니다. |
API 기능 목록
API | 설명 | Server | 메소드 | 비고 |
|---|---|---|---|---|
이벤트 참여내역 조회 | 로그인한 회원의 참여내역을 조회합니다. | Event | GET | |
이벤트 구매 사은 응모 내역 조회 | 로그인한 회원의 구매 사은 응모 내역을 조회합니다. | Event | GET | 주문정보 조회: /api/order/v1/event/evtOrdList 상품요약정보 조회: /api/goods/v1/detail/summary |
이벤트 배송지 저장 | 응모한 회원의 이벤트 배송지를 변경 후 저장합니다. | Event | POST |
용어 정의
명칭 | 설명 | 비고 |
|---|---|---|
전시기간 | 이벤트가 이벤트 목록에서 전시되는 기간을 말합니다. 전시기간이 끝난 이벤트는 상세 진입이 안됩니다. |
|
응모기간(행사기간) | 이벤트 상세 화면에서 응모 버튼 눌렀을때, 응모 할 수 있는 기간을 말합니다. |
|
구매기간 | 이벤트에 적용되는 상품을 구매할 수 있는 기간을 말합니다. |
|
추첨이벤트 | 기업에서 소비자들에게 사은품, 마일리지, 쿠폰 등 다양한 상품을 제공하기 위해 추첨을 통해 선발하는 이벤트를 말합니다 |
|
비추첨이벤트 | 참여자들이 특정 조건을 만족하거나 특별한 활동을 수행함으로써 혜택(쿠폰,마일리지)을 지급하는 이벤트를 말합니다. |
|
이벤트리워드 | 이벤트에 참여한 사람들에게 주어지는 보상이나 혜택을 나타냅니다. |
|
기타 참고사항
이벤트 참여 내역 / 구매 사은 응모 내역 조회
이벤트 참여내역 및 구매 사은 응모 내역 조회에는 기간 검색 구분 코드( periodGb ) 와 필터링 구분 값( filteringGb ) 을 조회 조건으로 받아 조회합니다.
기간 검색 구분 코드 ( periodGb )
0 : 1주일
1 : 1개월
2 : 3개월
3 : 기간검색
필터링 구분 코드 ( filteringGb )
Default : 전체
1 : 당첨된 이벤트
2 : 진행중 이벤트
3 : 종료된 이벤트
이벤트 배송지 저장
이벤트 배송지 저장은 리워드가 사은품/경품 일때만 가능합니다.
이벤트 배송지 저장은 아래의 경우’수령지 변경’버튼이 노출이 안되어 저장이 불가합니다.
지급여부 Y
지급일시 존재
기타사은품배송지번호 존재
이벤트 진행상태(EV005). : 경품발송완료(07)
기타사은품상태코드(LO013) : 배송완료(40)
이벤트 배송지는 CC_EVT_TRGMN_INFO 의 응모자 테이블의 주소 정보가 UPDATE 됩니다.