행사상품 이미지 설정기능은 특정 행사기간에만 상품 대표이미지를 변경해서 노출할 수 있는 기능입니다.
- 행사 상품 이미지는 행사 기간 동안 사은품 제공, 추첨 경품 이벤트, 상품 구성 변경 (예: 리미티드 에디션, 선물포장 방식 변경 등)이 있을 경우에만 설정할 수 있습니다.
- 행사 상품 이미지가 설정되면 행사 기간 동안 해당 이미지가 기존 상품 이미지(ProductImageView) 대신 노출되며, 행사 종료 후에는 자동으로 해제됩니다.
- 행사 시작일 이후에 승인이 완료된 경우, 승인 시점을 기준으로 행사 상품 이미지가 노출됩니다.
- 이미지 비율 코드는 대표이미지는 필수이며 추가 이미지는 선택사항 입니다.
- 행사 이미지 설정 시 행사 기간 설정은 필수입니다.
- 추가 이미지 항목이 빈 값으로 전달되면 추가 이미지는 그대로 빈 값으로 저장됩니다.
- 대표 이미지의 형태는 Json 내부에 이미지 URL 값을 포함합니다.
주의사항
이미지 URL 은 반드시 이미지업로드 API 로 업로드 후 반환받은 URL 값을 입력하세요.
이미지 업로드 타입은 상품이미지 업로드와 동일하게 ImageType = PRODUCT로 업로드 하세요. 이미지 업로드 API
대표 이미지 및 추가 이미지들은 동일한 URL 형태의 이미지를 허용하지 않습니다.
필드 상세
| 필드명 | 타입 | 설명 |
|---|---|---|
| usePromotionImage | Boolean |
행사 이미지 설정 여부 설정함 (true) 설정안함 (false) |
| imageRatio | ImageRatio |
기본 이미지 비율 코드 * 타입 SQUARE (1:1 비율) 만 선택가능 |
| representImage | RepresentImage |
대표 이미지 정보 - 필드명: url - 타입: String - 설명: 대표 이미지 url * PromotionImageView 타입의 주의사항을 참고하시기 바랍니다. |
| optionalImages | Array<OptionalImage> |
추가 이미지 - 필드명: url - 타입: String - 설명: 추가 이미지 url |
| period | DateTime |
행사 이미지 기간 (행사이미지 최초설정 하거나 기간수정시도할 경우 시작일-종료일은 미래로 설정필수. 기간 최대 90일 이내로만 설정가능) from: 시작시간 to: 종료시간 |