> For the complete documentation index, see [llms.txt](https://www.analytics-docs.laplacetec.com/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.analytics-docs.laplacetec.com/guide/startguide/connect/mall/smartstore.md).

# 스마트스토어 연결

라플라스에 네이버 스마트스토어를 연결하는 방법입니다. 상품·주문 API 대행사로 라플라스 애널리틱스를 등록하고 API 연동용 판매자 ID를 입력하는 순서와 FAQ를 안내합니다.

{% hint style="danger" %}
스마트스토어 센터에서 **라플라스 애널리틱스**를 **상품 API** 와 **주문 API** 의 API 대행사로 등록하신 후, 라플라스 화면에 **API 연동용 판매자 ID**를 입력하셔야 연결이 가능합니다. <mark style="background-color:red;">**두 API 중 한 쪽만 등록**</mark>하시면 연결이 완료되지 않으니 순서를 꼭 맞추어 진행해 주세요.
{% endhint %}

## 스마트스토어 연결 가이드

1. 왼쪽 레일의 **데이터 연결**을 누른 뒤, 탐색 패널의 **커넥터 검색**에 스마트스토어를 입력하거나 **쇼핑몰 연결** 카테고리에서 **스마트스토어 연결**을 눌러 주세요.

   ![스마트스토어 연결 화면](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-d29d5bd329b291237ee0e7e342908846963464a5%2Fstartguide__connect__mall__smartstore__01.png?alt=media)

{% hint style="info" %}
아직 연결한 계정이 없으면 커넥터 화면에 **연결하면 이런 분석을 할 수 있습니다**가 보여요. **샘플 보기**를 누르면 연결 후 볼 수 있는 화면을 샘플 데이터로 미리 볼 수 있습니다.
{% endhint %}

2. 스마트스토어 센터의 **스토어 관리 > 스토어 설정 > API 관리**에서 **API 사용 설정**을 **사용**으로 선택하신 후, **API 대행사** 의 **상품 API** 와 **주문 API** 에 **라플라스 애널리틱스**를 각각 등록하고 저장해 주세요.

   ![](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-aadf162afc52597d746f1531a9e97faf235c258a%2Fc41b534c3e4e.png?alt=media)

{% hint style="danger" %}
**상품 API와 주문 API 두 곳 모두 등록해 주셔야 해요.**

👉 한 쪽만 등록하시면 인증이 통과되지 않거나, 등록하지 않은 쪽의 데이터를 가져올 수 없어 차트가 비어 보일 수 있어요.

👉 자세한 내용은 하단의 [**API 대행사 등록하기**](#api)를 확인해 주세요.
{% endhint %}

3. 라플라스 화면으로 돌아와 **스마트스토어 연결** 화면 머리글 오른쪽의 **데이터 연결**을 눌러 연결 창을 열어 주세요. 창 위쪽 **연결 순서**에서 지금 단계를 확인할 수 있어요. **연결 정보**에 스마트스토어의 API 연동용 판매자 ID를 입력하신 후 **인증 버튼**을 클릭해 주세요.

   ![스마트스토어 연결 창 API 연동용 판매자 ID 입력](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-580ecd990e32bf9f7db0e9ed1ef67581aea79648%2Fstartguide__connect__mall__smartstore__02.png?alt=media)

{% hint style="warning" %}
⚠️ 스마트스토어 로그인용 아이디를 입력하실 경우 연동이 불가합니다. “**API 연동용 판매자 ID**”를 입력하셔야 정상 소싱이 가능합니다.
{% endhint %}

{% hint style="info" %}
**API 연동용 판매자 ID는 어디서 확인할 수 있나요?**

👉 스마트스토어 센터의 **스토어 관리 > 스토어 설정 > API 관리**에서 확인할 수 있어요.

👉 자세한 내용은 하단의 [**API 연동용 판매자 ID 확인하기**](#api-id)를 확인해 주세요.
{% endhint %}

4. 대행사 등록과 판매자 ID가 모두 확인되면 연결 창에 **스토어 정보 확인 중**이 보이고, 라플라스가 스토어 정보를 읽어와 데이터를 가져오는 작업을 바로 시작합니다. 이 창을 닫으셔도 연결은 계속 진행됩니다.

{% hint style="danger" %}
**대행사 등록을 먼저 마치신 후에 인증을 눌러 주세요.**

👉 인증은 누르시는 그 자리에서 끝납니다. 대행사 등록이 되지 않은 상태로 누르시면 오류 안내가 뜨고 연결은 접수되지 않아요.

👉 이때는 **상품 API** 와 **주문 API** 두 곳 모두에 **라플라스 애널리틱스**를 등록하고 저장하신 뒤, 라플라스에서 **인증**을 다시 눌러 주세요. 화면을 그대로 두어도 자동으로 재시도되지 않습니다.
{% endhint %}

* 연결한 계정은 커넥터 화면의 연결 표에 보여요. 행 오른쪽 ⋯(**작업 더 보기**)에서 **최신화**와 **인증 갱신**을 할 수 있습니다.

연동하실 몰의 창사 이래 데이터를 가져오기 때문에 **데이터양이 많을 경우 1시간 이상 소요**될 수 있어요

{% hint style="info" %}
**데이터 연동이 왜 오래 걸리나요?**

👉 라플라스에서는 스마트스토어의 데이터를 가져오기만 하는 것이 아니라 가져온 데이터를 정제하고 차트를 그려주는 작업을 해주기 때문이에요. 소요되는 시간 또한 데이터의 양이 많을수록 오래 걸릴 수도 있어요.

💬 진행 상황은 상단 바 오른쪽 **작업 · 데이터 상태**에서 확인할 수 있고, 연동이 완료되면 이메일로도 알려 드려요. 라플라스를 종료해도 수집은 계속되니 안심하시고 종료하셔도 됩니다.
{% endhint %}

## API 대행사 등록하기 <a href="#api" id="api"></a>

1. 스마트스토어 센터의 **스토어 관리 > 스토어 설정 > API 관리**로 이동해 주세요.
2. **API 사용 설정**을 **사용**으로 선택해 주세요.
3. **API 대행사** 의 **상품 API** 와 **주문 API** 드롭다운에서 각각 **라플라스 애널리틱스**를 선택해 주세요.
4. 하단의 **저장** 버튼을 눌러주세요.

   ![](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-aadf162afc52597d746f1531a9e97faf235c258a%2Fc41b534c3e4e.png?alt=media)

{% hint style="warning" %}
**상품 API와 주문 API 두 곳 모두 등록해 주셔야 해요.**

👉 한 쪽만 등록하시면 등록하지 않은 쪽의 데이터를 가져올 수 없어 차트가 비어 보일 수 있어요.
{% endhint %}

{% hint style="info" %}
**이미 다른 대행사가 등록되어 있어요.**

👉 기존 대행사를 지우실 필요는 없어요. **+ 대행사추가** 버튼으로 **라플라스 애널리틱스**를 추가로 등록해 주세요.
{% endhint %}

{% hint style="info" %}
**대행사로 등록하면 어떤 정보가 수집되나요?**

👉 상품과 주문 데이터만 조회합니다. 결제 정보가 수정되거나 정산 계좌 정보가 수집되지 않으니 안심하고 등록해 주세요.
{% endhint %}

## API용 판매자 ID 확인하기 <a href="#api-id" id="api-id"></a>

1. 좌측 네비바에서 **스토어관리 > 스토어 설정 > API 관리**로 이동해 주세요.
2. API 연동용 판매자 ID를 확인해 주세요.

   ![](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-2e3893e419e13b5a0abce0db2950adb2ea39710f%2Fdc611b89efd0.png?alt=media)

* 이미지와 같이 해당 ID를 복사해 라플라스 연결 창의 **연결 정보**에 붙여 넣은 후 **인증** 버튼을 눌러주세요.

{% hint style="danger" %}
API 사용 설정의 API ID를 입력하시면 연결이 되지 않습니다. 꼭 API 연동용 판매자 ID를 입력해주셔야 정상 연결이 가능합니다.
{% endhint %}

## FAQ

{% hint style="info" %}
브랜드명 변경은 어떻게 하나요?

🛠 현재 브랜드명 변경 기능은 업데이트 예정입니다. 브랜드명 변경이 필요하신 경우 라플라스로 문의해 주세요. 담당 엔지니어가 빠르게 처리할 수 있도록 도와드리겠습니다.
{% endhint %}

{% hint style="info" %}
운영을 멈춘 브랜드의 데이터가 옵니다.

🛠 라플라스의 커넥터들은 계정 연결 시 해당 계정에 있는 모든 데이터를 가져옵니다. 불필요한 몰의 데이터가 온다면 **설정 › 데이터 소스**에서 해당하는 몰의 **분석 포함**을 끈 뒤 **저장 후 다시 집계**를 눌러 주세요. 분석에서 빼도 수집은 계속됩니다. 삭제 기능은 업데이트 예정 기능으로 라플라스 팀에 문의하시면 해당 데이터 삭제 처리 도와드리겠습니다.
{% endhint %}

{% hint style="info" %}
대행사 등록을 마쳤는데 인증이 통과되지 않아요.

🛠 **상품 API** 와 **주문 API** 중 한 곳만 등록되어 있을 수 있어요. 스마트스토어 센터의 **스토어 관리 > 스토어 설정 > API 관리**에서 두 곳 모두에 **라플라스 애널리틱스**가 등록되어 있는지, **저장**을 누르셨는지 확인하신 후 라플라스에서 **인증**을 다시 눌러 주세요.
{% endhint %}

{% hint style="info" %}
연결은 되었는데 데이터가 오지 않아요.

🛠 대행사 등록이 한 쪽만 되어 있을 수 있어요. 두 곳 모두 등록하신 뒤에는 별도 재연결 없이 다음 데이터 수집 주기부터 정상적으로 데이터를 가져옵니다.
{% endhint %}

{% hint style="info" %}
API용 판매자 ID를 잘못 입력했어요.

🛠 알맞는 API 연동용 판매자 ID를 다시 입력하신 후 **인증** 버튼을 눌러 주세요.
{% endhint %}

## 전담 매니저에게 요청하기

스마트스토어 데이터 연결에 어려움이 있으신가요?

하단의 문의하기 혹은 홈페이지의 채팅 상담을 통해 문의하세요. 담당 매니저가 도움을 드리도록 하겠습니다.

> 💬 [채팅으로 문의하기](https://laplacetec.channel.io/lounge)
>
> 💬 [홈페이지에서 문의하기](https://www.analytics.laplacetec.com/contact)

**이메일 문의:** [**product@laplacetec.com**](mailto:product@laplacetec.com)
