한국어 한국어   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를 설정하지 않은 분들은 fetchUID (UID 가져오기) 문서를 참고 하셔서, RecoPick에서 브라우저 쿠키로 자동 설정한 uid를 읽은 다음, 이 영역을 채워 주시기 바랍니다.

 

Example Values : test_user_1234

item_ids

(required)

상품 ID의 목록입니다. 상품 id를 URI encoding한 다음 입력해주시기 바랍니다. 여러 개의 상품에 대해 추천을 요청할 경우, comma로 구분해서 입력해주시면 됩니다.

Example Values : 123,12311

limit

(optional)

최대 몇 개의 추천을 가져올지를 의미합니다. item_ids 의 상품당 추천 개수이므로, 2개의 상품에 대해 limit=5로 요청할 경우 총 10개의 추천 결과가 반환됩니다.

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

type

(optional)

추천의 종류를 설정합니다. 현재는 아래 두 가지 추천 리스트 중 하나를 선택할 수 있습니다.

  • viewtogether : 함께 본 상품 (대체재)
  • buytogether : 함께 구매한 상품 (보완재)

따로 값을 설정하지 않으시면, 기본값인 viewtogether 가 적용되며, 주로 대체재가 추천됩니다.

Example Values : type=viewtogether

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/item/1/test_user/123/?callback=parseResponse

...