• 설명: 설치하기 전, 양사에서 작업 내용을 상세하게 확인/검토
• 예상 일정: 평균 1주 소요
• 완료 조건: 각 회사 담당자가 모여 문서에 대해 함께 검토를 완료할 것

개요

• 크리마, 고객사 개발사 간 설치를 위한 작업 내용을 함께 검토하고 숙지합니다.
• 가능하다면 담당자끼리 모여 화상 미팅을 통해 작업 내용에 대해 이야기하는 시간을 갖습니다.
  • 참여 담당자
    1. 크리마 컨설팅팀 담당자 (최초 결제 도입 시 고객사와 미팅, 연락하였던 담당자)
    2. 크리마 설치 담당자
    3. 고객사 몰 운영 담당자 중 책임자 (실제로 서비스를 쓰실 분)
    4. 고객사 설치 기술자
• 화상 미팅이 어렵다면, 2번과 4번 담당자가 유선으로 소통하여 설치 내용을 숙지합니다.
• 화상 미팅이 가능하신 시각과 참여자를 1 또는 2 담당자에게 알려주세요.

참고 문서

1. 크리마 API 문서 (크리마 개발자 센터)

   1. API app id, secret을 활용한 token 발급
      1. 참고: app id, secret은 결제 직후에 담당자분께 메일로 발송됩니다.
   2. API 에러 코드 문서

2. 크리마 API 개발 가이드 추가 설명 문서

3. 크리마 관리자 페이지

   1. 참고: 로그인할 ID, PW는 고객사 담당자 분이 크리마에 가입, 결제하신 계정으로, 고객사 담당자 분이 알고 있습니다. 결제 하여 사용하실 서비스에 대해서만 설치하시면 됩니다.

4. 크리마 서비스 샘플 사이트: 서비스 별 설치하실 수 있는 위젯에 대한 상세 안내 페이지입니다.

   • 리뷰 샘플 사이트
   • 타겟 샘플 사이트
   • 핏 샘플 사이트
   • 참고
     • 설치하고 싶으신 위젯을 정확하게 명칭 그대로 보내주시면 설치 진행 과정에서 참고하겠습니다.
     • 샘플 사이트에 존재하는 위젯만 설치 가능하며, 기본적으론 폰트, 색상과 같은 간단한 변경만 가능합니다. 희망하시는 수정 내용에 따라 수정 가능 여부가 달라지니, 어떤 수정 희망하시는지 상세히 정리하여 문의 부탁드립니다.

참고 사항

• 아래 환경의 경우 개발 시 어려움을 겪으시는 경우가 있었습니다. 만약 연관되는 부분이 있다면 알려주시면 대응 시 참고하겠습니다.
  1. Viewport를 특정 px로 쓰고 계신 경우: ex) device-width가 아닌, 720px로 고정 사용
  2. SPA (ReactJS) 사이트
     1. 리액트(또는 뷰) 홈페이지를 운영하는 쇼핑몰 중에도 크리마 서비스를 정상적으로 이용하고 있는 곳들이 있습니다.
     2. 다만 리액트 기반 쇼핑몰에서 크리마 위젯 사용시 발생하는 문제들이 있는데, 이것들은 보통 reactivity 관련 문제라 리액트 코드를 수정해야 합니다. 저희쪽에서 고객사 홈페이지 코드를 접근할 수 없으니, 고객사 개발팀에 수정 요청을 드릴 수밖에 없습니다.
     3. 현재는 이런 요청에 대응할 수 있는 인력을 갖춘 쇼핑몰들만 크리마 서비스를 이용하고 있습니다. 코딩 방식에 따라 SPA 기반 홈페이지만의 이슈가 발생할 수 있고 이슈가 발생했을 때, 이를 홈페이지 개발사에서 처리할 수 있는 능력이 있어야 합니다.
     4. 기술 스택만 고려해 말씀드리면 도입은 가능하나 위 내용을 참고해주셔야 합니다.
     5. 리액트 기반 쇼핑몰에서 크리마 위젯이 정상 동작하는지는 실제로 크리마 위젯을 설치하고 동작하는지 양사가 확인해야 합니다. 관련해 대응이 필요하시면 문의 부탁드립니다.
  3. 아이프레임(iframe)이 중첩된 구조의 사이트
  4. 기타 특수한 구조의 사이트
• 작업을 저희 개발팀과 소통하며 진행하실 수 있도록 대화 채널(메신저 채널)을 개설해드립니다.
  • 개설해드리는 툴은 '슬랙'입니다.
  • 호출하신 내역이나 캡쳐 등을 보내주시면 어떤 부분이 문제인지 가이드드립니다.

필수 구현 API

결제하신 서비스에 따라, 크리마 API 중 필수 구현해야 할 API 항목을 안내드립니다. 현재 크리마 서비스는 총 3개가 있습니다(리뷰, 타겟, 핏). 어떤 서비스를 결제하셨는지 정확히 확인 후 작업하시면 됩니다.

크리마의 모든 서비스는 쇼핑몰의 데이터를 활용해 최적화된 타이밍에 적절한 기능을 제공하기 때문에, 예상보다 많은 종류의 데이터가 연동되어야 서비스 로직이 정상 동작합니다. 필수라 적힌 것은 미구현 시 서비스 사용이 불가능합니다.