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

# 连接 SmartStore

{% hint style="info" %}
此连接器适用于在韩国运营的店铺。
{% endhint %}

{% hint style="danger" %}
需要先在 SmartStore 中心将 **「라플라스 애널리틱스」(Laplace Analytics)** 注册为 **「상품 API」(商品 API)** 和 **「주문 API」(订单 API)** 的 API 代理商，再在 Laplace 页面输入 **「API 연동용 판매자 ID」(API 对接用卖家 ID)**，才能完成连接。<mark style="background-color:red;">**如果两个 API 只注册了其中一个**</mark>，连接将无法完成，请务必按顺序操作。
{% endhint %}

## SmartStore 连接指南

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

   ![连接 SmartStore 页面](https://3137825292-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0TsgqYeDkgxa5xtWTHTb%2Fuploads%2Fgit-blob-59d057287dd6e8b237334d95c8e84de116f2b983%2Fstartguide__connect__mall__smartstore__01.png?alt=media)

{% hint style="info" %}
如果还没有已连接的账号，连接器页面会显示「连接后可以进行的分析」。点击「查看示例」，即可用示例数据预览连接后能看到的页面。
{% endhint %}

2. 在 SmartStore 中心的 **「스토어 관리」(店铺管理) > 「스토어 설정」(店铺设置) > 「API 관리」(API 管理)** 中，将 **「API 사용 설정」(API 使用设置)** 选为 **「사용」(使用)**，然后在 **「API 대행사」(API 代理商)** 的 **「상품 API」(商品 API)** 和 **「주문 API」(订单 API)** 中分别注册 **「라플라스 애널리틱스」(Laplace Analytics)** 并保存。

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

{% hint style="danger" %}
**商品 API 和订单 API 两处都必须注册。**

👉 如果只注册其中一处，验证可能无法通过，或无法导入未注册一方的数据，导致图表显示为空。

👉 详情请参阅下方的 [**注册 API 代理商**](#api)。
{% endhint %}

3. 回到 Laplace 页面，点击「连接 SmartStore」页面标题右侧的「数据连接」，打开连接窗口。可在窗口上方的「连接步骤」中查看当前所在步骤。在「连接信息」中输入 SmartStore 的 API 对接用卖家 ID，然后点击 **「验证」按钮**。

   ![在 SmartStore 连接窗口输入 API 对接用卖家 ID](https://3137825292-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0TsgqYeDkgxa5xtWTHTb%2Fuploads%2Fgit-blob-477531cb8cbfd86987ebf8576182b6a45bd6dd48%2Fstartguide__connect__mall__smartstore__02.png?alt=media)

{% hint style="warning" %}
⚠️ 如果输入 SmartStore 的登录账号，将无法对接。必须输入 “**API 对接用卖家 ID**” 才能正常采集数据。
{% endhint %}

{% hint style="info" %}
**在哪里可以查看 API 对接用卖家 ID？**

👉 可在 SmartStore 中心的 **「스토어 관리」(店铺管理) > 「스토어 설정」(店铺设置) > 「API 관리」(API 管理)** 中查看。

👉 详情请参阅下方的 [**查看 API 对接用卖家 ID**](#api-id)。
{% endhint %}

4. 代理商注册和卖家 ID 均确认无误后，连接窗口会显示「店铺信息确认中」，Laplace 会读取店铺信息并立即开始导入数据。即使关闭此窗口，连接也会继续进行。

{% hint style="danger" %}
**请先完成代理商注册，再点击「验证」。**

👉 验证在点击的当下即完成。如果在未注册代理商的状态下点击，会出现错误提示，连接也不会被受理。

👉 此时请在 **「상품 API」(商品 API)** 和 **「주문 API」(订单 API)** 两处都注册 **「라플라스 애널리틱스」(Laplace Analytics)** 并保存，然后在 Laplace 中再次点击 **「验证」**。即使页面保持不动，也不会自动重试。
{% endhint %}

* 已连接的账号会显示在连接器页面的连接表中。可在行右侧的 ⋯（「更多操作」）中执行「更新」和「更新验证」。

由于会导入店铺自开业以来的全部数据，**数据量较大时可能需要 1 小时以上**。

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

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

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

## 注册 API 代理商 <a href="#api" id="api"></a>

1. 进入 SmartStore 中心的 **「스토어 관리」(店铺管理) > 「스토어 설정」(店铺设置) > 「API 관리」(API 管理)**。
2. 将 **「API 사용 설정」(API 使用设置)** 选为 **「사용」(使用)**。
3. 在 **「API 대행사」(API 代理商)** 的 **「상품 API」(商品 API)** 和 **「주문 API」(订单 API)** 下拉菜单中分别选择 **「라플라스 애널리틱스」(Laplace Analytics)**。
4. 点击底部的 **「저장」(保存)** 按钮。

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

{% hint style="warning" %}
**商品 API 和订单 API 两处都必须注册。**

👉 如果只注册其中一处，将无法导入未注册一方的数据，图表可能显示为空。
{% endhint %}

{% hint style="info" %}
**已经注册了其他代理商。**

👉 无需删除现有代理商。请通过 **「+ 대행사추가」(+ 添加代理商)** 按钮追加注册 **「라플라스 애널리틱스」(Laplace Analytics)**。
{% endhint %}

{% hint style="info" %}
**注册为代理商后会采集哪些信息？**

👉 仅查询商品和订单数据。不会修改支付信息，也不会采集结算账户信息，请放心注册。
{% endhint %}

## 查看 API 用卖家 ID <a href="#api-id" id="api-id"></a>

1. 在左侧导航栏中进入 **「스토어관리」(店铺管理) > 「스토어 설정」(店铺设置) > 「API 관리」(API 管理)**。
2. 查看 API 对接用卖家 ID。

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

* 如图所示，复制该 ID 并粘贴到 Laplace 连接窗口的「连接信息」中，然后点击 **「验证」** 按钮。

{% hint style="danger" %}
如果输入 API 使用设置中的 API ID，将无法连接。必须输入 API 对接用卖家 ID 才能正常连接。
{% endhint %}

## FAQ

{% hint style="info" %}
如何修改品牌名称？

🛠 品牌名称修改功能计划在后续更新中提供。如需修改品牌名称，请联系 Laplace，负责工程师会尽快为您处理。
{% endhint %}

{% hint style="info" %}
导入了已停止运营的品牌数据。

🛠 Laplace 的连接器在连接账号时会导入该账号下的全部数据。如果导入了不需要的店铺数据，请在 **「设置」›「数据源」** 中关闭相应店铺的 **「纳入分析」**，然后点击 **「保存并重新汇总」**。即使从分析中排除，采集仍会继续。删除功能计划在后续更新中提供，联系 Laplace 团队即可为您删除相关数据。
{% endhint %}

{% hint style="info" %}
已完成代理商注册，但验证无法通过。

🛠 可能只在 **「상품 API」(商品 API)** 和 **「주문 API」(订单 API)** 中的一处进行了注册。请在 SmartStore 中心的 **「스토어 관리」(店铺管理) > 「스토어 설정」(店铺设置) > 「API 관리」(API 管理)** 中确认两处是否都已注册 **「라플라스 애널리틱스」(Laplace Analytics)**，以及是否已点击 **「저장」(保存)**，然后在 Laplace 中再次点击 **「验证」**。
{% endhint %}

{% hint style="info" %}
已连接，但没有数据。

🛠 可能只在一处注册了代理商。两处都注册后，无需重新连接，将从下一个数据采集周期起正常导入数据。
{% endhint %}

{% hint style="info" %}
API 用卖家 ID 输入错误。

🛠 请重新输入正确的 API 对接用卖家 ID，然后点击 **「验证」** 按钮。
{% endhint %}

## 联系专属经理

连接 SmartStore 数据时遇到困难？

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

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

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