> 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).

# 스마트스토어 연결

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

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

1. 화면 좌측의 **\[데이터 연결]** 에서 **\[스마트스토어 연결]**&#xC744; 눌러주세요.

   ![](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2FwXj6QUWTokqRy4UHlysd%2Fimage.png?alt=media\&token=9fb3cbb6-6680-4493-8d05-8851ebeed62e)
2. 스마트스토어 센터의 **\[스토어 관리] > \[스토어 설정] > \[API 관리]**&#xC5D0;서 **\[API 사용 설정]**&#xC744; **\[사용]**&#xC73C;로 선택하신 후, **\[API 대행사]** 의 **\[상품 API]** 와 **\[주문 API]** 에 **\[라플라스 애널리틱스]**&#xB97C; 각각 등록하고 저장해 주세요.

   ![](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-5c9de62ed680907f2224ef6d13f5d69c1787fcf4%2Fstartguide-connect-mall-smartstore-api-agency.png?alt=media)

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

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

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

3. 라플라스 화면으로 돌아와 스마트스토어의 API 연동용 판매자 아이디를 입력하신 후 **\[인증] 버튼**을 클릭해 주세요.

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

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

👉 스마트스토어 센터의 **\[스토어 관리] > \[스토어 설정] > \[API 관리]**&#xC5D0;서 확인할 수 있어요.

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

4. 대행사 등록과 판매자 ID가 모두 확인되면 라플라스가 스토어 정보를 읽어와 데이터를 가져오는 작업을 바로 시작합니다.

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

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

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

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

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

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

💬 연동이 완료되면 화면 좌측 상단에 연결 완료 알림과 이메일을 받을 수 있어요. 라플라스를 종료해도 연결이 되니 안심하시고 종료하셔도 됩니다.
{% endhint %}

## API 대행사 등록하기

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

   ![](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-5c9de62ed680907f2224ef6d13f5d69c1787fcf4%2Fstartguide-connect-mall-smartstore-api-agency.png?alt=media)

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

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

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

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

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

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

## API용 판매자 ID 확인하기

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

   ![](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2FSsIUsaEOsZluGdGefdDH%2Fimage.png?alt=media\&token=af96ed8c-2096-488b-898a-2531535a799c)

* 이미지와 같이 해당 ID를 라플라스 로 이동해서 붙여 넣기 후 **\[계정 연결>]** 버튼을 눌러주세요.

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

## FAQ

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

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

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

🛠 라플라스의 커넥터들은 계정 연결 시 해당 계정에 있는 모든 데이터를 가져옵니다. 불필요한 몰의 데이터가 온다면 **\[설정] → \[데이터 연결]**&#xC5D0;서 해당하는 몰을 **OFF**로 전환해 주세요. 삭제 기능은 업데이트 예정 기능으로 라플라스 팀에 문의하시면 해당 데이터 삭제 처리 도와드리겠습니다.
{% endhint %}

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

🛠 **\[상품 API]** 와 **\[주문 API]** 중 한 곳만 등록되어 있을 수 있어요. 스마트스토어 센터의 **\[스토어 관리] > \[스토어 설정] > \[API 관리]**&#xC5D0;서 두 곳 모두에 **\[라플라스 애널리틱스]**&#xAC00; 등록되어 있는지, **\[저장]**&#xC744; 누르셨는지 확인하신 후 라플라스에서 **\[인증]**&#xC744; 다시 눌러 주세요.
{% 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)
