상품 추천 연동하기
콘솔에서 만든 추천 슬롯을 추천 API로 받아 웹·앱 화면에 노출하는 전체 흐름을 안내합니다.
시작하기 전에
추천은 상품 정보와 유저 행동 데이터를 학습해 동작해요. 먼저 아래 데이터를 연동하세요.
- 상품 정보 연동하기 — 추천 후보가 되는 상품 카탈로그
- 행동 데이터 연동하기 — 조회·장바구니·구매·좋아요 등 유저 행동
연동 방식
1
콘솔에서 추천 슬롯을 만들고 활성화하세요.
콘솔 관리 > 상품 추천에서 추천 슬롯을 만들고 추천 유형·후보 조건을 설정한 뒤 활성화합니다. 이때 정한 추천 연동 키로 추천을 요청해요. 자세한 설정은 추천 슬롯 만들기를 참고하세요.
2
추천 API로 추천 상품을 받으세요.
고객사 서버에서 상품 추천 API를 호출해 추천 상품 ID 목록을 받습니다. 추천 연동 키는 경로에, 추천을 받을 유저의 blux_user_id는 본문에 담아 요청해요.
curl -X POST https://recsys-api-realtime.blux.ai/v1/applications/{APPLICATION_ID}/slots/{SLOT_KEY}/recommend \
-H "Authorization: {SECRET_KEY}" \
-H "Content-Type: application/json" \
-d '{
"blux_user_id": "blux-user-1",
"limit": 10
}'
* secret key는 서버 사이드 전용 비밀 키예요. 브라우저에 노출하지 말고 추천 요청은 고객사 서버에서 호출하세요.
* 유저의 blux_user_id는 Web SDK 인스턴스에서 가져와요. 비우면 콜드 유저 추천으로 동작합니다.
3
상품 상세 정보를 채워 화면에 노출하세요.
추천 API는 상품 ID 목록만 돌려줘요. 상품명·가격·이미지 등 화면에 보여줄 정보는 고객사 상품 데이터에서 채운 뒤 추천 지면에 노출합니다.
4
성과 추적 속성을 심으세요.
추천 구좌의 노출·클릭 성과를 집계하려면, 다음 두 가지 속성을 추가합니다.
data-blux-tracking-id— 추천 구좌를 감싸는 wrapper 요소에 추천 연동 키를 넣습니다. 구좌 노출을 집계합니다.data-blux-item-id— 구좌 안 각 상품 wrapper 요소에 그 상품의 상품 ID를 넣습니다. 상품 클릭을 집계합니다.
<div data-blux-tracking-id="main_home">
<a data-blux-item-id="ITEM_ID_1"> ... </a>
<a data-blux-item-id="ITEM_ID_2"> ... </a>
</div>
* 추적 속성을 심지 않으면 노출·클릭이 수집되지 않아요. 수집된 성과는 콘솔 관리 > 상품 추천의 성과 화면에서 확인할 수 있어요.