> 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/shopline.md).

# 샵라인 연결

라플라스에 샵라인(SHOPLINE) 쇼핑몰을 연결하는 방법입니다. 샵라인 관리자에서 담당자를 추가해 API 키(Access Token)를 발급하는 순서와 연결이 불가능한 케이스를 안내합니다.

{% hint style="info" %}
샵라인(SHOPLINE)은 샵라인 관리자에서 발급한 **API 키(Access Token) 하나**만 있으면 연결됩니다. 해외 통화 매출은 「데이터 관리」 › 「환율」 설정으로 원화(KRW)로 환산해 다른 채널과 함께 볼 수 있어요.
{% endhint %}

## 샵라인 연결 가이드

1. 샵라인 관리자에 로그인한 뒤 「**Settings > Permission & Security**」 메뉴로 이동해 주세요. 관리자 버전에 따라 「**Staff Settings**」로 표시될 수 있습니다. 「**Add**」 버튼을 눌러 새 담당자(Staff)를 추가해 주세요.

   ![샵라인 관리자 담당자 추가](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-cd1d204e8156f8dd048a26061cd2a8913587f1d3%2Fstartguide__connect__mall__shopline__01.png?alt=media)
2. 이메일 주소를 입력해 담당자를 추가한 뒤 「**API Auth**」 탭을 선택해 주세요. 「**Give Full Access**」를 체크하고 아래로 스크롤해 주세요.

   ![샵라인 관리자 API Auth 권한 부여](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-27b0761e698d34f11805ba322abb59d28dd92d70%2Fstartguide__connect__mall__shopline__02.png?alt=media)

{% hint style="warning" %}
**「API Auth」** 탭이 보이지 않으면 SHOPLINE 담당자에게 OpenAPI 사용 권한을 먼저 요청해야 합니다.
{% endhint %}

3. 화면 하단의 **「Generate」** 버튼을 눌러 토큰(Access Token)을 발급하고, 발급된 토큰을 복사해 주세요.

   ![샵라인 관리자 Access Token 발급](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-7edab0b99fcdf854d0c192ae13a445f81bc8507a%2Fstartguide__connect__mall__shopline__03.png?alt=media)

{% hint style="danger" %}

* 만료일(**Expired At**)은 비워 주세요. 비워 두면 토큰이 만료되지 않습니다. 날짜를 넣으면 그날 수집이 중단됩니다.
* 토큰 발급 후 나타나는 **IP 화이트리스트**는 비워 주세요. 등록하면 라플라스 수집 서버가 차단됩니다.
  {% endhint %}

4. 라플라스로 돌아와 왼쪽 레일의 「데이터 연결」을 누른 뒤, 탐색 패널의 「커넥터 검색」에 샵라인을 입력하거나 「글로벌 쇼핑몰 연결」 카테고리에서 「샵라인 연결」을 눌러 주세요.

   ![샵라인 연결 화면](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-13817dc7744be9ff3b6f57143d9fc90658a52e6e%2Fstartguide__connect__mall__shopline__04.png?alt=media)
5. 「샵라인 연결」 화면 머리글 오른쪽의 「데이터 연결」을 눌러 연결 창을 열어 주세요. 창 위쪽 「연결 순서」에서 지금 단계를 확인할 수 있어요. 「API 키 입력」의 「**API 키**」에 복사한 토큰을 붙여 넣고 「**샵라인 계정연동**」을 눌러 주세요.

   ![샵라인 연결 창 API 키 입력](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-efc2ae9bf15af2a4ce7d932393c7a11802eb7e78%2Fstartguide__connect__mall__shopline__05.png?alt=media)

{% hint style="info" %}
아직 연결한 계정이 없으면 커넥터 화면에 「연결하면 이런 분석을 할 수 있습니다」가 보여요. 「샘플 보기」를 누르면 연결 후 볼 수 있는 화면을 샘플 데이터로 미리 볼 수 있습니다. 화면 아래 「연결 순서」와 「시작 전 준비물」에서 연결 단계와 미리 준비할 것도 확인해 주세요.
{% endhint %}

* 연결한 계정은 커넥터 화면의 연결 표에 보여요. 행 오른쪽 ⋯(「작업 더 보기」)에서 「최신화」와 「인증 갱신」을 할 수 있습니다.
* 연동하실 몰의 창사 이래 데이터를 가져오기 때문에 **데이터양이 많을 경우 1시간 이상 소요**될 수 있어요.

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

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

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

## 샵라인 연결이 불가능한 케이스

{% hint style="warning" %}
「**API 키가 올바르지 않거나 만료되었습니다**」가 보여요.

* 토큰이 만료됐거나 잘못 복사됐을 수 있어요.

👉 샵라인 관리자에서 키를 다시 발급받아 입력해 주세요. 만료일(Expired At)은 비워 두세요.
{% endhint %}

{% hint style="warning" %}
「**이미 연결된 샵라인 스토어입니다**.」가 보여요.

* 같은 스토어가 이미 이 프로젝트에 연결되어 있어요.

👉 「샵라인 연결」 화면의 연결 표에서 기존 연결을 확인해 주세요.
{% endhint %}

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

샵라인 데이터 연결에 어려움이 있으신가요?

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

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

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