AI 상품 추천: 데이터 호출형(수협몰)

1. 시스템 구조도


2. 개요

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

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


3. 연동 방식

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

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


4. 추천 상품 조회(getGroobeeRecommendAsync)

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

  • 정의

    • 역할: 추천 상품 조회

    • 함수명: groobee.getGroobeeRecommendAsync

  • 파라미터

항목
타입
필수
설명

campaignKey

string

Y

캠페인키

timeSet

int

Y

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

{}

object

Y

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

— 추천 필터링 정보(object) – 재구축(마켓/체크인 제외)

필드명
타입
필수
설명

grbChannelCode

string

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. 변경이력

버전
날짜
변경이력
담당자

-

2026.01.20

초안작성

이도환

Last updated