목적

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

<aside> 💡 온라인 리뷰

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

</aside>

<aside> 💡 오프라인 리뷰

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

</aside>

오프라인 리뷰

오프라인 리뷰란?

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

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

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

• 오프라인 리뷰에 대해 크리마 컨설팅팀을 통해 컨설팅 받으신 후 관련 기능 활용을 위한 과금이 결제되어야 합니다. 결제 후 기능 사용 가능합니다.
• 보유하고 계신 오프라인 주문 정보를, 사용하고 계신 운영솔루션(카페24, 메이크샵,위사 등)에서 크리마로 연동해줄 수 있어야 합니다. 또는, 고객사가 직접 크리마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)로 호출해주시면 됩니다.
     • 데이터를 매일 배치를 통해 넣어주시기 시작하면, 관련 기능이 동작하기 시작합니다.
       • 만약 오프라인 주문 고객에게 작성 유도 메세지를 발송하고 싶다면, SMS ~~~~또는 알림톡으로 매장 구매 고객에게 보낼 디폴트 메세지를 말씀해주세요. 발송되도록 세팅이 필요합니다. (세팅 전에는 발송되지 않음, 4월 이후부턴 SMS 사용 안됨)

         • SMS 메세지 디폴트 값

           [%{brand_name}] 구매해주셔서 감사합니다. 상품은 어떠신가요? 구매상품확인:%{review_url}

         • 알림톡 메세지도 문구 설정 가능 (디폴트 값은 없음)

         • 참고

온/오프라인 리뷰 구분법

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

Q&A

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