목적

본 문서는 오프라인 구매 제품에 대한 리뷰를 수집하는 법과, 온라인/오프라인 리뷰를 구분하는 방법에 대해 안내합니다.

<aside> 💡 온라인 리뷰

• 온라인몰에서 구매한 제품에 대해 작성된 리뷰를 의미합니다.

</aside>

<aside> 💡 오프라인 리뷰

• 오프라인 매장에서 직접 구매한 제품에 대한 리뷰를 의미합니다.

</aside>

오프라인 리뷰

오프라인 리뷰란?

고객사에서 오프라인 구매 데이터(주문 데이터)를 크리마에 연동하고, 크리마는 오프라인 리뷰를 수집 및 관리합니다.

• 오프라인에서 구매한 고객에게 리뷰 작성을 유도합니다.
• 크리마 리뷰를 사용하는 온라인 몰에서 오프라인 구매 고객의 리뷰를 노출합니다.
  • 오프라인에서 구매한 고객의 리뷰인 경우, 오프라인 매장명을 노출합니다.
• 크리마 관리자에서 오프라인 매장에 따라 리뷰를 필터링하여 관리할 수 있습니다.

오프라인 리뷰 사용 필수 조건

• 오프라인 리뷰에 대해 크리마에서 컨설팅 받으신 후 관련 기능 활용을 위한 과금이 결제되어야 합니다. 결제 후 기능 사용 가능합니다.
• 보유하고 계신 오프라인 주문 정보를, 사용하고 계신 운영 호스팅사(메이크샵, 위사 등)에서 크리마로 연동해줄 수 있어야 합니다. 또는, 고객사가 직접 크리마API를 통해 오프라인 주문을 연동할 수 있어야 합니다.
• 온/오프라인 상품 정보가 통합되어야 합니다.
  • 사용할 수 없는 경우 온라인에 A라는 코드의 상품과 오프라인의 A라는 코드의 상품이 완전히 다른 상품인 경우 = 미통합되어 오프라인 리뷰를 사용할 수 없습니다.

오프라인 주문 데이터 연동 방법

1. 오프라인 주문건에 대해, 기존에 orderAPI(주문API), suborderAPI(주문품목API) 개발하여 온라인 주문 호출하시던 API와 동일한 API로 호출
   1. orderAPI, SuborderAPI 개발 방법
2. 파라미터 호출 시, 오프라인 주문이기 때문에, 아래 a, b, c 사항 추가하여 호출

   1. 오프라인 주문으로 구분

      기존에 연동 중이던 온라인 주문과, 새롭게 보낼 오프라인 주문을 구분하기 위해 사용합니다.

      • SuborderAPI, 'delivery_service' parameter 보낼 때, 'pick_up'(직접배달/수령)으로 호출 (참고: 택배사 개발 문서)

   2. 구매 매장명 호출

      작성된 오프라인 리뷰에 매장명을 노출할 때 사용합니다.

      • OrderAPI에서, store_name 파라미터 호출

   3. 오프라인 주문 특수성에 기인한 주문/배송 시각 조치

      • 오프라인 주문이라 직접 수령한 것이므로, 아래 3가지 파라미터를 온라인 주문과는 다르게 동일 날짜와 동일 시각으로 호출
        1. OrderAPI에서 Create a order할 때,
           1. 주문일(created_at)
        2. SuborderAPI에서 Create a suborder할 때,
           1. 배송시작일(delivery_started_at)
           2. 배송완료일(delivered_at)

검수 및 오프라인 주문 연동 기능 라이브 방법

1. 크리마 서비스를 아직 사용하기 전인 경우 → 라이브서버에서 작업
   • 크리마 서비스를 본격적으로 사용하시기 전에는, 크리마의 라이브서버는 마치 테스트서버처럼 동작하게 되어 있습니다. 라이브서버로 연동해주시면 됩니다.
   • API 개발을 완료하시고, 검수를 위해 필요한 최소한의 데이터를 호출 넣어 검수 요청주시면, 검수하고 결과 알려드리겠습니다.
2. 이미 크리마 서비스를 라이브 중인 경우 → 테스트서버에서 작업
   • 오프라인 주문을 크리마API로 호출할 준비 해주시고, 테스트서버 세팅을 요청해주세요. (테스트서버 세팅에는 업무일 기준 최대 5일 소요)
     • API Key (app id, secret): 라이브서버와 동일합니다.
     • 호출 엔드포인트로 서버를 구분합니다. 토큰은 라이브서버와 테스트서버 별개로 받아 사용하세요.
       1. 라이브서버 엔드포인트: api.cre.ma
       2. 테스트서버 엔드포인트: sapi.cre.ma
   • API 개발을 완료하셔서 현재 호출중인 api.cre.ma(라이브서버 호출 엔드포인트)가 아닌, 저희측 테스트서버 sapi.cre.ma로 1, 2개 주문건에 대해 테스트 호출 넣어 검수 요청주세요.
   • API 개발을 완료한 후 테스트서버 엔드포인트 sapi.cre.ma로 1,2개 주문건에 대해 테스트 호출을 넣고 검수 요청주세요.
     • 크리마에서 잘 개발되었는지 검수해드립니다.
     • 검수 통과되면 라이브서버 호출 엔드포인트(api.cre.ma)로 호출해주시면 됩니다.
     • 오프라인 주문 고객에게 작성 유도 메세지를 발송하고 싶다면, 매장 구매 고객에게 보낼 디폴트 메시지 설정이 필요합니다. (알림톡이 아닌, 챗봇 발송 중인 경우는 기존 챗봇 메시지와 동일한 메시지 발송)
       • 설정법
         • 요청주시면 테스트서버에 메시지 문구 등 설정해드리겠습니다.
         • 이후 테스트서버에 오프라인 주문을 호출해주세요.
         • 크리마 내부 시뮬레이터로 발송 된 메일 리턴으로 알림톡 발송 여부 및 내용 확인이 가능합니다.
         • 확인 완료 후, 라이브서버에 실제 알림톡 문구 등 심사를 넣습니다.
           • 알림톡을 등록하고 카카오에 심사 진행이 필요하기 떄문에 최소 3일 최대 7일의 시간이 필요
         • 데이터를 매일 배치를 통해 넣어주시기 시작하면, 관련 기능이 동작하기 시작합니다.

온/오프라인 리뷰 구분법

• 크리마 리뷰API에서, List reviews 와 Get a review 활용하여 리뷰를 가져갈 수 있습니다.
• 오프라인 리뷰는
  • list 또는 get으로 리뷰 데이터를 꺼내갈 때, 응답값에 store_name과 store_order가 있습니다.
  • store_order가 true이고, store_name에 데이터가 있다면, 오프라인 주문으로 판단합니다. (그 외 데이터는 온라인 주문으로 판단)
  • store_name에 데이터가 매장명입니다.

Q&A

• 오프라인 주문건은 어떤 시점에 리뷰 작성을 유도하는 메시지가 고객에게 발송되나요?
• 온/오프라인 주문건 리뷰 작성 유도 메시지는 발송 문구를 구분해 설정할 수 있나요?
• 온/오프라인 리뷰 작성 유도 메세지가 발송되는 시점을 구분해서 설정할 수 있나요? (오프라인은 특정 시간에만 일괄 발송, 온라인은 특정 시간에만 일괄 발송 등)