开始使用 Shopware
你将会学到
了解如何与 Shopware 6 集成，以便将站点活动、订单、目录和订户数据引入 Klaviyo。
开始之前
请注意以下事项：
- 集成之前，请确保您已登录到要集成的 Klaviyo 帐户。 – Shopware 6 集成由 Klaviyo 通过第三方提供支持。如果您需要联系支持人员，请参阅下面有关如何联系的部分。
将插件添加到您的 Shopware 帐户
- 前往 Shopware 商店中的 Klaviyo 插件页面。
- 出现提示时登录，然后选择添加到购物车。
- 继续结帐并完成您的订单。
- 订单确认后，单击选项转至您的Shopware 帐户。
- 在您的 Shopware 帐户中，导航至商家 > 商店。
- 选择您购买插件的商店。
- 在许可证部分下，找到 Klaviyo 插件并打开插件详细信息页面。
下载并安装扩展
您可以通过以下两种方法之一进行安装：通过 Composer 或下载我们的扩展。选择安装方法后，每次更新时都应使用相同的方法。
通过 Composer 安装
通过 Composer 安装时，您需要指定 Klaviyo 扩展版本；并非所有扩展都适用于所有 Shopware 版本。您使用的 Shopware 版本是否介于 6.4.4.0 和 6.4.XX.XX 之间？使用以下扩展版本运行命令：
作曲家需要 klaviyo/shopware-klaviyo:1.22.0您使用的 Shopware 版本是否介于 6.5.0.0 和 6.5.XX.XX 之间？使用以下扩展版本运行命令：
作曲家需要 klaviyo/shopware-klaviyo:2.22.0您使用的 Shopware 版本是否介于 6.6.0.0 和 6.6.XX.XX 之间？使用以下扩展版本运行命令：
作曲家需要 klaviyo/shopware-klaviyo:3.6.0您使用的是 Shopware 版本 6.7.0.0 或更高版本吗？使用以下扩展版本运行命令：
堆肥器需要 klaviyo/shopware-klaviyo:4.2.0通过上传安装
1. 打开插件详细信息页面并下载最新可用版本（或任何所需版本）：
- 使用 6.4.4.0 和 6.4.XX.XX 之间的 Shopware 版本？下载Klaviyo扩展版本1.22.0。 – 使用 6.5.0.0 和 6.5.XX.XX 之间的 Shopware 版本？下载Klaviyo扩展版本2.22.0。 – 使用 6.6.0.0 和 6.6.XX.XX 之间的 Shopware 版本？下载Klaviyo扩展版本3.6.0。 – 使用 Shopware 版本 6.7.0.0 或更高版本？下载Klaviyo扩展版本4.2.0。
- 登录您要集成的商店的 Shopware 管理员。
- 单击扩展 > 我的扩展。
- 单击上传扩展并选择您从 Shopware 帐户下载的 ZIP 文件。上传过程中您可能会看到一条警告消息。单击确认继续。
- 扩展程序出现在扩展程序列表中后，单击安装。
- 打开 Klaviyo 扩展。
在 Shopware 中配置扩展
- 在您的 Shopware 商店管理中，导航至设置并单击扩展选项卡。
- 选择Klaviyo。您将进入 Klaviyo 扩展设置页面。
- 在 销售渠道 下，从下拉列表中选择您希望与 Klaviyo 集成的销售渠道。每个 Shopware 商店仅将一个销售渠道与 Klaviyo 集成。您还必须单独配置每个销售渠道的设置。
- 在 交互设置 下，选择您想要用于此集成的 cookie 同意工具。请注意，不接受 Klaviyo cookie 的访客将不会被 Klaviyo 跟踪，也无法查看 Klaviyo 表格。 Cookie 同意工具选项有：
- 没什么
- 同意管理器
- 如果选择此选项，同意管理将通过同意管理器实施。如果您希望选择 Consent Manager，则必须已将其安装在 Shopware 商店中。 – 以用户为中心的 CMP
- 客户端开始与页面交互后，Klaviyo 脚本将被初始化。 – 在后续页面转换时，脚本将立即初始化。
如果选择此选项，Klaviyo 可以自由访问存储 cookie。 – 商店软件默认 如果选择此选项，则在打开的情况下，将通过 Shopware 的默认方法实施 cookie 管理。要打开它，请导航至设置>商店>基本信息，找到安全和隐私部分，然后打开使用默认Cookie通知。 – CookieBot 如果选择此选项，cookie 管理将由 CookieBot 实施。如果您希望选择 CookieBot，您必须已将其安装在您的 Shopware 商店中。
如果选择此选项，同意管理将通过 Usercentrics CMP 实施。如果您希望选择 Usercentrics CMP，则必须已将其安装在 Shopware 商店中。 5. 如果您不使用 cookie 管理工具（该工具已阻止 Klaviyo 的脚本加载）并希望加快页面加载时间，请打开设置 首次与页面交互后初始化 Klaviyo。这将启用以下行为：
- 要继续，请从 Klaviyo 获取您的公共和私有 API 密钥。为此，请打开一个新选项卡并登录到要与 Shopware 集成的 Klaviyo 帐户。
- 单击左下角您的帐户名，然后选择设置。
- 选择API 密钥。
- 单击创建私有 API 密钥。将密钥命名为“Shopware Integration”，然后选择完全访问密钥并单击创建。在下一页上，单击复制密钥。
- 将私有 API 密钥粘贴到 Shopware 中的相应设置中。
- 返回 Klaviyo，单击完成。然后，从页面复制您的公共 API 密钥。
- 将 Shopware 中的公共 API 密钥粘贴到相应的框中。
- 接下来，从下拉列表中选择一个 Klaviyo 列表，将通过 Shopware 表单订阅的配置文件添加到其中。
- 选择用于返回库存变体字段映射的标识符。您应该使用与您在目录中使用的标识符相匹配的标识符。
- 打开您想要从 Shopware 同步到 Klaviyo 的所有指标。
- 如果您选择追踪“返货”，您可以自定义“返货”弹窗开启按钮、弹窗关闭按钮、订阅按钮的文字颜色和背景。单击正方形，然后使用选择器选择颜色，或者，如果您有品牌颜色的十六进制颜色代码，请将其粘贴到相应的框中。
- 在 代码段名称 下，您将找到有关如何在 HTML 中引用不同的 Back in Stock 组件的参考。您可以选择在站点代码中自定义它们。
- 自定义字段映射：在这里，您将看到在 Shopware 中设置的自定义字段（技术名称为灰色）。分配给客户对象的任何字段都可以同步到 Klaviyo。要将这些自定义字段同步到 Klaviyo 配置文件，请将各个字段切换为活动。然后，在 字段名称 下，输入您希望字段在 Klaviyo 中具有的相应名称。
- 完成后，单击保存。
- 要运行历史事件同步，请单击页面顶部的同步历史事件。
- 要运行现有订阅者的同步，请单击页面顶部的同步订阅者。在您最初手动运行这些同步后，它们将自动运行。 订阅者和事务事件同步每 5 分钟运行一次。现场事件（现场活动、查看产品和开始结账）实时同步。
同步您的目录提要
要完成与 Klaviyo 的集成，您必须生成产品目录的源，然后将其同步到 Klaviyo。要生成提要：
- 登录您的 Shopware 商店管理员。
- 单击 销售渠道 旁边的 +** 添加新渠道。
- 在产品 比较旁边，单击添加销售渠道。
- 在模板下，选择Klaviyo XML。
- 为通道命名，例如 Klaviyo Export。
- 在税收征收下，选择逐行（水平）计算。
- 在店面销售渠道下：
- 选择该目录所属的店面销售渠道。 – 选择店面域。 – 选择货币。 – 选择语言。 – 选择客户组。 8. 在产品出口下：
- 命名文件（例如 klaviyo.xml）。 – 选择编码UTF-8。 – 选择文件格式XML。
- 将将变量导出为离散产品保持关闭状态。
- 选择间隔：1 天。
- 将通过调度程序生成保持关闭状态。
- 选择您的动态产品组。
- 在 状态 下，打开 活动。
- 单击右上角的保存。
- 向下滚动并复制 导出 URL，您将用于 Klaviyo 同步。
- 现在 feed 已生成，您必须将其同步到 Klaviyo。按照说明将自定义目录源同步到 Klaviyo。
从 Shopware 同步的数据
要了解有关从 Shopware 同步的数据以及如何在 Klaviyo 中访问这些数据的所有信息，请阅读我们的Shopware 数据参考。
Klaviyo 注册表单
您可以将 Klaviyo 注册表单 添加到您的 Shopware 商店以收集订阅者。请注意，只有接受 Klaviyo cookie 的网站访问者才能看到 Klaviyo 注册表单。
如何联系支持人员
Klaviyo Shopware 6 集成由 Klaviyo 通过第三方提供支持。如果您对集成有疑问并需要支持，可以通过填写我们的表单联系特定于集成的支持人员。如果您需要 Klaviyo 相关问题的一般支持，请联系 Klaviyo 支持。
结果
您已将 Shopware 6 与 Klaviyo 集成，将站点活动、订单、目录和订户数据引入 Klaviyo。您现在可以开始使用 Klaviyo 来满足您自己的营销需求。