AI 상품 추천: 데이터 호출형(이지웰)
1. 시스템 구조도

2. 개요
스크립트 LOAD 완료된 후 원하는 시점에 추천 상품 목록을 가져와서 사용할 수 있습니다.
추천에 필요한 데이터만 전달 하는것으로 고객사 화면에 맞는 디자인을 구성 하셔야 됩니다.
3. 연동 방식
고객사에서 그루비에서 추천 상품 요청 시 데이터를 바로 전달합니다.
비동기식이라 요청이 느려졌을 경우 html에 추천 리스트를 표현하지 못하는 경우가 존재합니다.
4. 추천 상품 조회(getGroobeeRecommendAsync)
고객사에서 추천 상품 요청 시 전달해주는 함수입니다.
정의
역할: 추천 상품 조회
함수명: groobee.getGroobeeRecommendAsync
파라미터
campaignKey
string
Y
캠페인키
timeSet
int
Y
타임아웃 시간 (기본 1000ms)
{}
object
Y
이지웰 추천 필터링 정보 (하위참조)
— 이지웰 추천 필터링 정보(object) – 재구축(마켓/체크인 제외)
channel
string
N
고객사 채널정보
category
string
N
채널이 101, 102, 106 일때 필요
point
int
N
고객사 포인트
vendorCd
string
Y
고객사 코드
cnt
int
N
상품응답 개수
fallbackAlgorithmList
array<string>
N
폴백 알고리즘 리스트(하단의 알고리즘 리스트 참조)
giftYn
string
N
선물하기 추천 요청시 Y로 요청
cnt 필드를 보내주지 않으시면 이지웰에 설정된 최대 200개의 상품이 내려갑니다.
전체 상품을 추천하시려면 channel에 빈값을 넣어주시고, vendorCd에 고객사 코드만 넣어주세요.
vendorCd로만 필터해서 재구축, 마켓, 체크인의 상품중에 추천이 됩니다.
채널이 브랜드몰(101), 5대복지(102), 전문관(106) 일때는 category에 카테고리를 넣어주세요.
선물하기 페이지에서 호출하실때는 채널값은 빈값으로 해서 giftYn에 Y를 넣어서 호출 해 주세요.
— 이지웰 추천 필터링 정보(object) – 대응개발(마켓)
vendorType
string
Y
대응개발 구분값 - 고정값 : MARKET
channel
string
N
고객사 채널정보
vendorCd
string
Y
고객사 코드
cnt
int
N
상품응답 개수
fallbackAlgorithmList
array<string>
N
폴백 알고리즘 리스트(하단의 알고리즘 리스트 참조)
cnt 필드를 보내주지 않으시면 이지웰에 설정된 최대 200개의 상품이 내려갑니다.
— 이지웰 추천 필터링 정보(object) – 대응개발(체크인)
vendorType
string
Y
대응개발 구분값 - 고정값 : CHECK_IN
channel
string
N
고객사 채널정보
cityCd
string
N
도시코드
areaCd
string
N
지역코드
roomType
string
N
숙소유형
roomClass
string
N
숙소등급
vendorCd
string
Y
고객사 코드
cnt
int
N
상품 응답 개수
fallbackAlgorithmList
array<string>
N
폴백 알고리즘 리스트(하단의 알고리즘 리스트 참조)
cnt 필드를 보내주지 않으시면 이지웰에 설정된 최대 200개의 상품이 내려갑니다.
— 이지웰 추천 필터링 정보(object) – 대응개발(해외패키지)
vendorType
string
Y
대응개발 구분값 - 고정값 : TRIP
cityCds
array<string>
N
도시코드
areaCd
string
Y
국가코드
vendorCd
string
Y
고객사 코드
cnt
int
N
상품 응답 개수
cnt 필드를 보내주지 않으시면 이지웰에 설정된 최대 200개의 상품이 내려갑니다.
폴백 알고리즘 리스트
캠페인별로 특정 폴백알고리즘을 노출하기 원하시면 아래 8개 알고리즘 코드 중 선택해서 넣어주시면 됩니다. ex)
"fallbackAlgorithmList" : ["ST02"] - ST02 상품이 내려갑니다.
"fallbackAlgorithmList" : ["ST02", "ST04"] - ST02, ST04 둘중 하나가 랜덤하게 내려갑니다.
ST02
많이 본 상품 TOP N
ST03
많이 구매한 상품 TOP N
ST04
추천 클릭률 TOP N
ST05
실시간 많이 본 TOP N
ST06
주문 전환율 TOP N
ST07
추천 유입률 TOP N
ST09
많이 담은 상품 TOP N
ST10
실시간 많이 구매한 TOP N
작성 예
결과 값
5. DI(노출)
실제 고객사에서 노출시킨 상품 정보를 그루비로 보내줍니다.
그루비로 노출시킨 상품 정보를 보내주면 통계에 집계되어 어드민에서 확인 가능합니다.
정의
역할: 전시되는 상품을 그루비에서 노출 처리
함수명: groobee.send
파라미터
type
string
Y
노출 코드("DI" 고정 값)
{}
object
Y
노출 관련 object (하위참조)
— 노출 관련 object
algorithmCd
string
Y
알고리즘 코드
campaignKey
string
Y
추천 캠페인키
campaignTypeCd
string
Y
캠페인 타입("RE" 고정 값)
goods
array<object>
Y
실제로 노출된 상품 코드 리스트 (하위참조) [ { goodsCd: "상품코드1" }, {}, ... ]
— goods 배열 내부 객체 구조 (실제로 노출된 상품 코드 리스트)
goodsCd
string
Y
상품 코드
6. CL(클릭)
고객이 클릭한 상품 정보를 그루비로 보내줍니다.
고객이 클릭한 상품 정보를 그루비로 보내주면 통계에 집계되어 어드민에서 확인 가능합니다.
정의
역할: 고객이 클릭한 상품을 그루비에서 클릭 처리
함수명: groobee.send
파라미터
type
string
Y
클릭 코드("CL" 고정 값)
{}
object
Y
클릭 관련 object (하위참조)
— 클릭 관련 object
algorithmCd
string
Y
알고리즘 코드
campaignKey
string
Y
추천 캠페인키
campaignTypeCd
string
Y
캠페인 타입("RE" 고정 값)
goods
array<object>
Y
실제로 클릭된 상품 코드 (하위참조) [ { goodsCd: "상품코드1" }]
— goods 배열 내부 객체 구조 (실제로 클릭된 상품 코드)
goodsCd
string
Y
상품 코드 (실제 클릭한 상품 1개)
7. 작성 예시
코드 작성 예시를 보여줍니다.
8. 변경이력
-
2025.07.24
초안작성
김상훈
1.02
2025.09.28
대응개발(마켓/체크인) 추천 필터링 정보 추가
김상훈
1.03
2025.10.15
추천상품 응답시 캠페인별 상품개수 조절하기 위한 필터링 정보 추가
김상훈
1.04
2025.10.22
필터항목의 필수 여부 수정
김상훈
1.05
2025.10.28
체크인 필터링 항목 필수 여부 변경 (도시코드, 지역코드, 숙소유형, 숙소등급 : Y → N )
김상훈
1.06
2025.11.07
폴백 알고리즘 필터 추가
이도환
1.07
2025.11.12
재구축 필터링 정보에 category, giftYn 추가
김상훈
1.08
2025.12.12
대응개발(해외패키지) 추천 필터링 정보 추가
이도환
Last updated