AI상품추천:데이터호출형 모든페이지(이지웰)

1. 시스템 구조도


2. 개요

  • 스크립트 LOAD 완료된 후 원하는 시점에 추천 상품 목록을 가져와서 사용할 수 있습니다.

  • 추천에 필요한 데이터만 전달 하는것으로 고객사 화면에 맞는 디자인을 구성 하셔야 됩니다.


3. 연동 방식

  • 고객사에서 그루비에서 추천 상품 요청 시 데이터를 바로 전달합니다.

  • 비동기식이라 요청이 느려졌을 경우 html에 추천 리스트를 표현하지 못하는 경우가 존재합니다.


4. 어드민 설정

키(Key) 기반 추천 상품 조회를 사용할 경우 새로운 AI 추천 생성 시 무조건 모든페이지(데이터호출형)을 사용해야만 합니다.

circle-exclamation

5. 키(Key) 기반 추천 상품 조회(getGroobeeKeyBaseRecommendAsync)

  • 고객사에서 추천 상품 요청 시 전달해주는 함수입니다.

  • 정의

    • 역할: 추천 상품 조회

    • 함수명: groobee.getGroobeeKeyBaseRecommendAsync

  • 파라미터

항목
타입
필수
설명

campaignKey

string

Y

캠페인키

recommendBaseType

string

Y

추천 종류(대문자) CATEGORY, GOODS, KEYWORD

recommendValue

string

Y

  • recommendBaseType에 따른 기준값

    • CATEGORY : "카테고리코드" 입력

    • GOODS : "상품코드" 입력

    • KEYWORD : "검색어" 입력

timeSet

int

Y

타임아웃 시간 (기본 1000ms)

{}

object

Y

이지웰 추천 필터링 정보 (하위 참조)

circle-check

— 이지웰 추천 필터링 정보(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로 요청

triangle-exclamation
circle-check
circle-check

— 이지웰 추천 필터링 정보(object) – 대응개발(마켓)

필드명
타입
필수
설명

vendorType

string

Y

대응개발 구분값 - 고정값 : MARKET

channel

string

N

고객사 채널정보

vendorCd

string

Y

고객사 코드

cnt

int

N

상품응답 개수

fallbackAlgorithmList

array<string>

N

폴백 알고리즘 리스트(하단의 알고리즘 리스트 참조)

triangle-exclamation

— 이지웰 추천 필터링 정보(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

폴백 알고리즘 리스트(하단의 알고리즘 리스트 참조)

triangle-exclamation

— 이지웰 추천 필터링 정보(object) – 대응개발(해외패키지)

필드명
타입
필수
설명

vendorType

string

Y

대응개발 구분값 - 고정값 : TRIP

cityCds

array<string>

N

도시코드

areaCd

string

Y

국가코드

vendorCd

string

Y

고객사 코드

cnt

int

N

상품 응답 개수

triangle-exclamation

폴백 알고리즘 리스트

circle-exclamation
알고리즘 코드
설명

ST02

많이 본 상품 TOP N

ST03

많이 구매한 상품 TOP N

ST04

추천 클릭률 TOP N

ST05

실시간 많이 본 TOP N

ST06

주문 전환율 TOP N

ST07

추천 유입률 TOP N

ST09

많이 담은 상품 TOP N

ST10

실시간 많이 구매한 TOP N

작성 예

결과 값


6. 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

상품 코드


7. 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개)


8. 사용 가능 알고리즘 정의

  • 사용 가능한 알고리즘을 확인합니다.

RecommendBaseType
Algorithm

CATEGORY(카테고리 기반)

1. 카테고리 TOP N 2. 실시간 카테고리 TOP N 3. 연관 카테고리 상품

GOODS(상품 기반)

1. 함께 본 상품 2. 함께 구매한 상품 3. 함께 담은 상품 4. 구매 패턴 유사 상품 5. 상품명 기반 유사 상품 6. 딥러닝 기반 유사 상품 7. 연관 카테고리 상품 8. 이미지 기반 유사 상품 9. 딥러닝 기반 다음에 볼 상품

KEYWORD(검색어 기반)

1. 검색어 추천


9. 작성 예시

코드 작성 예시를 보여줍니다.


10. 변경이력

버전
날짜
변경이력
담당자

1.01

2025.10.17

초안작성

김상훈

1.02

2025.10.22

필터항목의 필수 여부 수정

김상훈

1.03

2025.10.28

체크인 필터링 항목 필수 여부 변경 (도시코드, 지역코드, 숙소유형, 숙소등급 : Y → N )

김상훈

1.04

2025.11.06

필터 필드 fallbackAlgorithmList 추가

이도환

1.05

2025.11.12

재구축 필터링 정보에 category, giftYn 추가

김상훈

1.06

2025.12.12

대응개발(해외패키지) 추천 필터링 정보 추가

이도환

Last updated