PLP 상품 그리드 내 고정된 위치에 프로모션 카드를 노출하는 기능.
Strapi CMS에서 URL 기준으로 관리하며, 필수 기능이 아니라 필요한 PLP에만 등록해 운영한다.
| Slot |
상품 그리드 내 위치 |
| slot-1 |
3번째 |
| slot-2 |
8번째 |
| slot-3 |
15번째 |
- 상품 수가 해당 위치보다 적으면 해당 슬롯 미노출
- Load More 이후 추가 카드 삽입 없음 (첫 페이지에만 적용)
- Hero와 동일한 URL Mapping 구조 사용
- 하나의 카드를 여러 URL에 재사용 가능
- URL 우선순위: 상세 URL 먼저 → 없으면 상위 URL 사용
- 예:
/drinkware/hydration 전용 카드 없으면 /drinkware 공통 카드 사용
| 조건 |
처리 |
| URL 매칭 실패 |
카드 미노출 |
| 해당 슬롯 데이터 없음 |
해당 슬롯 skip |
is_active = false |
미노출 |
| API 호출 실패 |
카드만 미노출, 상품 그리드 정상 유지 |
카드 오류가 상품 그리드 전체 렌더링 실패로 이어지면 안 됨
| 필드 |
타입 |
필수 |
설명 |
| media_type |
Select |
O |
image / video |
| image |
Media |
조건부 |
image 타입일 때 |
| video_url |
Text |
조건부 |
video 타입일 때 |
| thumbnail |
Media |
조건부 |
video 타입일 때 썸네일/fallback |
| 필드 |
타입 |
필수 |
설명 |
| badge |
Enum |
X |
배지 타입 |
| title |
Text |
X |
제목 |
| description |
Text |
X |
설명 |
| 필드 |
타입 |
필수 |
설명 |
| cta_label |
Text |
O |
버튼 텍스트 |
| cta_link |
Text |
O |
버튼 이동 URL |
| cta_text_color |
Text |
X |
버튼 텍스트 색상 (기본: white) |
| cta_background_color |
Text |
X |
버튼 배경 색상 (기본: 테마 컬러) |
| 필드 |
타입 |
필수 |
설명 |
| urls |
Repeatable Text |
O |
카드 노출 PLP URL 목록 |
| slot |
Enum |
O |
slot-1 / slot-2 / slot-3 |
| is_active |
Boolean |
O |
노출 여부 |
| 조건 |
처리 |
| media_type = video |
autoplay / muted / loop |
| video 재생 실패 |
thumbnail으로 대체 |
| badge 존재 |
미디어 위 표시 |
| title 존재 |
오버레이 표시 |
| description 존재 |
title 아래 표시 |
| cta_text_color 미입력 |
기본 white |
| cta_background_color 미입력 |
기본 테마 컬러 |
| 버전 |
날짜 |
변경 내용 |
| v1.0 |
2026-06-24 |
최초 작성 |