Schema

이 문서는 Groobee 행동 수집시 사용되는 데이터 스키마에 대해 설명합니다.

Goods

• 상품 정보 스키마입니다.
• cat (카테고리 코드)는 현 상품의 최하위 카테고리 코드와 동일해야합니다.
• 예) catL: 1, catM: 12, catS: 123, catD: 1234 인 경우 cat: 1234
• 예) catL: a, catM: ab, catS: abc 인 경우 cat: abc
• 카테고리 대중소세(catL,catM,catS,catD) 필드 중 하위 카테고리 코드가 있을 경우 상위 카테고리 코드도 함께 전달해주셔야 합니다.
  전달되지 않는 경우 추천 품질에 영향을 미칠 수 있습니다.
• 예) catS 값이 있을 경우 catL, catM 값도 함께 전달
• 장바구니 담기(AC) / 장바구니 제거(DC)에서는 code, prc, cnt가 필수입니다.
  셋 중 하나라도 비어 있거나 0인 상품은 전송에서 제외됩니다.
• attribute는 상품 확장 속성을 담는 객체입니다. 행동 확장 데이터(extraData)와 함께
  👉 확장 필드 (attribute / extraData) 항목을 참고해주세요.

필드명	타입	사용액션						설명	예
		VG	VC	OR	PU	AC	DC
name	String	●	●	●	●	●	●	상품명	화이트 스니커즈
code	String	●	●	●	●	●	●	URL에 표시되는 상품코드	SO0001
amt	Number		●	●	●	●	●	상품금액 ( salePrc × cnt )	198000
prc	Number	●	●	●	●	●	●	판매가 (또는 원가)	229000
salePrc	Number	●	●	●	●	●	●	할인 판매가 (실제 판매가)	99000
cnt	Number		●	●	●	●	●	상품 수량	2
img	String	●						상품 이미지 전체 URL	https://cdn.shop.com/img/001.jpg
status	String	●						상품 판매 상태
cat	String	●	●	●	●	●	●	카테고리 코드	F1S1L1W001
cateNm	String	●	●	●	●	●	●	카테고리명	화이트 로우탑
catL	String	●	●	●	●	●	●	대분류 카테고리 코드	F1
cateLNm	String	●	●	●	●	●	●	대분류 카테고리명	패션
catM	String	●	●	●	●	●	●	중분류 카테고리 코드	F1S1
cateMNm	String	●	●	●	●	●	●	중분류 카테고리명	신발
catS	String	●	●	●	●	●	●	소분류 카테고리 코드	F1S1L1
cateSNm	String	●	●	●	●	●	●	소분류 카테고리명	화이트 로우탑
catD	String	●	●	●	●	●	●	세분류 카테고리 코드	F1S1L1W001
cateDNm	String	●	●	●	●	●	●	세분류 카테고리명	화이트
brand	String	●	●	●	●	●	●	브랜드 코드	P001
brandNm	String	●	●	●	●	●	●	브랜드명	플래티어
plan[]	Array<String>	●						기획전 코드	["SPRING_SALE_2026"]
attribute	Object	●	●	●	●	●	●	상품 확장 속성 (키-값 객체, 키 이름은 자유 정의)	{ "color": "blue", "season": "SS26" }

Category

• 카테고리 정보 스키마입니다.
• cateCd (카테고리 코드)는 현 상품의 최하위 카테고리 코드와 동일해야합니다.
• 예) catL: 1, catM: 12, catS: 123, catD: 1234 인 경우 cateCd: 1234
• 예) catL: a, catM: ab, catS: abc 인 경우 cateCd: abc
• 카테고리 대중소세(catL,catM,catS,catD) 필드 중 하위 카테고리 코드가 있을 경우 상위 카테고리 코드도 함께 전달해주셔야 합니다.
  전달되지 않는 경우 추천 품질에 영향을 미칠 수 있습니다.
• 예) catS 값이 있을 경우 catL, catM 값도 함께 전달

필드명	타입	설명
cateCd	String	현재 페이지의 카테고리코드
cateNm	String	현재 페이지의 카테고리명
catL	String	대분류 카테고리코드
cateLNm	String	대분류 카테고리명
catM	String	중분류 카테고리코드
cateMNm	String	중분류 카테고리명
catS	String	소분류 카테고리코드
cateSNm	String	소분류 카테고리명
catD	String	세분류 카테고리코드
cateDNm	String	세분류 카테고리명