한국어 한국어   Englilsh English

.

Skip to end of metadata
Go to start of metadata

본 가이드는 독립형 쇼핑몰(자체 제작 쇼핑몰)에 해당하는 내용입니다.


개발(스테이징)서버와 상용서버간 sid, domain은 분리하여 사용하시기 바랍니다.


<1단계> 레코픽 로그수집 스크립트 삽입

공통 헤더 파일이 있는 경우는 공통 헤더용 로그수집 스크립트를 삽입한 후 페이지별로 해당 ‘sendLog’를 추가 삽입해 주시고

공통 헤더 파일이 없는 경우 페이지별로 ‘sendLog’를 포함한 로그수집 스크립트를 삽입해주세요! 

(warning) 주의하세요!  상품상세페이지에서 상품메타태그는 sendLog보다 앞에 위치해야 합니다. 그래야 사용자행동로그와 함께 상품메타정보도 같이 레코픽으로 전송됩니다.

공통 헤더 파일이 있는 경우

1. 공통 헤더 파일에 로그수집 스크립트 삽입하기

  1. 모든 페이지의 공통 헤더 파일 <head> … </head>태그 사이에 아래 스크립트를 넣어주세요. 스크립트 관리가 용이하도록 </head>태그 바로 앞에 넣기를 권장합니다.

    (warning) 주의하세요! '사이트 url' 에는 레코픽 회원 가입 시에 등록하신 사이트 URL과 동일한 URL을 넣어주셔야 합니다. 회원 가입 시 사이트 URL을 등록하실 때에 www 는 제외해 주십시오. 또한, 대소문자 구별을 꼭 해주셔야 합니다.

    공통 헤더용 로그수집 스크립트
    <!--RecoPick 로그수집 스크립트 -->
    <script type="text/javascript">
      (function(w,d,n,s,e,o) {
         w[n]=w[n]||function(){(w[n].q=w[n].q||[]).push(arguments)};
         e=d.createElement(s);e.async=1;e.charset='utf-8';e.src='//static.recopick.com/dist/production.min.js';
         o=d.getElementsByTagName(s)[0];o.parentNode.insertBefore(e,o);
       })(window, document, 'recoPick', 'script');
       recoPick('service', '사이트 url');             
    </script>
    <!--RecoPick 로그수집 스크립트 -->
  • 공통 헤더용 로그수집 스크립트 삽입후 더욱 특화된 개인화 추천을 원하시면 암호화된 ID, 연령, 성별 데이터를 보내주세요! 

    (’service’, ‘ 사이트 url’); 바로 다음에 아래 스크립트를 삽입해 주시면 됩니다. 출생년도, 성별은 예시 참고하셔서 변경해 주시고 MEMBER_ID(MID)는 자체적으로 사용중인 회원 ID를 암호화해서 보내주세요.
    * 레코픽에서 수집하는 암호화된 ID, 연령, 성별 데이터로는 절대 개개인을 식별할 수 없으며, 단순히 사용자를 구분하기 위한 용도로만 사용됩니다.
      예를 들어, 같은 회원이 PC와 모바일을 통해 접속한다면 MID를 통해  매핑하면 RecoPick에서도 두 사용자를 같은 회원으로 인식하여 개인화 추천 등의 품질 향상에 도움이 됩니다.

    (warning) 주의하세요! 레코픽 추천을 API 방식으로 사용하는 경우, GET방식으로 API를 호출하게 됩니다.
      이 경우 일부 API의 파라미터에 MID가 사용되는데, MID 값에 일부 특수문자(예> &, =) 가 들어가게 되면 정상동작 하지 않을 수 있습니다.
      암호화된 결과에 특수문자가 들어가지 않는 암호화 알고리즘으로 단방향 암호화 해주세요. (예> SHA-256, MD5 등)

    * MID 단방향 암호화 예 : 88020d58ceb8a4ad7f6756021fbc06b8a91f17daad2f04a5d369608d9c308bde (SHA-256으로 암호화), 4509bf9373ff3dca193ba02726c87988 (MD5로 암호화)

    사용자 구분을 위한 로그수집 스크립트
    recoPick('setMID',암호화된 MEMBER_ID); 
    recoPick('setUserInfo',{ birthyear:‘출생연도’, gender:'성별’});
    

    <예시>

    * 출생년도, 성별 정보 (M: 남자, F: 여자)

    recoPick('setUserInfo',{ birthyear: ‘1987’, gender: 'M’});

2.  페이지별 ‘sendLog’ 추가 삽입하기

  1. 각각의 페이지에 들어가시면 공통 헤더용 로그수집 스크립트가 삽입되어 있습니다.  공통헤더용 로그수집 스크립트 안에 ‘sendLog’ 를 삽입해 주세요. < 그림 1: 삽입위치 참고>
    ‘sendLog’는 실제 데이터를 전송하는 역할을 하기 때문에 각 페이지에 맞게 수정해 주셔야 합니다. 

          <그림 1 : 삽입위치 참고>

          

             * ‘sendLog’ 삽입 위치는 위처럼 공통 헤더용 로그수집 스크립트 안에 삽입하셔도 되고,  <script>...<script> 태그에 넣어 공통헤더용 로그수집 스크립트와 별도로 삽입하셔도 됩니다. 

                그럴 경우 공통 헤더용 로그수집 스크립트보다 하단에 위치하도록 해야 합니다.


     2. 상품 상세 페이지에 들어가셔서 아래 스크립트를 삽입해주세요. <그림1 삽입위치 참고>

         아래 스트립트를 삽입후 상품id, 카테고리는 실제 사용하시는 변수로 수정해 주셔야 하며 상품id, 카테고리는 문자열로 전달되어야 합니다.

ex) 상품id가 12345, 카테고리가 여성의류 일때, {id:'12345', c1:'여성의류'}

  • ‘카테고리(대)’, ‘카테고리(중)’, ‘카테고리(소)’에 실제 사용하시는 변수로 수정해서 넣어주시면 보다 고품질의 추천을 제공해 드립니다.
  • 카테고리는 최대 세 단계(대/중/소) 카테고리가 지원되며 c1, c2, c3의 값으로 설정합니다.
  • 카테고리 정보가 최소한 1개(c1 : 대 카테고리) 이상 들어가야 합니다.
  • 카테고리 정보는 카테고리ID가 아닌 카테고리명으로 넣어주십시오. 카테고리ID 사용 시에 오류가 발생할 수 있습니다.

    • 자켓, 아우터, 스커트 등 (O)

    • 23851, 24A831T04C (X)

  • sendLog_view (카테고리 포함)
    recoPick('sendLog','view', {id:'상품id', c1:'카테고리(대)', c2:'카테고리(중)', c3:'카테고리(소)'}); 
    

       <예시>

  • 사이트 방문고객이 123번 상품의 상세 페이지를 방문 시 (해당상품의 카테고리 정보 포함)

    recoPick('sendLog','view', {id:'123', c1:'여성의류', c2:'자켓/코트', c3:'무스탕/가죽자켓'});
    

  • 사이트 방문고객이 133번 상품의 상세 페이지를 방문시 (해당상품의 카테고리 정보 포함)

    recoPick('sendLog','view', {id:'133',c1:'가방/패션잡화', c2:'지갑', c3:'여성반지갑'});

   3. 장바구니 페이지에 들어가셔서 아래 스크립트를 삽입해주세요. <그림1 삽입위치 참고>

        아래 스트립트를 삽입후 상품id, 상품개수는 실제 사용하시는 변수로 수정해 주셔야 하며 상품id는 문자열로 전달되어야 합니다.


  • sendLog_basket
    recoPick('sendLog','basket', {id:'상품id', count:상품개수}); 
    

    <예시>

  • 사이트 방문고객이 123번 상품을 2개, 133번 상품을 1개 장바구니에 담았을 시

    recoPick('sendLog','basket', {id:'123', count:2},{id:'133', count:1});

    4. 구매완료 페이지에 들어가셔서 아래 스크립트를 삽입해주세요. <그림1 삽입위치 참고>

  •         아래 스트립트를 삽입후 상품id, 상품개수, 상품별총가격은 실제 사용하시는 변수로 수정해 주셔야 하며 상품id는 문자열로 전달되어야 합니다.

ex) 상품id가 12345 일때, {id:'12345'}

  •       주문서에 담긴 각 상품의 sale_price 의 합계를 넣어주시면 됩니다. 할인가격으로 구매할 경우 할인가격을 넣어주시면 됩니다.  단, 사용한 쿠폰과 포인트는 제외 해주시면 됩니다.
  • sendLog_order
    recoPick('sendLog','order', {id:'상품id', count:상품개수, total_sales:상품별총가격}); 
    

    <예시>

  • 사이트 방문고객이 123번 상품 2개를 12000원(개당 6000원)에, 133번 상품 1개를 6000원에 구매시

    recoPick('sendLog','order', {id:'123', count:2, total_sales:12000},{id:'133', count:1, total_sales:6000});


     5. 검색 페이지에 들어가셔서 아래 스크립트를 삽입해주세요. <그림1 삽입위치 참고>

        아래 스트립트를 삽입후 keyword는 사용자의 검색어(쇼핑몰 내부 검색어, 검색광고 유입 검색어)로 수정해 주셔야 합니다.

  • sendLog_search
    recoPick('sendLog','search', 'keyword'); 
    

       <예시>

  • 사이트 방문고객이 쇼핑몰내에서 ‘청바지’ 검색시

    recoPick('sendLog','search', '청바지');

     6. 메인페이지 및 마이페이지 등의  기타 페이지에 들어가셔서 아래 스크립트를 삽입해주세요. (단, 상품상세페이지, 장바구니페이지, 구매완료페이지, 검색결과페이지는 제외)

  • sendLog_visit
    recoPick('sendLog','visit'); 
    




 공통 헤더 파일이 없는 경우

1. 메인 및 마이페이지 등 상품 ID가 없는 모든 페이지에 삽입하기 (단, 상품상세페이지, 장바구니페이지, 구매완료페이지, 검색결과페이지는 제외)

  1. 메인페이지, 마이페이지와 그외 상품ID가 없는 모든페이지에 아래 스트크립트를 삽입해주세요.
    (warning) 주의하세요! '사이트 url' 에는 레코픽 회원 가입 시에 등록하신 사이트 URL과 동일한 URL을 넣어주셔야 합니다. 회원 가입 시 사이트 URL을 등록하실 때에 www 는 제외해 주십시오. 또한, 대소문자 구별을 꼭 해주셔야 합니다.

    로그수집 스크립트 (sendLog_visit)
    <!--RecoPick 로그수집 스크립트 -->
    <script type="text/javascript">
      (function(w,d,n,s,e,o) {
         w[n]=w[n]||function(){(w[n].q=w[n].q||[]).push(arguments)};
         e=d.createElement(s);e.async=1;e.charset='utf-8';e.src='//static.recopick.com/dist/production.min.js';
         o=d.getElementsByTagName(s)[0];o.parentNode.insertBefore(e,o);
       })(window, document, 'recoPick', 'script');
       recoPick('service', '사이트 url');
       recoPick('sendLog','visit');     
    </script>
    <!--RecoPick 로그수집 스크립트 -->
  2.  더욱 특화된 개인화 추천을 원하시면 암호화된 ID, 연령, 성별 데이터를 보내주세요! 

    (’service’, ‘ 사이트 url’); 바로 다음에 아래 스크립트를 삽입해 주시면 됩니다. 출생년도, 성별은 예시 참고하셔서 변경해 주시고 MEMBER_ID(MID)는 자체적으로 사용중인 회원 ID를 암호화해서 보내주세요.
    레코픽에서 수집하는 암호화된 ID, 연령, 성별 데이터로는 절대 개개인을 식별할 수 없으며, 단순히 사용자를 구분하기 위한 용도로만 사용됩니다.
      예를 들어, 같은 회원이 PC와 모바일을 통해 접속한다면 MID를 통해  매핑하면 RecoPick에서도 두 사용자를 같은 회원으로 인식하여 개인화 추천 등의 품질 향상에 도움이 됩니다.

    (warning) 주의하세요! 레코픽 추천을 API 방식으로 사용하는 경우, GET방식으로 API를 호출하게 됩니다.
      이 경우 일부 API의 파라미터에 MID가 사용되는데, MID 값에 일부 특수문자(예> &, =) 가 들어가게 되면 정상동작 하지 않을 수 있습니다.
      암호화된 결과에 특수문자가 들어가지 않는 암호화 알고리즘으로 단방향 암호화 해주세요. (예> SHA-256, MD5 등)

    * MID 단방향 암호화 예 : 88020d58ceb8a4ad7f6756021fbc06b8a91f17daad2f04a5d369608d9c308bde (SHA-256으로 암호화), 4509bf9373ff3dca193ba02726c87988 (MD5로 암호화)

    사용자 구분을 위한 로그수집 스크립트
    recoPick('setMID',암호화된 MEMBER_ID); 
    recoPick('setUserInfo',{ birthyear:‘출생연도’, gender:'성별’});
    

    <예시>

    * 출생년도, 성별 정보 (M: 남자, F: 여자)

    recoPick('setUserInfo',{ birthyear: ‘1987’, gender: 'M’});

2. 상품 상세 페이지에 삽입하기

  1. 상품 상세 페이지에 들어가셔서 아래 스크립트를 삽입해주세요. 
    아래 스트립트를 삽입후 상품id, 카테고리는 실제 사용하시는 변수로 수정해 주셔야 하며 상품id, 카테고리는 문자열로 전달되어야 합니다.

    ex) 상품id가 12345, 카테고리가 여성의류 일때, {id:'12345', c1:'여성의류'}

    • ‘카테고리(대)’, ‘카테고리(중)’, ‘카테고리(소)’에 실제 사용하시는 변수로 수정해서 넣어주시면 보다 고품질의 추천을 제공해 드립니다.
    • 카테고리는 최대 세 단계(대/중/소) 카테고리가 지원되며 c1, c2, c3를 key로 사용합니다.
    • 카테고리 정보가 최소한 1개(c1 : 대 카테고리) 이상 들어가야 합니다.
    • 카테고리 정보는 카테고리ID가 아닌 카테고리명으로 넣어주십시오. 카테고리ID 사용 시에 오류가 발생할 수 있습니다.

      • 자켓, 아우터, 스커트 등 (O)

      • 23851, 24A831T04C (X)

           (warning) 주의하세요! '사이트 url' 에는 레코픽 회원 가입 시에 등록하신 사이트 URL과 동일한 URL을 넣어주셔야 합니다. 회원 가입 시 사이트 URL을 등록하실 때에 www 는 제외해 주십시오. 또한, 대소문자 구별을 꼭 해주셔야 합니다.

    로그수집 스크립트 (sendLog_view)
    <!--RecoPick 로그수집 스크립트 -->
    <script type="text/javascript">
      (function(w,d,n,s,e,o) {
         w[n]=w[n]||function(){(w[n].q=w[n].q||[]).push(arguments)};
         e=d.createElement(s);e.async=1;e.charset='utf-8';e.src='//static.recopick.com/dist/production.min.js';
         o=d.getElementsByTagName(s)[0];o.parentNode.insertBefore(e,o);
       })(window, document, 'recoPick', 'script');
       recoPick('service', '사이트 url');
       recoPick('sendLog','view', {id:'상품id', c1:'카테고리(대)', c2:'카테고리(중)', c3:'카테고리(소)'});      
    </script>
    <!--RecoPick 로그수집 스크립트 -->

     <예시>

    • 사이트 방문고객이 123번 상품의 상세 페이지를 방문시 (해당상품의 카테고리 정보 포함)

      recoPick('sendLog','view', {id:'123', c1:'여성의류', c2:'자켓/코트', c3:'무스탕/가죽자켓'});
      

    • 사이트 방문고객이 133번 상품의 상세 페이지를 방문시 (해당상품의 카테고리 정보 포함)

      recoPick('sendLog','view', {id:'133',c1:'가방/패션잡화', c2:'지갑', c3:'여성반지갑'});

    2. 더욱 특화된 개인화 추천을 원하시면 암호화된 ID, 연령, 성별 데이터를 보내주세요! 

    (’service’, ‘ 사이트 url’); 바로 다음에 아래 스크립트를 삽입해 주시면 됩니다. 출생년도, 성별은 예시 참고하셔서 변경해 주시고 MEMBER_ID(MID)는 자체적으로 사용중인 회원 ID를 암호화해서 보내주세요.
    * 레코픽에서 수집하는 암호화된 ID, 연령, 성별 데이터로는 절대 개개인을 식별할 수 없으며, 단순히 사용자를 구분하기 위한 용도로만 사용됩니다.
      예를 들어, 같은 회원이 PC와 모바일을 통해 접속한다면 MID를 통해  매핑하면 RecoPick에서도 두 사용자를 같은 회원으로 인식하여 개인화 추천 등의 품질 향상에 도움이 됩니다.

    (warning) 주의하세요! 레코픽 추천을 API 방식으로 사용하는 경우, GET방식으로 API를 호출하게 됩니다.
      이 경우 일부 API의 파라미터에 MID가 사용되는데, MID 값에 일부 특수문자(예> &, =) 가 들어가게 되면 정상동작 하지 않을 수 있습니다.
      암호화된 결과에 특수문자가 들어가지 않는 암호화 알고리즘으로 단방향 암호화 해주세요. (예> SHA-256, MD5 등)

    * MID 단방향 암호화 예 : 88020d58ceb8a4ad7f6756021fbc06b8a91f17daad2f04a5d369608d9c308bde (SHA-256으로 암호화), 4509bf9373ff3dca193ba02726c87988 (MD5로 암호화)

    사용자 구분을 위한 로그수집 스크립트
    recoPick('setMID',암호화된 MEMBER_ID); 
    recoPick('setUserInfo',{ birthyear:‘출생연도’, gender:'성별’});
    

    <예시>

    * 출생년도, 성별 정보 (M: 남자, F: 여자)

    recoPick('setUserInfo',{ birthyear: ‘1987’, gender: 'M’});

3. 장바구니 페이지에 삽입하기

  1. 장바구니 페이지에 아래 스트립트를 삽입해 주세요. 
    아래 스트립트를 삽입후 상품id, 카테고리는 실제 사용하시는 변수로 수정해 주셔야 하며 상품id, 카테고리는 문자열로 전달되어야 합니다.

    ex) 상품id가 12345, 카테고리가 여성의류 일때, {id:'12345', c1:'여성의류'}

    • (warning) 주의하세요! '사이트 url' 에는 레코픽 회원 가입 시에 등록하신 사이트 URL과 동일한 URL을 넣어주셔야 합니다. 회원 가입 시 사이트 URL을 등록하실 때에 www 는 제외해 주십시오. 또한, 대소문자 구별을 꼭 해주셔야 합니다.
    로그수집 스크립트 (sendLog_basket)
    <!--RecoPick 로그수집 스크립트 -->
    <script type="text/javascript">
      (function(w,d,n,s,e,o) {
         w[n]=w[n]||function(){(w[n].q=w[n].q||[]).push(arguments)};
         e=d.createElement(s);e.async=1;e.charset='utf-8';e.src='//static.recopick.com/dist/production.min.js';
         o=d.getElementsByTagName(s)[0];o.parentNode.insertBefore(e,o);
       })(window, document, 'recoPick', 'script');
       recoPick('service', '사이트 url');
       recoPick('sendLog','basket', {id:'상품id', count:상품개수});       
    </script>
    <!--RecoPick 로그수집 스크립트 -->

     <예시>

    • 사이트 방문고객이 123번 상품을 2개, 133번 상품을 1개 장바구니에 담았을시

      recoPick('sendLog','basket', {id:'123', count:2},{id:'133', count:1});

    2. 더욱 특화된 개인화 추천을 원하시면 암호화된 ID, 연령, 성별 데이터를 보내주세요! 

    (’service’, ‘ 사이트 url’); 바로 다음에 아래 스크립트를 삽입해 주시면 됩니다. 출생년도, 성별은 예시 참고하셔서 변경해 주시고 MEMBER_ID(MID)는 자체적으로 사용중인 회원 ID를 암호화해서 보내주세요.
    * 레코픽에서 수집하는 암호화된 ID, 연령, 성별 데이터로는 절대 개개인을 식별할 수 없으며, 단순히 사용자를 구분하기 위한 용도로만 사용됩니다.
      예를 들어, 같은 회원이 PC와 모바일을 통해 접속한다면 MID를 통해  매핑하면 RecoPick에서도 두 사용자를 같은 회원으로 인식하여 개인화 추천 등의 품질 향상에 도움이 됩니다.

    (warning) 주의하세요! 레코픽 추천을 API 방식으로 사용하는 경우, GET방식으로 API를 호출하게 됩니다.
      이 경우 일부 API의 파라미터에 MID가 사용되는데, MID 값에 일부 특수문자(예> &, =) 가 들어가게 되면 정상동작 하지 않을 수 있습니다.
      암호화된 결과에 특수문자가 들어가지 않는 암호화 알고리즘으로 단방향 암호화 해주세요. (예> SHA-256, MD5 등)

    * MID 단방향 암호화 예 : 88020d58ceb8a4ad7f6756021fbc06b8a91f17daad2f04a5d369608d9c308bde (SHA-256으로 암호화), 4509bf9373ff3dca193ba02726c87988 (MD5로 암호화)

    사용자 구분을 위한 로그수집 스크립트
    recoPick('setMID',암호화된 MEMBER_ID); 
    recoPick('setUserInfo',{ birthyear:‘출생연도’, gender:'성별’});
    

    <예시>

    * 출생년도, 성별 정보 (M: 남자, F: 여자)

    recoPick('setUserInfo',{ birthyear: ‘1987’, gender: 'M’});

4. 구매완료 페이지에 삽입하기

  1. 구매완료 페이지에 들어가셔서 아래 스크립트를 삽입해주세요. 

    아래 스트립트를 삽입후 상품id, 상품개수, 상품별총가격은 실제 사용하시는 변수로 수정해 주셔야 하며 상품id는 문자열로 전달되어야 합니다.

    ex) 상품id가 12345 일때, {id:'12345'}

    • (warning) 주의하세요! '사이트 url' 에는 레코픽 회원 가입 시에 등록하신 사이트 URL과 동일한 URL을 넣어주셔야 합니다. 회원 가입 시 사이트 URL을 등록하실 때에 www 는 제외해 주십시오. 또한, 대소문자 구별을 꼭 해주셔야 합니다.
    로그수집 스크립트 (sendLog_order)
    <!--RecoPick 로그수집 스크립트 -->
    <script type="text/javascript">
      (function(w,d,n,s,e,o) {
         w[n]=w[n]||function(){(w[n].q=w[n].q||[]).push(arguments)};
         e=d.createElement(s);e.async=1;e.charset='utf-8';e.src='//static.recopick.com/dist/production.min.js';
         o=d.getElementsByTagName(s)[0];o.parentNode.insertBefore(e,o);
       })(window, document, 'recoPick', 'script');
       recoPick('service', '사이트 url');
       recoPick('sendLog','order', {id:'상품id', count:상품개수, total_sales:상품별총가격});      
    </script>
    <!--RecoPick 로그수집 스크립트 -->

     <예시>

    • 사이트 방문고객이 123번 상품 2개를 12000원(개당 6000원)에, 133번 상품 1개를 6000원에 구매시


    • POST방식으로 전송 할 경우 상품 개수에는 제약 사항이 없으나, GET방식으로 전송할 경우 브라우저에 따른 제약 사항이 있으니 참고하시기 바랍니다. 

      recoPick('sendLog','order', {id:'123', count:2, total_sales:12000},{id:'133', count:1, total_sales:6000});

    2. 더욱 특화된 개인화 추천을 원하시면 암호화된 ID, 연령, 성별 데이터를 보내주세요! 

    (’service’, ‘ 사이트 url’); 바로 다음에 아래 스크립트를 삽입해 주시면 됩니다. 출생년도, 성별은 예시 참고하셔서 변경해 주시고 MEMBER_ID(MID)는 자체적으로 사용중인 회원 ID를 암호화해서 보내주세요.
    * 레코픽에서 수집하는 암호화된 ID, 연령, 성별 데이터로는 절대 개개인을 식별할 수 없으며, 단순히 사용자를 구분하기 위한 용도로만 사용됩니다.
      예를 들어, 같은 회원이 PC와 모바일을 통해 접속한다면 MID를 통해  매핑하면 RecoPick에서도 두 사용자를 같은 회원으로 인식하여 개인화 추천 등의 품질 향상에 도움이 됩니다.

    (warning) 주의하세요! 레코픽 추천을 API 방식으로 사용하는 경우, GET방식으로 API를 호출하게 됩니다.
      이 경우 일부 API의 파라미터에 MID가 사용되는데, MID 값에 일부 특수문자(예> &, =) 가 들어가게 되면 정상동작 하지 않을 수 있습니다.
      암호화된 결과에 특수문자가 들어가지 않는 암호화 알고리즘으로 단방향 암호화 해주세요. (예> SHA-256, MD5 등)

    * MID 단방향 암호화 예 : 88020d58ceb8a4ad7f6756021fbc06b8a91f17daad2f04a5d369608d9c308bde (SHA-256으로 암호화), 4509bf9373ff3dca193ba02726c87988 (MD5로 암호화)

    사용자 구분을 위한 로그수집 스크립트
    recoPick('setMID',암호화된 MEMBER_ID); 
    recoPick('setUserInfo',{ birthyear:‘출생연도’, gender:'성별’});
    

    <예시>

    * 출생년도, 성별 정보 (M: 남자, F: 여자)

    recoPick('setUserInfo',{ birthyear: ‘1987’, gender: 'M’});

5. 검색 페이지에 삽입하기

  1. 검색 페이지에 들어가셔서 아래 스크립트를 삽입해주세요. 

    아래 스트립트를 삽입후 keyword는 실제 사용하시는 변수로 수정해 주셔야 하며 상품id는 문자열로 전달되어야 합니다.

    ex) 상품id가 12345 일때, {id:'12345'}

    • (warning) 주의하세요! '사이트 url' 에는 레코픽 회원 가입 시에 등록하신 사이트 URL과 동일한 URL을 넣어주셔야 합니다. 회원 가입 시 사이트 URL을 등록하실 때에 www 는 제외해 주십시오. 또한, 대소문자 구별을 꼭 해주셔야 합니다.
    로그수집 스크립트 (sendLog_search)
    <!--RecoPick 로그수집 스크립트 -->
    <script type="text/javascript">
      (function(w,d,n,s,e,o) {
         w[n]=w[n]||function(){(w[n].q=w[n].q||[]).push(arguments)};
         e=d.createElement(s);e.async=1;e.charset='utf-8';e.src='//static.recopick.com/dist/production.min.js';
         o=d.getElementsByTagName(s)[0];o.parentNode.insertBefore(e,o);
       })(window, document, 'recoPick', 'script');
       recoPick('service', '사이트 url');
       recoPick('sendLog','search', 'keyword');      
    </script>
    <!--RecoPick 로그수집 스크립트 -->

     <예시>

    • 사이트 방문고객이 쇼핑몰내에서 ‘청바지’ 검색시

      recoPick('sendLog','search', '청바지');

    2. 더욱 특화된 개인화 추천을 원하시면 암호화된 ID, 연령, 성별 데이터를 보내주세요! 

    (’service’, ‘ 사이트 url’); 바로 다음에 아래 스크립트를 삽입해 주시면 됩니다. 출생년도, 성별은 예시 참고하셔서 변경해 주시고 MEMBER_ID(MID)는 자체적으로 사용중인 회원 ID를 암호화해서 보내주세요.
    * 레코픽에서 수집하는 암호화된 ID, 연령, 성별 데이터로는 절대 개개인을 식별할 수 없으며, 단순히 사용자를 구분하기 위한 용도로만 사용됩니다.
      예를 들어, 같은 회원이 PC와 모바일을 통해 접속한다면 MID를 통해  매핑하면 RecoPick에서도 두 사용자를 같은 회원으로 인식하여 개인화 추천 등의 품질 향상에 도움이 됩니다.

    (warning) 주의하세요! 레코픽 추천을 API 방식으로 사용하는 경우, GET방식으로 API를 호출하게 됩니다.
      이 경우 일부 API의 파라미터에 MID가 사용되는데, MID 값에 일부 특수문자(예> &, =) 가 들어가게 되면 정상동작 하지 않을 수 있습니다.
      암호화된 결과에 특수문자가 들어가지 않는 암호화 알고리즘으로 단방향 암호화 해주세요. (예> SHA-256, MD5 등)

    * MID 단방향 암호화 예 : 88020d58ceb8a4ad7f6756021fbc06b8a91f17daad2f04a5d369608d9c308bde (SHA-256으로 암호화), 4509bf9373ff3dca193ba02726c87988 (MD5로 암호화)

    사용자 구분을 위한 로그수집 스크립트
    recoPick('setMID',암호화된 MEMBER_ID); 
    recoPick('setUserInfo',{ birthyear:‘출생연도’, gender:'성별’});
    

    <예시>

    * 출생년도, 성별 정보 (M: 남자, F: 여자)

    recoPick('setUserInfo',{ birthyear: ‘1987’, gender: 'M’});

  • Device Identification API(*Hybrid(Native) App 사용시 필수 적용)

    • 본 API는 플랫폼에서 제공하는 Device의 고유 식별 값을 지정하기 위한 API입니다.
    • RecoPick의 UID를 통한 사용자 별 구분은 한 사용자가 여러 페이지를 방문했을 때, 이 사용자가 방문한 페이지들을 추적할 수 있으며 이를 기반으로 고품질의 추천을 계산할 수 있게 합니다.
    • Mobile 환경에서 제공하는 고객사 사이트의 형태가 Hybrid App 이거나 Native App Mobile 일 경우 recopick_uid가 아닌 단말 플랫폼에서 제공하는 고유식별 값을 ID로 사용하여야 합니다.
    • Android에서는 GAID(Google Advertising Identifier) 또는 AAID(Android Advertising Identifier) 으로 제공되고, IOS는 IDFA(Identifier For Advertising) 또는 IFA 라는 이름으로 제공 합니다.
    • 단말 플랫폼으로부터 GAID와 IDFA를 획득하는 경우에 대해서는 setUID에 GAID혹은  IDFA값을 넣어야 하고, 추가로 아래와 같이 setGAID, setIDFA도 같이 실행해 해주셔야 합니다.
    • 행동 로그 수집 시 GAID/IDFA를 사용하셨다면 추천 API 호출 시에도 동일한 GAID/IDFA를 이용하여 추천 API를 호출하셔야 합니다.
    • 적용 가이드
    • Hybrid(Native) App에서 ADID 획득 하는 방법



  • 적용 후 검증 방법

    • 대시보드 접속 후 

    • 아래와 같이 유형별(Visit, View, Order... 등) 행동 로그가 유입되는지 확인 가능


  • 대시보드 접속 후 

    • 로그수집 현황에서 실시간 로그 수집현황을 보시면 로그가 정상적으로 유입되는지 확인 가능.
    • 레코픽  script 적용 후 발급되는 recopick_uid(recopick cookies) 를 입력하여 실시간 로그 수집 현황 확인 가능

<2단계> 상품 메타 태그 삽입

1. 상품 메타 태그는 스크립트 관리를 위해 상품상세페이지의 <head> … </head> 태그 사이 레코픽 로그수집 스크립트 바로 뒤에 삽입하길 권장합니다. 만약 헤더파일이 없는 경우 html 최상단에 삽입해 주세요!

(warning) 주의하세요!  상품상세페이지에서 상품메타태그는 sendLog보다 앞에 위치해야 합니다. 그래야 사용자행동로그와 함께 상품메타정보도 같이 레코픽으로 전송됩니다.

  • 기본 메타 태그
    <meta property="recopick:title" content="상품 이름">
    <meta property="recopick:image" content="상품 이미지 url">
    <meta property="recopick:price" content="상품가격">
    <meta property="recopick:price:currency" content="가격 통화단위">
    

 

2.  기본 메타 태그 삽입후 상황에 따라 아래 태그를 추가해주세요!

  • 현재 가격, 할인 가격을 둘 다 표시할 수 있습니다.

    할인 가격이 있을 경우
    <meta property="recopick:sale_price" content="할인가격">
    <meta property="recopick:sale_price:currency" content="할인가격 통화단위">
  • 상품 품절 시 지정합니다.

    상품이 품절 상태인 경우
    <!--/if soldout/-->
    <meta property="recopick:availability" content="oos">
    <!--/end if/-->

      

3. Content 블루텍스트 부분은 실제 사용하는 변수로 수정해 주셔야 하며 반드시 큰따옴표(double-quotes)로 묶여야 합니다.


< 메타 태그 설명 >
PropertyContent

recopick:title (상품명)

* 필수 메타 입니다.

상품 이름

<예시> “ 클래식 체크 스커트”

recopick:image (상품이미지)

* 필수 메타 입니다.

상품 이미지 URL 

<예시> http://www.recopick.com/abc/def/abc001.jpg

※ 팁 : 상품 이미지의 가로/세로 비율을 동일하게 해주셔야, 추천 상품 영역의 룩앤필이 좋아집니다.

※ 레코픽은 상품이미지 파일을 저장하지 않고, URL 정보만 저장합니다.

recopick:price (정상가격)
* 필수 메타 입니다.

상품 가격

<예시> "55800"

recopick:price:currency (정상가격 표시)

* 필수 메타 입니다.

통화 단위

<예시> 원화인 경우 “KRW,” 달러화인 경우 “USD”, 엔화인 경우 “JPY”

recopick:sale_price (할인가격) 할인 가격 

<예시> "54600"

recopick:sale_price:currency (할인가격 표시)

할인 가격 통화 단위

<예시> 원화인 경우 “KRW,” 달러화인 경우 “USD”, 엔화인 경우 “JPY”

recopick:availability (상품 품절 표시 : 추천 상품 제외)

* 상품 품절인 경우에만 사용될 수 있도록 상품 품절여부를 체크하는 if 조건문 내에 위치시켜 주세요.

OOS (out of service 약자)

※ 레코픽에서는 다음과 같은 경우에도 품절로 간주합니다 : 추천 상품에서 제외됩니다.

- 상품에 대한 필수 메타정보가 없는 경우

- 상품 페이지의 URL로 접근하였으나 다른 페이지로 리다이렉트(redirect, 자동이동)되는 경우

- 상품 페이지의 HTML 문서 길이가 128 바이트 이하인 경우

recopick:brand (브랜드)브랜드명 <예시> “ Nike” 
recopick:author (판매자 or 제조사)

판매자 or 제조사 정보 <예시> "Ode"

recopick:description (상품설명)상품에 대한 설명

상품에 대한 간단한 설명을 넣어주세요.


  • 적용 후 검증 방법

    • 대시보드 접속 후 

    • 많이 본 상품 Top 100등의 메뉴에 들어갔을 때 상품별로 상품 상세정보(title, 금액, 이미지 등..)이 정상적인지 확인
    • 우측 상단에 검색할 상품 ID를 직접 입력하여 해당 상품검색과 상품 메타 정보가 정상적인지 확인 


<3단계> 추천 상품 노출

추천 상품을 노출 하기 위하여 추천 위젯추천 API 2가지 방식을 이용하여 선택적으로 상품 노출이 가능합니다. 

추천위젯의 경우 적용기간이 빠르긴 하지만 저희가 제공해 드리는 몇 개 template 내에서 선택하여 사용해야 하므로 고객사 사이트의 UX 에 맞지 않을 수 있습니다. 

이경우 API방식을 통하여 추천데이터만 받으셔서 자체적으로 화면을 디자인 하셔서 노출 하실 수 있습니다.

<3-1> 추천 위젯 이용 방식

 

 Admin Dashboard > 추천 위젯 설정에 들어가셔서 아래 가이드에 따라 추천위젯을 설정합니다.

 상품상세, 메인, 장바구니, 구매완료, 마이페이지 등 추가로 생성하신 후 생성된 스크립트를 고객님 쇼핑몰 페이지별로 적용해 주세요.


*추천 위젯을 삽입후 사이트에서 추천결과를 바로 확인하실 수 없습니다.

추천계산을 위해 데이터 수집 후, 2~3일이 지나서 추천결과를 확인하실 수 있는데 추천결과 반영은 메일을 통해 안내해 드립니다. 안내에 따라 노출을 원하시는 시점에 추천타입을 설정한 후 저장하시면 사이트에서 반영하실 수 있습니다.


1.     상품 상세 페이지 상단 (함께 본 상품 추천)

  1. 위젯 관리가 용의하도록 위젯명을 상품상세_상단으로 입력합니다.
  2. 채널별 성과분석시(추천클릭률, 추천경유매출 등) 비교가 용이하도록 detail_top으로 입력합니다. 
  3. 추천타입은 우선 사용안함으로 설정합니다. (데이터 수집후, 2~3일이 지나서 설정합니다.)
  4. 그 외 원하시는 대로 위젯 스타일을 변경하실 수 있으며 할인가 표시를 원하시면 표시여부를 체크해 주세요.  

    <위젯설정 예시>


  5. 모든 설정을 마친 후에는 꼭 저장 버튼을 클릭하시고 아래 위젯 적용 부분의 스크립트를 복사해서 고객님 사이트의 상품 상세 페이지 상단에 삽입해 주세요. <삽입 위치 참고>

    <위젯 적용><삽입 위치>


2.     상품 상세 페이지  (함께 구매한 상품 추천)

  1. 새 스타일 추가 버튼을 클릭해서 새로운 탭이 생성되면 위젯명을 상품상세_하단으로 입력합니다.

  2. 채널 별 성과 분석 시(추천클릭률, 추천경유매출 등) 비교가 용이하도록 detail_bottom으로 입력합니다. 

  3. 추천타입은 우선 사용안함으로 설정합니다. (데이터 수집후, 2~3일이 지나서 설정합니다.)

  4. 그 외 원하시는 대로 위젯 스타일을 변경하실 수 있으며 할인가 표시를 원하시면 표시여부를 체크해 주세요. 

    <위젯설정 예시>


  5. 모든 설정을 마친 후에는 꼭 저장 버튼을 클릭하시고 아래 위젯 적용 부분의 스크립트를 복사해서 고객님 사이트의 상품 상세 페이지 하단에 삽입해 주세요. <삽입 위치 참고>

    <위젯 적용><삽입 위치>


3.     메인 페이지  (실시간 개인화 추천)

  1. 새 스타일 추가 버튼을 클릭해서 새로운 탭이 생성되면 위젯명을 메인으로 입력합니다.

  2. 채널 별 성과분석시(추천클릭률, 추천경유매출 등) 비교가 용이하도록 main으로 입력합니다. 

  3. 추천타입은 우선 사용안함으로 설정합니다. (데이터 수집후, 2~3일이 지나서 설정합니다.)

  4. 그 외 원하시는 대로 위젯 스타일을 변경하실 수 있으며 할인가 표시를 원하시면 표시여부를 체크해 주세요. 

    <위젯설정 예시>
  5. 모든 설정을 마친 후에는 꼭 저장 버튼을 클릭하시고 아래 위젯 적용 부분의 스크립트를 복사해서 고객님 사이트의 메인 페이지에 삽입해 주세요. <삽입 위치 참고>

    <위젯 적용><삽입 위치>
     


4.     장바구니 페이지  (함께 구매한 상품 추천)

  1. 새 스타일 추가 버튼을 클릭해서 새로운 탭이 생성되면 위젯명을 장바구니로 입력합니다.

  2. 채널 별 성과분석시(추천클릭률, 추천경유매출 등) 비교가 용이하도록 basket으로 입력합니다. 

  3. 추천타입은 우선 사용안함으로 설정합니다. (데이터 수집후, 2~3일이 지나서 설정합니다.)

  4. 그 외 원하시는 대로 위젯 스타일을 변경하실 수 있으며 할인가 표시를 원하시면 표시여부를 체크해 주세요. 

    <위젯설정 예시>
  5. 모든 설정을 마친 후에는 꼭 저장 버튼을 클릭하시고 아래 위젯 적용 부분의 스크립트를 복사해서 고객님 사이트의 장바구니 페이지에 삽입해 주세요. <삽입 위치 참고>

    <위젯 적용><삽입 위치>
     


5.     주문완료 페이지  (실시간 개인화 추천)

  1. 새 스타일 추가 버튼을 클릭해서 새로운 탭이 생성되면 위젯명을 주문완료로 입력합니다.

  2. 채널 별 성과분석시(추천클릭률, 추천경유매출 등) 비교가 용이하도록 order_result으로 입력합니다. 

  3. 추천타입은 우선 사용안함으로 설정합니다. (데이터 수집후, 2~3일이 지나서 설정합니다.)

  4. 그 외 원하시는 대로 위젯 스타일을 변경하실 수 있으며 할인가 표시를 원하시면 표시여부를 체크해 주세요. 

    <위젯설정 예시>
  5. 모든 설정을 마친 후에는 꼭 저장 버튼을 클릭하시고 아래 위젯 적용 부분의 스크립트를 복사해서 고객님 사이트의 주문완료 페이지에 삽입해 주세요. <삽입 위치 참고>

    <위젯 적용><삽입 위치>
     

6.     마이 페이지  (실시간 개인화 추천)

  1. 새 스타일 추가 버튼을 클릭해서 새로운 탭이 생성되면 위젯명을 마이페이지로 입력합니다.

  2. 채널 별 성과분석시(추천클릭률, 추천경유매출 등) 비교가 용이하도록 mypage으로 입력합니다. 

  3. 추천타입은 우선 사용안함으로 설정합니다. (데이터 수집후, 2~3일이 지나서 설정합니다.)

  4. 그 외 원하시는 대로 위젯 스타일을 변경하실 수 있으며 할인가 표시를 원하시면 표시여부를 체크해 주세요. 

    <위젯설정 예시>
  5. 모든 설정을 마친 후에는 꼭 저장 버튼을 클릭하시고 아래 위젯 적용 부분의 스크립트를 복사해서 고객님 사이트의 마이 페이지에 삽입해 주세요. <삽입 위치 참고>

    <위젯 적용><삽입 위치>
  • 위젯을 이용한 추천서비스 시작 (추천우선 순위 설정)
    • 로그수집 스크립트, 메타태그, 추천위젯 삽입까지 모두 완료하셨나요?
    • 제대로 설치하셨다면 데이터 수집된후, 2~3일이 지나서 추천결과를 반영할 수 있습니다.  


추천결과 반영시점은 메일을 통해 알려드립니다. 메일을 받으신 후 안내에 따라  Admin Dashboard  > 추천 위젯 설정에 들어가셔서

사용안함으로 설정된 추천타입을 아래 가이드에 따라 설정한 후 저장하시면 사이트에서 추천결과를 확인 하실 수 있습니다. 


1.상품상세, 메인, 장바구니, 주문완료, 마이페이지 등에 아래 예제처럼 추천타입을 설정합니다.

2. 설정된 추천타입에 따라 그에 매치되는 타이틀로 변경합니다. (개인화 추천 예시 : ‘고객님을 위한 추천’, ‘고객님의 성향에 맞는 추천’ 등)

3. 모든 설정을 마친 후에는 꼭 저장버튼을 클릭하셔야 사이트에 반영됩니다. 

* 추천 설정은 가장 추천효과가 좋았던 best practice기반으로 안내하고 있으며 1순위 추천결과가 나타나지 않는 경우 다음 순위 추천결과를 노출합니다.

추천 설정상품상세_상단상품상세_하단메인  페이지

장바구니

주문완료마이페이지그외 페이지
1순위함께 본 상품 추천실시간 개인화 추천실시간 개인화 추천함께 구매한 상품 추천

실시간 개인화 추천

실시간 개인화 추천실시간 개인화 추천
2순위실시간 개인화 추천함께 구매한 상품 추천

통계형 추천

(구매전환율 TOP 100)

실시간 개인화 추천

함께 구매한 상품 추천

통계형 추천

(구매전환율 TOP 100)

통계형 추천

(구매전환율 TOP 100)
3순위

통계형 추천

(구매전환율 TOP 100)

통계형 추천

(구매전환율 TOP 100)
사용안함

통계형 추천

(많이 팔린 상품 TOP 100)

통계형 추천

(많이 팔린 상품 TOP 100)
사용안함사용안함


<3-2> API 방식

   

<4 단계> 추천성과 분석 

  • 추천 상품이 노출된 이후 해당 상품을 클릭하고 구매까지 이뤄지는 경우를 수집하여 추천서비스가 매출에 기여한 정도를 확인 할 수 있음
  • 적용 방법 1은 API를 통한 방식이고 적용방법 2는 추천 상품 노출 후 제공되는 click_log_ling 혹은 click_log_redirect_link값을 링크시켜 결과값을 전송하는 방식으로 선택적으로 사용 가능 함.
  • 적용 방법 1

  • 적용 방법2  

      • 추천 API(예시: view together API) 호출 시 아래와 같은 결과를 response로 받게 됨 
      • 상기  필드 중에  clicklog_link 또는 clicklog_redirect_link에 있는 URL값을 추천 상품을 클릭했을 때 호출하면 됨.
      • 여기서 clicklog_link의 경우 recopick log collector로 클릭 이벤트 정보만 전달 하게 되고, clicklog_redirect_link의 경우 클릭 이벤트 정보를 전달 한 이후 원하는 페이지로 redirect 됨.
      • 해당 부분을 구현 한 후 추천 상품을 클릭할 경우 아래와 같이 브라우저 URL입력 창에 recopick =4( 상기 method설정 값과 동일, 여기서 4는 view together 용 api를 호출한 경우  표시되면 됨
      • http://www.xxxx.co.kr/product/product_detail/6299536?recopick=4&product_type=R
      • 추가로 channel 값은 해당 api가 적용된 페이지를 구분 하는 기준으로 고객사가 임의로 설정(예, main_best) 을 하게 되면 대시보드 상에서 채널별로 api 호출 통계지표를 확인 할 수 있음. 설정하지 않을 경우 empty로 해서 표시됨
      • (warning) 주의하세요! 사용자들이 추천 리스트를 클릭하는 경우, clicklog_link 혹은 clicklog_redirect_link를 통해 추천 클릭로그를 남겨주셔야 합니다. 추천 클릭 로그를 제대로 남기지 않을 경우, 추천에 대한 성과를 계산할 수 없으며, 향후 추천 품질이 저하되는 문제가 생깁니다. 브라우저의 경우, 간단하게 clicklog_redirect_link 를 통해 추천 클릭로그를 남기면서, 페이지를 이동하게 하는 것을 추천 드리며, 불가피하게 clicklog_redirect_link를 사용할 수 없을 경우, 서버 혹은 ajax 등 다른 방법으로 clicklog_link를 호출하셔서 추천 클릭 로그를 남겨주시면 됩니다. (참고: 7) 추천상품 클릭 로그  → 추천상품 클릭로그는 clicklog_redirect_link를 API로 호출 하실 경우에 대한 정의가 되어 있음. )

        ※ 참고 : 추천 상품 클릭 시에 추천 API 결과에 있는 clicklog_link 혹은 clicklog_redirect_link를 반드시 레코픽으로 전달해주셔야 합니다. 그래야 레코픽 추천 성과가 잡힙니다.

        • 상품상세페이지의 URL 패턴이 정형화 되어 있지 않다면 clicklog_redirect_link는 사용하지 못하고, clicklog_link를 사용해주셔야 합니다.
        • clicklog_redirect_link : 추천된 상품에 대한 클릭 정보를 레코픽으로 전송한 뒤에 클릭된 상품의 상세페이지로 redirect시켜 드립니다.
        • clicklog_link : 추천된 상품에 대한 클릭 정보를 레코픽으로 전송합니다. 이 경우에는 추천된 상품의 상세페이지로 직접 이동해주셔야 합니다.

         또한, API 응답 내에 있는 위의 method 값을 아래 형식으로 상세페이지의 URL 파라미터에 추가적으로 넣어주셔야 하고, 추천 서비스를 사용하는 경우 'product_type=R' 파라미터도 추가적으로 넣어주셔야 합니다.

        • 형식 : recopick=method 값

        • 예1 : http://aaa.test.co.kr/product/detail.html?product_no=1338&recopick=4&product_type=R

        • 예2 : http://test.xxx.co.kr/product/product_detail/3395854?recopick=25&product_type=R

    • 검증방법

      • 좌측 추천 성과분석 하기 메뉴에서 각각 결과 값이 제공되는지 확인 할 수 있음
      • 추천성과분석\추천기여매출 페이지상에 파란색 막대가 생기면 정상적으로 추천상품을 클릭한 로그가 입수 됨을 확인 할 수 있음
  • No labels