> 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/zh-cn/startguide/connect/mall/shopline.md).

# 连接 SHOPLINE

{% hint style="info" %}
SHOPLINE 只需一个在 SHOPLINE 管理后台获取的 **API 密钥（Access Token）** 即可连接。外币销售额可通过「数据管理」›「汇率」设置换算为韩元（KRW），与其他渠道一起查看。
{% endhint %}

## SHOPLINE 连接指南

1. 登录 SHOPLINE 管理后台，进入 **「Settings > Permission & Security」** 菜单。根据管理后台版本不同，也可能显示为 **「Staff Settings」**。点击 **「Add」** 按钮添加新的员工（Staff）。

   ![在 SHOPLINE 管理后台添加员工](https://3137825292-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0TsgqYeDkgxa5xtWTHTb%2Fuploads%2Fgit-blob-cd1d204e8156f8dd048a26061cd2a8913587f1d3%2Fstartguide__connect__mall__shopline__01.png?alt=media)
2. 输入邮箱地址添加员工后，选择 **「API Auth」** 选项卡。勾选 **「Give Full Access」**，然后向下滚动。

   ![在 SHOPLINE 管理后台授予 API Auth 权限](https://3137825292-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0TsgqYeDkgxa5xtWTHTb%2Fuploads%2Fgit-blob-27b0761e698d34f11805ba322abb59d28dd92d70%2Fstartguide__connect__mall__shopline__02.png?alt=media)

{% hint style="warning" %}
如果看不到 **「API Auth」** 选项卡，需要先向 SHOPLINE 负责人申请 OpenAPI 使用权限。
{% endhint %}

3. 点击页面底部的 **「Generate」** 按钮生成令牌（Access Token），并复制生成的令牌。

   ![在 SHOPLINE 管理后台生成 Access Token](https://3137825292-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0TsgqYeDkgxa5xtWTHTb%2Fuploads%2Fgit-blob-7edab0b99fcdf854d0c192ae13a445f81bc8507a%2Fstartguide__connect__mall__shopline__03.png?alt=media)

{% hint style="danger" %}

* 请将到期日（**Expired At**）留空。留空后令牌不会过期。如果填写日期，数据采集将在当天中断。
* 生成令牌后出现的 **IP 白名单** 也请留空。如果填写，Laplace 的采集服务器将被拦截。
  {% endhint %}

4. 回到 Laplace，点击左侧导航栏的「数据连接」，然后在浏览面板的「搜索连接器」中输入 SHOPLINE，或在「连接海外购物中心」类别中点击「连接 SHOPLINE」。

   ![连接 SHOPLINE 页面](https://3137825292-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0TsgqYeDkgxa5xtWTHTb%2Fuploads%2Fgit-blob-65d8a95c3b5e84e0b97c996c64cbf5a6e915bef1%2Fstartguide__connect__mall__shopline__04.png?alt=media)
5. 点击「连接 SHOPLINE」页面标题右侧的「数据连接」，打开连接窗口。可在窗口上方的「连接步骤」中查看当前所在步骤。在「输入 API 密钥」的 **「API 密钥」** 中粘贴复制的令牌，然后点击 **「对接 SHOPLINE 账号」**。

   ![在 SHOPLINE 连接窗口输入 API 密钥](https://3137825292-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0TsgqYeDkgxa5xtWTHTb%2Fuploads%2Fgit-blob-3083c10d14648d162f3a55a1b8af9ee292deaa1f%2Fstartguide__connect__mall__shopline__05.png?alt=media)

{% hint style="info" %}
如果还没有已连接的账号，连接器页面会显示「连接后可以进行的分析」。点击「查看示例」，即可用示例数据预览连接后能看到的页面。也请在页面下方的「连接步骤」和「开始前的准备」中确认连接步骤和需要提前准备的内容。
{% endhint %}

* 已连接的账号会显示在连接器页面的连接表中。可在行右侧的 ⋯（「更多操作」）中执行「更新」和「更新验证」。
* 由于会导入店铺自开业以来的全部数据，**数据量较大时可能需要 1 小时以上**。

{% hint style="info" %}
**为什么数据对接需要这么长时间？**

👉 因为 Laplace 不仅导入 SHOPLINE 的数据，还会对导入的数据进行清洗并绘制图表。数据量越大，所需时间也可能越长。

💬 可在顶部栏右侧的「任务与数据状态」中查看进度，对接完成后也会通过邮件通知您。即使关闭 Laplace，采集也会继续进行，您可以放心关闭。
{% endhint %}

## 无法连接 SHOPLINE 的情况

{% hint style="warning" %}
显示 **「API 密钥不正确或已过期。请在 SHOPLINE 管理后台重新获取密钥后输入。」**。

* 令牌可能已过期或复制有误。

👉 请在 SHOPLINE 管理后台重新获取密钥并输入。到期日（Expired At）请留空。
{% endhint %}

{% hint style="warning" %}
显示 **「该 SHOPLINE 店铺已连接。」**。

* 同一店铺已连接到此项目。

👉 请在「连接 SHOPLINE」页面的连接表中确认现有连接。
{% endhint %}

## 联系专属经理

连接 SHOPLINE 数据时遇到困难？

请通过下方的咨询页面联系我们，负责经理将为您提供帮助。

> 💬 [在官网咨询](https://www.analytics.laplacetec.com/contact)

**邮件咨询：** [**product@laplacetec.com**](mailto:product@laplacetec.com)
