---
lastModified: 2026-10-19
title: 添加商店插件
description: 在“应用”中安装现成的商店功能（例如心愿单和 Klaviyo），并在商店运营中管理它们。
seo:
  description: "在“应用”中安装现成的商店功能（例如心愿单和 Klaviyo），并在商店运营中管理它们。项目 → 应用 → 商店插件。"
---

<strong>商店插件</strong>为你的商店加上现成的功能。有了<strong>心愿单</strong>，顾客可以把商品存下来，以后再回来购买。<strong>Klaviyo</strong> 会把你的顾客和订单发送到你的 Klaviyo 账户，用于邮件和短信营销。安装插件会把功能加到商店后端。随后<strong>添加到在线商店</strong>会请 Runner 把它放进你的商店设计里，<strong>管理</strong>会在<strong>商店运营 → 插件</strong>中打开插件自己的页面。

## 开始前

**入口路径：** **项目 → 应用 → 商店插件**

- 这个部分列出 Runner 提供的插件。显示<strong>需要升级后端</strong>的卡片，要等商店后端升级后才能安装。
- 安装会重启商店后端，商店会短暂无法访问。商店越大，插件迁移所需的时间可能越长。
- 一次只能进行一项后端更改。一个插件在安装或移除时，其他卡片会显示<strong>已被另一项后端更改阻止</strong>。
- 只有在 Runner 把插件功能添加到在线商店、并且你发布商店之后，顾客才能看到它。

### 观看：安装心愿单，看看顾客收藏了什么

<video controls playsInline preload="metadata" poster="https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgedkaq5Yt82iKld0T5W2hAarkBbqj4mrolQPq" aria-label="安装心愿单、添加到在线商店、以顾客身份收藏版画，并在商店运营中查看" style={{ width: '100%', aspectRatio: '1440 / 976' }}>
  <source src="https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgKMO17ZlNlrZ2ZIPkE1IAL6YaKHtMu8z0bFgO" type="video/mp4" />
  <a href="https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgKMO17ZlNlrZ2ZIPkE1IAL6YaKHtMu8z0bFgO">打开录屏</a>
</video>

这段英文界面、带英文旁白和英文字幕的录屏先从<strong>商店插件</strong>安装<strong>心愿单</strong>，再选择<strong>添加到在线商店</strong>，等 Runner 说明添加了哪些内容后发布商店。接着，一位顾客创建账户、收藏两幅版画并打开心愿单页面。然后<strong>管理</strong>会在<strong>商店运营 → 插件</strong>中打开 <strong>Wishlist</strong>：<strong>Wishlists</strong> 显示顾客收藏最多的版画，<strong>Product widgets</strong> 显示一幅版画在多少个心愿单中。这家商店的安装约用了 8 分钟，Runner 修改在线商店约用了 7 分钟；实际时间取决于你的商店。录屏没有连接支付，也没有下单。

## 商店插件的控件

| 控制或状态 | 为什么有用 | 接下来会发生什么 |
| --- | --- | --- |
| <strong>安装</strong> | 把插件加到商店后端。 | 因为商店会短暂重启，Runner 会请你确认。 |
| <strong>继续</strong> | 确认安装或移除。 | 卡片会显示<strong>正在安装</strong>或<strong>正在移除</strong>，直到更改完成。 |
| <strong>正在安装</strong>或<strong>正在移除</strong> | 表示后端更改正在进行。 | 请等待。Runner 完成后卡片会变化；你可以先离开这个页面。 |
| <strong>已安装</strong> | 确认插件已在商店后端运行。 | 带有在线商店部分的插件会显示<strong>添加到在线商店</strong>。 |
| <strong>添加到在线商店</strong> | 把插件功能放进你的商店设计。 | Runner 会打开一个包含这个请求的聊天，并修改你的在线商店。 |
| <strong>管理</strong> | 打开插件自己的页面。 | Runner 会在<strong>商店运营 → 插件</strong>中打开这个插件的标签页。 |
| <strong>移除</strong> | 从商店后端移除插件。 | Runner 会请你确认，然后显示<strong>正在移除</strong>。 |
| <strong>需要升级后端</strong> | 表示你的商店后端版本太旧，不支持这个插件。 | 商店后端升级之前，这个插件无法安装。 |
| <strong>已被另一项后端更改阻止</strong> | 表示另一个插件的更改正在进行。 | 等那项更改完成后再试。 |
| <strong>上次更改失败</strong> | 表示上一次安装或移除没有完成。 | 阅读卡片上的信息，然后重试或联系支持。 |

## 把心愿单添加到你的商店

1. 打开<strong>项目 → 应用</strong>，找到<strong>商店插件</strong>。
2. 在<strong>心愿单</strong>上选择<strong>安装</strong>，然后选择<strong>继续</strong>。
3. 等卡片显示<strong>已安装</strong>和<strong>添加到在线商店</strong>。这需要几分钟。
4. 选择<strong>添加到在线商店</strong>。Runner 会打开一个请它添加插件的聊天，然后在商品卡片和商品页面加上收藏按钮，并加上心愿单页面和页眉中的数量。
5. Runner 完成后查看预览：每件商品上都有一个爱心。
6. 选择<strong>发布</strong>并确认，顾客就能在你的线上商店使用心愿单。

## 顾客看到的内容

- 每张商品卡片和每个商品页面上都有一个爱心。选中即可收藏商品，再选一次即可取消收藏。
- 页眉中的爱心会显示已收藏商品的数量。它会打开心愿单页面，列出所有收藏的商品。
- 访客收藏默认关闭，所以顾客需要登录才能收藏。未登录的顾客会看到<strong>登录后即可把商品加入心愿单。</strong>并进入账户页面；登录后，心愿单会保存在账户中，在任何设备上都能看到。
- 要让顾客无需账户也能收藏，请打开<strong>商店运营 → 插件 → Wishlist</strong>，依次选择 <strong>Wishlists</strong> 和 <strong>Settings</strong>，然后开启 <strong>Allow guest wishlists</strong>。

## 查看顾客收藏了什么

**入口路径：** <strong>商店运营 → 插件 → Wishlist</strong>，或<strong>应用 → 商店插件</strong>中<strong>心愿单</strong>卡片上的<strong>管理</strong>

- <strong>Wishlists</strong> 显示你所选时间段内的心愿单动态，以及顾客收藏最多的商品。它的 <strong>Settings</strong> 标签页中有 <strong>Allow guest wishlists</strong>。
- <strong>Product widgets</strong> 显示一件商品在多少个心愿单中。选择商品后，<strong>Wishlist</strong> 面板会显示这个数量。

## 连接 Klaviyo

<strong>Klaviyo</strong> 会收到顾客在你已发布的商店中的操作，以及他们下的订单。你的 Klaviyo 流程和营销活动就可以通过邮件或短信跟进。Klaviyo 使用你自己的 Klaviyo 账户。

Klaviyo 还没有在所有工作区开启。如果<strong>商店插件</strong>中没有 <strong>Klaviyo</strong>，说明你还不能使用它。

### 观看：连接 Klaviyo，在 Klaviyo 中查看你的顾客

<video controls playsInline preload="metadata" poster="https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgFXqEdHByel9bMuRDBPQ92L7PfoNwMZrPtMjI" aria-label="在“应用”中连接 Klaviyo，并在 Klaviyo 中查看一位顾客的操作和订单" style={{ width: '100%', aspectRatio: '1440 / 976' }}>
  <source src="https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgsmh5qb2ukCMNGBahR48Ldn68olrMHVI3PoUv" type="video/mp4" />
  <a href="https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgsmh5qb2ukCMNGBahR48Ldn68olrMHVI3PoUv">打开录屏</a>
</video>

这段英文界面、带英文旁白和英文字幕的录屏先从<strong>商店插件</strong>安装 <strong>Klaviyo</strong>，再选择<strong>管理</strong>，在<strong>商店运营 → 插件</strong>中打开它的标签页。接着，一位顾客创建账户、把一幅版画加入购物车并开始结账。在 Klaviyo 中，这位顾客的资料显示这些步骤、包含商品的订单，以及发货的承运商和追踪号码。录屏没有拍摄 Klaviyo 的授权页面、付款和发货过程。

1. 打开<strong>项目 → 应用</strong>，在<strong>商店插件</strong>中找到 <strong>Klaviyo</strong>。
2. 选择<strong>安装</strong>。Klaviyo 会打开，请你登录并允许 Runner 访问你的账户。
3. 批准访问。Runner 会带你回到<strong>应用</strong>，卡片会显示<strong>已连接到</strong>和你的 Klaviyo 账户名称。
4. 选择<strong>管理</strong>，在<strong>商店运营 → 插件</strong>中打开 <strong>Klaviyo</strong>。这个标签页显示与卡片相同的账户和相同的<strong>移除</strong>按钮。

## Klaviyo 会收到什么

这些事件通常会在几分钟内出现在顾客的 Klaviyo 资料中。

- <strong>来自你已发布的在线商店：</strong>顾客创建账户或登录时，会生成带有姓名和邮箱的资料；之后是 <strong>Viewed Product</strong>、<strong>Added to Cart</strong> 和 <strong>Started Checkout</strong>。
- <strong>来自你的商店订单：</strong><strong>Placed Order</strong>，以及每件商品一个 <strong>Ordered Product</strong> 事件；订单发货时会有带承运商和追踪号码的 <strong>Fulfilled Order</strong>。退款和取消后会有 <strong>Refunded Order</strong> 和 <strong>Cancelled Order</strong>。

你在 Runner 预览中下的订单不会发送到 Klaviyo。请使用你已发布的商店。

## 移除 Klaviyo

1. 在 <strong>Klaviyo</strong> 卡片上，或在<strong>商店运营 → 插件</strong>中它的标签页里，选择<strong>移除</strong>。
2. 再次选择<strong>移除</strong>确认。你的商店将不再向这个 Klaviyo 账户发送订单和顾客，Runner 也将无法访问该账户。Klaviyo 会保留已收到的客户资料和事件。

## 商店插件无法使用时

- <strong>卡片显示需要升级后端。</strong>你的商店后端版本低于插件的要求。请联系支持升级。
- <strong>安装一直没有完成。</strong>让它继续运行，稍后再查看卡片。如果显示<strong>上次更改失败</strong>，请阅读信息，然后再选择一次<strong>安装</strong>。
- <strong>线上商店没有爱心。</strong>确认 Runner 已完成<strong>添加到在线商店</strong>的聊天，然后重新发布商店。
- <strong>顾客被带到账户页面。</strong>访客收藏处于关闭状态，所以顾客需要登录才能收藏。要改变这一点，请在<strong>商店运营 → 插件 → Wishlist</strong> 中开启 <strong>Allow guest wishlists</strong>。
- <strong>Klaviyo 卡片显示 Klaviyo 访问已结束。</strong>Runner 已无法访问你的 Klaviyo 账户，例如在 Klaviyo 中撤销了访问权限。请选择<strong>重新连接</strong>，再次批准 Runner。
- <strong>测试顾客没有出现在 Klaviyo 中。</strong>Klaviyo 会忽略一些测试地址，例如 example.com 的地址。请使用能收邮件的邮箱地址，并使用你已发布的商店。

## 相关指南

- [应用和集成概述](../apps-and-integrations)
- [商店运营](../store-operations)
- [与 Runner 聊天](../work-with-runner/chat-with-runner)
- [发布和重新发布](../storefront-and-publishing/publish-and-republish)