> For the complete documentation index, see [llms.txt](https://docs.archisketch.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.archisketch.com/guide/dev-kr/builder/shopby/installation.md).
# 2.1. 샵바이: 앱(App) 설치 방법
### ✅ 미리 확인해주세요.
{% hint style="warning" %}
❗️ **관리자 계정**만 연동 진행이 가능합니다.
아키스케치와 연동을 진행하려면 **아키스케치 기업 관리자 계정** (Admin)이 필요합니다.\
관리자 계정이 없는 경우, **연동/설치 절차**를 진행 할 수 없습니다.
{% endhint %}
### 설치 순서
**아키스케치 ↔️ 샵바이 설치/연동 방법**은 크게 2단계로 진행됩니다.
1. **기업 관리자 계정 신청(생성).**
2. **아키스케치 앱 설치(Shopby)**
***
### 📌 1. 기업 관리자 계정 신청(생성)
{% hint style="info" %}
📘 이미 기업 계정을 가지고 있어요.
이미 **기업 관리자 계정**을 가지고 계신 분들은 **해당 스텝**을 넘겨주시면 감사하겠습니다. 🙇♂️
{% endhint %}
아키스케치 기업 서비스 구매자라면 누구나 **기업 관리자 계정**을 획득 할 수 있어요.
**아키스케치 기업 관리자 계정**(Admin)은 [**아키스케치 채널톡**](https://archisketch.channel.io/home) 또는 [**도입문의**](https://www.archisketch.com/kr/enterprisetrial)를 통해 요청하시면 생성 가능합니다.
***
### 📌 2. 아키스케치 앱 설치(Shopby)
{% stepper %}
{% step %}
### 샵바이 앱스토어에서 아키스케치 설치
[**NHN 샵바이 앱스토어**](https://apps.nhn-commerce.com/apps)에서 **아키스케치** 검색 후, **\[설치하기]** 버튼을 클릭해주세요.
{% endstep %}
{% step %}
### 설치할 쇼핑몰 선택
설치할 쇼핑몰을 선택하고 **\[설치] 버튼**을 클릭해주세요.
{% endstep %}
{% step %}
### 이용 약관 동의 및 설치
사용 권한 및 서비스 이용 약관 동의 화면에서 **\[동의 및 설치]** 버튼을 클릭하면 아키스케치 앱이 설치됩니다. 다음 단계인 앱 실행까지 진행하시면 연동이 완료됩니다.
{% endstep %}
{% step %}
### 아키스케치 앱 실행 및 연동 시작
1. **샵바이 쇼핑몰 어드민 > 앱 서비스 > 앱 리스트**에서 **아키스케치 앱 >\[실행] 버튼**을 클릭하면 아키스케치 연동 페이지로 이동합니다.
2. 이동된 연동 페이지 속 **\[연동 시작하기]** 버튼을 눌러 순차적으로 아키스케치 연동을 진행해주세요
{% endstep %}
{% step %}
### 기업 관리자 계정으로 로그인
**기업 관리자 계정**으로 로그인을 진행해주세요.
* ✅ **기업 관리자 계정**이 없으시다면, **\[ 1️⃣ 기업 관리자 계정 신청(생성) ]** 부분을 참조해주세요.
{% endstep %}
{% step %}
### 스크립트 설치
아키스케치가 연동되려면, 고객님의 웹사이트 속에 아키스케치 스크립트가 설치되어야 해요.
아키스케치 연동을 위해 **\[스크립트 설치하기]** 버튼을 클릭해주세요. 버튼만 클릭하면 스크립트는 자동으로 설치됩니다.
{% endstep %}
{% step %}
### 설치 완료 확인
아키스케치 설치가 완료되었습니다!
웹사이트 우측 하단에 아키스케치 버튼이 생성된 것을 확인해주세요. 이제 연동된 아키스케치를 활용하여 3D 인테리어 경험과 다양한 이벤트를 열어 새로운 매출과 잠재 고객들을 확보해보세요.
아키스케치 커넥터: 연동 완료 화면
샵바이 웹사이트: 연동 완료 화면
아키스케치 대시보드: 연동 완료 화면
{% endstep %}
{% endstepper %}
***
## 샵바이에서 제공하는 고객 정보
쇼핑몰 회원이 웹사이트에 방문하여 로그인 하거나, 신규 회원이 회원가입할 때 해당 고객 정보가 아키스케치로 자동 연동됩니다.
**고객 프로필 정보**
| 데이터 | 설명 |
| --------------------- | -------------------------------------------------------------------------------------------------------------------- |
| **member\_id** | 각 회원을 구분하는 고유 값 (회원 아이디 등) |
| **name** | 회원 이름 |
| **nickname** | 회원 별명 |
| **email** | 회원 이메일 |
| **member\_authority** | 회원 등급 및 권한
각 권한에 맞춰 아래와 같은 아키스케치 계정 권한을 갖습니다.
대표 운영자 => role: 3 (Admin)
일반회원 => role: 0 (NoRole)
|
| **use\_blacklist** | 블랙리스트 유저 체크
\* 블랙리스트 유저는 아키스케치 계정이 자동적으로 비활성화됩니다.
|
***
## 샵바이 프리미엄 가이드
아키스케치는 샵바이 SDK를 활용해서 고객 정보를 불러옵니다.
샵바이 프리미엄 고객사의 경우 원활한 고객 정보 및 주문 정보 연동을 위해서 아래의 가이드에 따라 개발해주시기 바랍니다.
[**샵바이 개발자 문서 링크**](https://admin-remote.shopby.co.kr/popup/variable-guide)
### 📌 스크립트 로드
[외부스크립트 호출 문서](https://nhnent.dooray.com/share/pages/WoOk8q6KT1K3MZcLSuyZsw/3520338822800071318)를 참고하여 상점에 설치된 스크립트를 로드하도록 개발해야 합니다.
### 📌 글로벌 변수 세팅
샵바이는 **글로벌 변수(sb)**가 선언되어야 유저 정보를 동기화 시킬 수 있습니다. 동기화를 위해 **글로벌 변수**를 선언해주세요.
```javascript
var sb
```
글로벌 변수 선언 후, profile 변수를 만들고 내부에 샵바이 회원 정보 조회 API를 활용해 회원의 정보를 가져올 수 있게 합니다. (참조: [API 문서](https://docs.shopby.co.kr/?url.primaryName=member/#/Profile/get-profile))
***
## 아키스케치 설치 해제하기
**\[샵바이 관리자 페이지] > \[앱 서비스] > \[설치 리스트]** 클릭 후, **\[설치한 앱]** 리스트를 조회해주세요.
**설치한 앱 리스트** 중 아키스케치 앱 속 **\[삭제]** 버튼을 클릭하면 아키스케치가 자동적으로 삭제됩니다. (단, 설치 해제해도 아키스케치에 기존에 누적된 모든 내용들은 삭제되지 않습니다.)
**\[설치된 앱 > 삭제 ]버튼**으로 앱 삭제하기