한국어 한국어   Englilsh English

.

Skip to end of metadata
Go to start of metadata

클릭 로그를 남기고 입력하신 URL로 redirect를 합니다. 클릭 로그가 정상적으로 전송되어야 정확한 추천 클릭수와 추천 클릭률 등의 성과 측정이 가능합니다.

또한, 클릭 로그 데이터는 추천 계산 시에 반영되므로 클릭 로그가 전송되어야 추천 품질이 더 좋아집니다.

추천 API 의 응답결과 중 clicklog_redirect_link 의 값을 그대로 사용하시면 더 쉽게 사용하실 수 있습니다.

Resource URL 

https://lc.recopick.com/1/banner/:service_id/pick?source=:item_id&pick=:item_id&method=:method&url=:encodedURL&uid=:uid&channel=:channel&product_type=:product_type

(GET 1/banner/:service_id/pick)

 
*Native(Hybrid) App에서는 uid 자리에 반드시 GAID 혹은 IDFA값을 넣어서 업로드 해야 합니다.

Parameters

service_id

(required)

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

Example Values : 17

source

(required)

추천리스트가 계산된 Item ID를 말합니다. 예를 들어 "ITEM2"라는 Item에 대해 추천리스트를 받으셨다면 source 값은 "ITEM2"입니다. 

Example Values : ITEM2

pick

(required)

사용자가 클릭한 Item ID를 말합니다. 예를 들어 "ITEM2"라는 Item에 대해 추천리스트를 요청하면 아래와 같은 형식의 json 을 받습니다.
 {
   "id": "ITEM5",
   "score": 0.142857,
   "intersection":12,
   "method": "4"
 },
 {
   "id": "ITEM6",
   "score": 0.060976,
   "intersection":6,
   "method": "3"
 }

위 리스트를 이용하여 추천 리스트를 사용자에게 보여준 다음, 사용자가 ITEM5를 클릭했다면 pick값은 ITEM5 입니다. 따라서 URL을 만드실 때 사용자가 선택한 "id"값을 pick의 값으로 사용하시면 됩니다. 

Example Values : pick=ITEM5

method

(required)

RecoPick에서 추천 계산시 사용된 알고리즘의 ID 입니다. 이 값은 추천결과를 받으신 json에서 사용자가 선택한 아이템의 "method"값을 그대로 사용하시면 됩니다. 위 예제에서 사용자가 ITEM5를 선택했다면, method는 4가 됩니다.

Example Values : method=4

url

(optional)

사용자가 추천리스트를 클릭하고 난 후 redirect될 URL 입니다.

이 때, URL은 반드시 encoding 되어 있어야 합니다. 이 옵션은 필수 사항이 아니며, URL을 쓰지 않을 경우 자체적으로 저장하고있는 URL 패턴에 맞춰서 상품 상세페이지로 redirect 해드립니다.

Example Values : url=http%3A%2F%2Fexample.com%2Fproduct%2Fdetail.html

channel

(optional)

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

Example Values : channel=ch1

product_type

(optional)

레코픽에서 사용중인 상품 종류를 입력합니다. (R : 추천상품 / L : 랜딩상품) 이 옵션은 필수 사항이 아니며, product_type 을 쓰지 않을 경우 추천상품으로 간주합니다. 

Example Values : product_type=R

uid

(required)

클릭한 사용자를 구분할 수 있는 UID 입니다.

클릭한 사용자 UID를 API 요청시 남겨주시면, 추천 계산시 클릭여부를 반영하여 좀 더 고품질의 추천을 받아보실 수 있습니다.

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

Example Values : uid=9293812938



Example Request


GET    https://lc.recopick.com/1/banner/17/pick?source=ITEM2&pick=ITEM5&method=4&url=http%3A%2F%2Fexample.com%2Fproduct%2Fdetail.html&uid=9293812938&product_type=R



Output

 정상적인 경우 Parameter에 적어주신 URL이나 클릭한 상품 URL로 redirect 됩니다.


  • No labels