한국어 한국어   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)

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

  • 성,연령,카테고리별 인기상품 : most_interested_item_by_category_age_gender
  • 성,연령별 인기 카테고리: most_interested_category_by_age_gender
  • 카테고리별 인기상품 : most_interested_item_by_category

Example Values : type=most_interested_item_by_category_age_gender

age_group

(required)

연령 그룹입니다 string이며 '10' , '20' , '30' , '40' , '50' , '60', '70' , '80' ..... 선택 가능합니다.

Example Values : age_group=20

아래 두 가지 추천의 경우에는 필수 항목입니다.

  • 성,연령, 카테고리별 인기상품 : most_interested_item_by_category_age_gender
  • 성,연령별 인기 카테고리: most_interested_category_by_age_gender

gender
 

(required)

성별 정보 입니다. 'F' , 'M' 중 선택 가능합니다 'F' = Female , 'M' = Male을 의미 합니다.

Example Values : gender=F

아래 두 가지 추천의 경우에는 필수 항목입니다.

  • 성,연령, 카테고리별 인기상품 : most_interested_item_by_category_age_gender
  • 성,연령별 인기 카테고리: most_interested_category_by_age_gender

category

(required) 

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

Example Values : category=아우터

아래 세 가지 추천의 경우에는 필수 항목입니다.

  • 성,연령, 카테고리별 인기상품 : most_interested_item_by_category_age_gender
  • 카테고리를 제외한 성,연령별 인기상품 추천을 원하시는 경우 카테고리명 대신 asterisk(*)를 입력하시면 됩니다. ( category=* )
  • 카테고리별 인기상품 : most_interested_item_by_category

brand

(optional) 

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

Example Values : brand=STONE ISLAND

category2

(optional)

중카테고리 입니다. (C2)

"카테고리별 인기상품" 의 경우 중카테고리 별 통계를 알고 싶을 경우 사용합니다.

Example Values : /v1/recommendations/seg/{service_id}/{uid}?type=most_interested_item_by_category&category=의류

Example Values : /v1/recommendations/seg/{service_id}/{uid}?type=most_interested_item_by_category&category=의류&category2=반팔티

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

callback

(optional)

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

Example Values : callback=parseResponse 

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

...