# 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 %}
### Step 01
[**NHN 샵바이 앱스토어**](https://apps.nhn-commerce.com/apps)에서 **아키스케치** 검색 후, **\[설치하기]** 버튼을 클릭해주세요.
{% endstep %}
{% step %}
### Step 02
설치할 쇼핑몰을 선택하고 **\[설치] 버튼**을 클릭해주세요.
{% endstep %}
{% step %}
### Step 03
사용 권한 및 서비스 이용 약관 동의 화면에서 **\[동의 및 설치]** 버튼을 클릭하면 아키스케치 앱이 설치됩니다. 다음 단계인 앱 실행까지 진행하시면 연동이 완료됩니다.
{% endstep %}
{% step %}
### Step 04
1. **샵바이 쇼핑몰 어드민 > 앱 서비스 > 앱 리스트**에서 **아키스케치 앱 >\[실행] 버튼**을 클릭하면 아키스케치 연동 페이지로 이동합니다.
2. 이동된 연동 페이지 속 **\[연동 시작하기]** 버튼을 눌러 순차적으로 아키스케치 연동을 진행해주세요
{% endstep %}
{% step %}
### Step 05
**기업 관리자 계정**으로 로그인을 진행해주세요.
* ✅ **기업 관리자 계정**이 없으시다면, **\[ 1️⃣ 기업 관리자 계정 신청(생성) ]** 부분을 참조해주세요.
{% endstep %}
{% step %}
### Step 06
아키스케치가 연동되려면, 고객님의 웹사이트 속에 아키스케치 스크립트가 설치되어야해요.
아키스케치 연동을 위해 **\[스크립트 설치하기]** 버튼을 클릭해주세요. 버튼만 클릭하면 스크립트는 자동으로 설치됩니다.
{% endstep %}
{% step %}
### Step 07
아키스케치 설치가 완료되었습니다!
웹사이트 우측 하단에 아키스케치 버튼이 생성된 것을 확인해주세요. 이제 연동된 아키스케치를 활용하여 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))
***
## 아키스케치 설치 해제하기
**\[샵바이 관리자 페이지] > \[앱 서비스] > \[설치 리스트]** 클릭 후, **\[설치한 앱]** 리스트를 조회해주세요.
**설치한 앱 리스트** 중 아키스케치 앱 속 **\[삭제]** 버튼을 클릭하면 아키스케치가 자동적으로 삭제됩니다. (단, 설치 해제해도 아키스케치에 기존에 누적된 모든 내용들은 삭제되지 않습니다.)
**\[설치된 앱 > 삭제 ]버튼**으로 앱 삭제하기
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.archisketch.com/dev-guide/builder/shopby/installation.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.