한국어 한국어   Englilsh English

.

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

service_id

(required)

RecoPick에서 발급된 service id를 의미합니다. service id를 모르실 경우 RecoPick으로 문의해주시기 바랍니다.

Example Values : 1

uid

(required)

추천리스트를 가져올 사용자 ID를 의미합니다. 로그 수집에 사용하고 있는 사용자 ID를 입력해주시기 바랍니다.

uid 값을 생성하는 방법은 Client Library APIs#2.2ClientLibraryAPIs-fetchUID 를 참고해주세요.

Example Values : test_user_1234

type

(required)

통계의 종류입니다. 아래 목록을 참고하여 원하는 값을 지정해주시기 바랍니다.

  • 구매전환율이 높은 상품: purchase_rate
  • 추천클릭률이 높은 상품: reco_click_rate
  • 추천유입률이 높은 상품: reco_inflow_rate
  • 가장 많이 본 상품(최근 1주 기준): view
  • 가장 많이 본 상품(최근 1시간 기준): view2
  • 가장 많이 구매 한 상품: order

Example Values : type=purchase_rate

limit

(optional)

최대 몇 개의 추천을 가져올지를 의미합니다. limit값이 없으면 계산된 추천 리스트 전체를 가져오게 되어 있습니다. 추천 결과의 개수가 limit보다 적은 경우, 전체 추천 결과가 반환됩니다.

Example Values : limit=5

field

(optional)

field=meta를 입력하시면 추천리스트에 상품명, 가격, 상품 이미지 등 전송된 상품메타정보가 같이 제공됩니다. 

Example Values : field=meta

channel

(optional)

추천클릭률, 추천기여매출을 추적하기 위해 channel을 입력합니다. 추천 노출 영역이 다르거나, A/B test 시에 서로 다른 channel을 부여하시면, channel 별로 성과를 계산하여 보여드립니다.

채널이란 하나의 사이트에서 여러 개의 추천 알고리즘을 각각 다른 위치에 제공하는 경우,
각 페이지에 제공된 추천 알고리즘 별로 추천 성과(추천클릭률 및 추천기여매출)를 확인할 수 있도록 하기 위한 식별자입니다.
예를 들어, 실시간 개인화 추천 알고리즘을 메인페이지, 상품상세페이지, 마이페이지에서 사용하는 경우, 각 페이지 별로 추천 성과가 달라집니다.
이 때에 각 페이지 별로 채널명을 부여하여 페이지 별로 구분하여 추천 알고리즘 성과를 분석할 수 있습니다.
채널명은 아래 예와 같이 공백 없는 영문 명을 사용하시는 걸 권장 드립니다.
예> 메인페이지 : main, 상품상세페이지_상단 : detail_top, 장바구니 : basket

Example Values : channel=detail_top

category

(optional) 

카테고리 입니다. 최상위 카테고리만 지원 됩니다. 가구 , 여성의류 , 가전제품 ...

Example Values : category=아우터

brand

(optional) 

브랜드입니다. brand라는 항목으로 수집된 brand명에 한하여 동일 텍스트에 한해 지원됩니다.  

Example Values : brand=STONE ISLAND

callback

(optional)

callback을 입력하시면 JSONP 형태의 응답을 제공합니다.

Example Values : callback=parseResponse 

Example Request : https://api.recopick.com/v1/recommendations/user/20/test_user_123?callback=parseResponse

...