如何与 Spree 集成

预计阅读 8 分钟 | 更新于 2026年4月21日 9:54 AM EST

你将会学到

了解如何将 Spree 与 Klaviyo 集成。完成这些步骤后，您将能够根据每个客户的购买和网站活动来个性化和定位电子邮件。这是我们从 Spree 同步的数据：

销售和订单数据，包括购买的产品、产品图片、型号详细信息以及所应用的任何折扣
客户信息，包括名字和姓氏、位置以及他们如何找到您的商店
已履行的订单数据

Spree 版本 2.2.14、2.3.13、2.4.10 和 3.0.4 推送的安全补丁会强制将可搜索参数列入白名单。产品和订单的“updated_at”属性未包含在默认允许列表中。 Klaviyo 的集成依赖于此参数，因此您需要推送更新以将此属性列入白名单，以确保集成顺利运行。如果您未将订单的“updated_at”属性列入许可名单，则在下订单之前，开始结帐 事件可能不会同步。

在 Klaviyo 中添加 Spree 集成

在 Klaviyo 中，选择集成选项卡。
单击探索应用程序，搜索 Spree，然后单击该卡。然后，单击安装。
在下一页上，您需要提供商店 URL 和 Spree API 密钥/加密密码。您可以在 Spree 管理员中生成此 API 密钥，方法是导航到用户，选择一个帐户，然后选择生成 API 密钥。
返回 Klaviyo，将您的商店 URL 和 API 密钥/加密密码粘贴到框中。

Klaviyo help center screenshot

如果您使用的是版本控制的 Spree API (v1)，请选中相应的框。
单击“连接到 Spree”。
如果您想将选择从 Spree 商店接收电子邮件的客户添加到 Klaviyo 列表中，请选中下一页上的 将新 Spree 客户添加到 Klaviyo 列表 框。选中此框后，选择将添加新选择的列表。
准备好后，单击完成设置。然后您应该会看到一条成功消息，表明您已成功集成。

安装 Klaviyo 现场跟踪

要安装现场跟踪（由两个事件组成 – 现场活动和 查看产品），请首先找到您的公共 API 密钥。登录您的 Klaviyo 帐户并转至帐户名称 > 设置 > API 密钥。您的公钥长度为六个字符。安全地复制此密钥以供下一步使用。您可以利用两种类型的现场跟踪：

现场活跃只要可识别的浏览器访问您的网站，就会跟踪此指标
查看的产品每当可识别的浏览器查看您网站上的产品页面时，就会跟踪此指标

###“现场活动”跟踪

每当可识别的浏览器访问您的网站时，就会跟踪此指标。

要开始跟踪网站上活动活动，请将以下代码片段添加到您的主商店模板中，以便将其包含在所有页面上。您应该将此代码段与您使用的其他分析脚本一起放置，或者放置在 </body> 结束标记之前。
确保将“公共 API 密钥”替换为您的 Klaviyo 帐户的公共 API 密钥：

   <script type="text/javascript" async="" src="https://static.klaviyo.com/onsite/js/klaviyo.js?company_id=PUBLIC_API_KEY"></script>
   <脚本类型=“文本/javascript”>
   //在页面加载时初始化Klaviyo对象
   !function(){if(!window.klaviyo){window._klOnsite=window._klOnsite||[];try{window.klaviyo=new Proxy({},{get:function(n,i){return"push"===i?function(){var n;(n=window._klOnsite).push.apply(n,arguments)}:function(){for(var n=arguments.length,o=new Array(n),w=0;w<n;w++)o[w]=arguments[w];var t="function"==typeof o[o.length-1]?o.pop():void 0,e=new Promise((function(n){window._klOnsite.push([i].concat(o,[function(i){t&&t(i),n(i)}]))}));return e}}})}catch(n){window.klaviyo=window.klaviyo||[],window.klaviyo.push=function(){var n;(n=window._klOnsite).push.apply(n,参数)}}}}(); </脚本>

根据您网站使用的模板类型，{% if user.is\_logged\_in %} 和 {{ user.email }} 语法可能不同。使用可用的模板语言，您想要检查查看当前页面的人是否已登录。如果是，您应该输出他们的电子邮件和姓名（如果有）。如果您没有姓名信息，请删除这两行以及电子邮件 $email 行后的尾随逗号。
此 Klaviyo 跟踪代码将允许您跟踪网站活跃指标，以便您可以查看和利用与网站访问和访客行为相关的数据。通过这个指标，Klaviyo 将跟踪已知浏览器的现场活动。
要测试您的现场跟踪设置是否正确，请转到商店中的页面，并将“?utm_email=email@example.com”添加到 URL 末尾，将 email@example.com 替换为您的电子邮件地址。重新加载页面后，在 Klaviyo 中搜索您的电子邮件地址。您应该看到配置文件已创建并已跟踪您的网站活动。 ###“查看的产品”跟踪

如果您想设置浏览放弃流程或根据产品浏览数据构建细分，您需要为 查看的产品 指标添加 JavaScript 事件跟踪。 1. 在您的产品页面模板上，添加以下代码段：

   <脚本类型=“文本/javascript”>
    var klaviyo = window.klaviyo || []；
    klaviyo.track("查看过的产品", {
       标题: '{{ 产品名称 }}',
       商品 ID: {{ 产品.id }},
       Categories: {{category in product.categories|json }}, // 类别列表是一个字符串数组。图片网址: '{{ 产品.image_url }}',
       网址：'{{product.permalink}}'，
       元数据：{
       品牌: '{{ 产品.品牌 }}',
       价格：{{ 产品.价格 }}，
       特价：{{product.on_sale}}，
       常规价格：{{product.regular_price}}，
       促销价格：{{product.sale_price}}
    }
    });
   </脚本>

上面的代码片段使用了“{{ }}”占位符语法，该语法可能与您的 Spree 商店有所不同。重要的是，产品字段是根据您正在查看的产品页面动态呈现的。
为您的网站配置查看的产品跟踪后，当已知访问者浏览您的产品页面时，查看的产品数据应开始填充到您的 Klaviyo 帐户中。

现场跟踪的工作原理

当您将 Klaviyo 现场跟踪添加到您的网站时，我们只能跟踪“已知浏览器”的浏览活动，即之前至少访问过并参与过一次的浏览器。我们可以通过两种关键方式识别网站访问者以进行现场跟踪：

如果有人在某个时候通过 Klaviyo 电子邮件点击了您的网站
如果有人在某个时候通过 Klaviyo 表格订阅/选择加入

Klaviyo 不会跟踪匿名浏览器。

监控 Klaviyo 同步

要检查您的集成：

单击 Klaviyo 中的分析下拉列表，然后选择指标。在这里，您可以过滤以查看所有 Spree 指标。
找到 Spree 的 已下订单 指标，然后单击“活动源”图标。如果您的集成已开始同步数据，您将开始看到此处填充已下订单事件。 3.我们会自动同步所有历史订单数据。要验证这一点，您可以将 Klaviyo 中特定日期的事件数量与 Spree 界面中的事件数量进行比较，并确认它们匹配。例如，在探索 已下订单 指标时，您可以将鼠标悬停在昨天的数据点上或查看图表下方的数据表，以了解昨天报告了多少订单。
将该数字与昨天存储在 Spree 中的数字进行比较，您应该看到它们完全匹配。如果没有，问题很可能是您的 Klaviyo 帐户的时区与您设置的 Spree 时区不匹配。
要检查您在 Klaviyo 的时区设置：

单击左下角您的帐户名。 – 选择然后单击设置 > 组织。 – 向下滚动到时区。 6. 此历史性同步完成后，您将在 Integrations 选项卡中看到 Spree 集成周围有浅绿色边框。

从 Spree 同步的数据

Spree 集成每小时与 Klaviyo 同步。以下是 Spree 同步到 Klaviyo 的指标列表。您可以在分析 > 指标下查看同步到您帐户中的所有 Spree 指标。

Klaviyo 中的“指标”选项卡由 Spree 过滤，显示已完成订单和订购产品等指标

已下订单

每当有人下订单并成功付款时，此指标都会记录一个事件。它对应于 Spree 中已完成的订单，这意味着客户已完成整个结账流程。通过此指标，您可以根据人员下达的订单数量或他们的生命周期价值轻松创建动态列表。您还可以创建电子邮件以重新吸引过去的客户，或向首次购买者发送客户感谢电子邮件。您可以根据以下条件过滤和定位 已下订单 事件：

IsDiscounted如果订单有折扣，例如 true 或 false。 – ItemNames本次活动中购买的产品名称。

订购的产品

此指标类似于 已下订单 指标，但会为某人订购的每件商品记录一个事件。例如，如果有人购买了一件 T 恤和一条短裤，这将在 Klaviyo 中显示为一个 下订单 事件和两个 订购产品 事件，一个用于 T 恤，一个用于短裤。此指标对于构建针对购买（或未购买）特定商品或特定类别商品的客户的列表非常有用。您还可以使用 订购的产品 指标作为流的触发器，发送有关自然在一起的相关产品的电子邮件，但有些客户尚未购买。 – 类别订购的产品所属的类别，例如衬衫、 男士或促销。 – 名称所购买产品的名称，例如男士红色 T 恤。 – ProductId您商店中设置的产品 ID，例如 2022、2023、2024。 – 数量订购产品的数量。 – SKU 您商店中设置的产品 SKU。 – 变体选项：颜色产品的颜色（如果有），例如红色或蓝色。 – 变体选项：尺寸产品的尺寸（如果有），例如中号或大号。

已履行订单

该指标记录客户订单发货时的事件。 Klaviyo 中的事件包括所有货件的跟踪号码，因此您可以使用此指标作为发货确认电子邮件的触发器。另一种基于“已完成订单”指标的常见电子邮件是产品评论电子邮件，您可以在其中要求客户对他们最近购买的商品留下评论。使用 已完成订单 指标，您可以根据某人收到订单的时间来安排这些电子邮件的发送时间，这样您就不必担心在他们收到包裹之前向他们发送电子邮件。您可以根据以下条件过滤和定位已履行订单事件：

IsDiscounted如果订单有折扣，例如 true 或 false。 – 物品名称本次活动中购买的物品名称。

开始结帐

每次有人开始结帐并输入其电子邮件地址时，此指标都会记录一个事件。该指标的主要用途是发送废弃的购物车电子邮件。借助 Klaviyo，您可以轻松设置电子邮件流，以便在有人开始结账但几小时后尚未下订单时发送购物车提醒。 开始结帐 事件包含有关某人购物车的所有信息，因此您可以显示其购物车中的产品以及这些产品的图像。对于更高级的用户，您可以设置两个废弃的购物车流程 – 一个适用于包含折扣代码的首次购买者，另一个适用于不包含折扣代码的重复购买者。您可以根据以下条件过滤和定位 Started Checkout 事件：

IsDiscounted如果订单有折扣，例如 true 或 false。 – 物品名称本次活动中购买的物品名称。

客户数据

除了 Klaviyo 从 Spree 同步的指标之外，还有添加到每个 Klaviyo 配置文件中的客户属性。您可以在段和流中使用这些属性。以下是从 Spree 自动同步的属性：

电子邮件
名字
姓氏
城市
州/地区
邮政编码
国家
电话号码

结果

现在，您已将 Klaviyo 帐户与 Spree 集成、安装了现场跟踪并查看了同步数据。

其他资源

集成同步参考频率
需要更多与 Klaviyo 集成的帮助吗？查看 Klaviyo 的代理合作伙伴