如果您的电商平台没有原生 Omnisend 集成，您可以使用我们的 API 进行连接。这让您可以使用与原生集成相同的功能 – 废弃购物车（Abandoned Cart）自动化流程（Automation）、客户细分受众（Segmentation）、订单追踪等。
设置包含两个步骤：添加跟踪代码片段（前端集成）和通过 API 同步您的数据（后端集成）。
已经在使用原生集成？
We have built-in integrations for , , and .您可以使用这些指南来更快地完成设置。
在您开始之前
本指南适用于谁
如果您的店铺是基于以下平台搭建的，请使用本指南：
定制网站或平台未列入我们的原生集成中。
原生支持有限的平台： Etsy, Squarespace, Hostinger Website Builder, 自定义 WordPress 主题。
无头商务设置：Shopify Hydrogen、自定义 React/Vue 前端、API优先平台。
如果您使用 Shopify、WooCommerce、BigCommerce 或 Wix，请使用 Omnisend 的原生集成指南，以便更轻松地进行设置。
您需要开发者吗？
前端集成（添加代码片段）可以由熟悉以下操作的任何人完成：
访问您的网站的 HTML 或模板文件。
将代码片段添加到您的网站页脚（例如 Google Analytics）。
使用 Google 标签管理器 (可选方法)。
后端集成 (通过 API 同步数据) 需要具备以下条件的开发人员：
REST API 知识。
访问您的店铺的客户和订单数据库。
能够实现 webhooks 或定期数据同步。
您可以无需开发人员即可完成的操作：
注册表单 (所有类型: 弹窗, 转盘, 落地页)
电子邮件（Email）和短信（SMS）营销活动
欢迎自动化流程（Automation）
浏览与产品弃购 (需要产品浏览事件设置)
实时访客追踪
需要开发人员进行的操作：
废弃购物车（Abandoned Cart） & 结账 自动化流程（Automation）
订单确认, 发货确认, 订单取消
高级细分受众（Segmentation）(例如，“购买了 X 但未购买 Y 的客户”)
邮件中的产品选择器
营销活动（Campaign）分析中的收入报告
如果您不确定，请从前端集成开始。您可以稍后添加后端集成。
平台特定限制
⚠️ 某些平台存在代码或数据访问限制：
如果您的平台存在限制，请在开始设置之前联系您的开发者。
每个集成解锁的功能
集成级别 | 您将获得什么 | 您仍然无法做的事情 | 需要开发人员吗？ |
仅限前端 | 注册表单, 欢迎自动化流程（Automation）, 浏览与产品（Product）放弃, 实时视图, 电子邮件（Email）营销活动 | 废弃购物车（Abandoned Cart）, 订单自动化, 基于购买的细分受众（Segmentation）, 收入报告 | 否 |
前端 + 后端 | 所有自动化（购物车、订单、重新激活）、高级细分受众（Segmentation）、Product Picker、销售归因 | N/A | 是的 |
前端集成
前端集成将 Omnisend 跟踪代码片段添加至您的网站页面。这将解锁注册表单、浏览放弃、访客追踪和电子邮件（Email）营销活动。
步骤 1: 连接您的店铺
注册一个 Omnisend 账户 并登录。
在您的 Omnisend 仪表盘中，点击 "Connect store"。
从店铺平台列表中选择其他。
步骤 2: 输入您的店铺 URL
输入您的店铺网址并点击“Connect store”。
第 3 步：添加 Tracking Snippet
您会在下一页看到一个 JavaScript snippet。将此代码片段粘贴到您网站的 HTML 页脚文件中，在每个页面上，紧邻结束 标签之前——就像 Google Analytics 一样。
在哪里添加代码片段：
最简单的方法是将代码片段添加到您网站的页脚文件（通常是 footer.html、footer.php 或 theme.liquid，具体取决于您的平台）。此文件在所有页面上渲染。
⚠️ 如果您不确定在哪里添加，请联系您的网站开发者。
使用 Google Tag Manager
如果您使用 Google 标签管理器：
登录您的 Google 标签管理器账户并选择您的工作区。
点击 标签 → New
点击 标签配置 → 自定义 HTML。
从 Omnisend 复制代码片段，并将其粘贴到 HTML 字段中。将其放置在 标签内。
将触发条件（Trigger）设置为在 所有页面 上触发。
保存并发布
参阅这份 Google 指南 了解更多 GTM 设置详情。
步骤 4: 验证您的连接
添加代码片段后，请在 Omnisend 中点击Verify & Connect。如果验证成功，您就完成了前端集成。您现在可以使用注册表单、浏览放弃和电子邮件（Email）营销活动。
⚠️ 重要提示：Google Tag Manager 验证
如果您通过 GTM 添加了 snippet，即使 snippet 正常工作，验证也可能会失败。这是因为我们的验证会检查直接的 HTML 放置。
如何检查它是否正常工作：
打开您的网站
按 F12 打开浏览器控制台
输入
window.omnisend然后按 Enter 键如果您看到一个数组，则表示代码片段正在正确运行。
下一步：
联系人支持 via in-app chat with your store URL.我们将手动验证您的连接。
疑难解答：验证失败
如果验证失败：
等待 5-10 分钟，因为添加代码片段后（更改可能需要一些时间才能生效）。
清除您的浏览器缓存并刷新您的网站。
检查代码段放置： 右键点击您的网站 → 查看页面源代码。 搜索
omnisend.push.它应该出现在之前在每个页面上。从 Omnisend 重新复制代码段，并再次粘贴，以确保没有字符缺失。
检查您的品牌 ID：确保代码片段中的品牌 ID 与您的 Omnisend 账户中的品牌 ID 匹配 (将鼠标悬停在左侧的店铺图标上 → 您的品牌 ID)。
如果您正在使用 Google Tag Manager，请参阅上方警告 – 请联系支持团队进行手动验证。
下一步测试什么
验证后，请立即测试这些功能：
创建订阅表单（Signup Form） (Campaigns → Forms) 并在您的网站上进行测试。
查看实时视图 (店铺 → Live View) 以查看页面访问是否被跟踪。
设置欢迎自动化流程（Automation） (Automation → Pre-Built) – 这仅适用于前端集成。
注意：事件跟踪（购物车事件、产品浏览）仅在通过订阅表单（Signup Form）或 API 识别联系人后才有效。匿名访客在提交其电子邮件（Email）之前不会触发条件（Trigger）事件。
后端集成
后端集成通过 API 将您的客户、订单和产品数据同步到 Omnisend。这将解锁废弃购物车（Abandoned Cart）自动化流程（Automation）、订单确认、高级细分受众（Segmentation）和收入报告。
后端集成需要开发者知识。将这些资源分享给您的开发团队：
后端集成解锁了什么
一旦后端集成完成，您将可以访问：
废弃购物车（Abandoned Cart）和废弃结账（Abandoned Checkout）自动化流程（Automation）。
订单相关自动化：订单确认, 订单取消, 发货确认, 订单跟进, 客户反馈, 客户重新激活。
基于购买行为的定制自动化流程（Automation）工作流（例如，“购买了 X 但未购买 Y”）。
高级细分受众（Segmentation）结合订单和产品数据。
产品 Picker 在电子邮件（Email）营销活动中
营销活动（Campaign）和自动化流程（Automation）分析中的收入报告。
一旦您的开发人员通过 API 推送所需数据，所有已启用的功能将立即开始工作。请注意：某些功能（例如 Live View）仍需要前端代码片段。
故障排除
我添加了代码片段，但验证失败。
请参阅上方“故障排除：验证失败”部分，了解详细步骤。
如果您正在使用 Google Tag Manager，即使设置正确，验证也可能会失败 – 请参阅第 4 步中的 GTM 警告，并联系支持团队进行手动验证。
我在追踪事件时遇到 400 错误。
事件需要一个已识别的联系人才能生效。400 错误通常意味着该联系人尚未被识别。
如何识别联系人:
他们提交一个订阅表单（Signup Form）以及他们的电子邮件（Email）
您通过 API 使用
setContact方法识别他们
修复：
确保您的事件跟踪代码在联系人识别之后运行
先提交订阅表单（Signup Form）进行测试，然后触发事件
查看 Store Settings → API → Logs 以获取具体的错误详情。
匿名访客在被识别之前不会触发条件（Trigger）事件。
产品选择器未显示
Product Picker 需要 Omnisend 拥有您的产品目录数据。适用于自定义平台：
通过 API 同步产品目录（后端集成）
将产品浏览事件跟踪添加到您的产品页面 (frontend snippet + dynamic product data)
请遵循产品选择器设置指南以获取详细说明。
店铺已连接，但自动化未运行。
要触发自动化流程（Automation）工作流，您必须通过 API 传递事件和相关数据。例如：
废弃购物车（Abandoned Cart）需要购物车 API 和订单 API 事件
订单确认需要订单下达事件
产品弃购需要一个产品浏览事件
检查 Store Settings → API → API Logs 以查找错误。
注意：仅前端集成支持欢迎、浏览放弃和产品放弃自动化。所有基于订单的自动化都需要后端集成。
联系人资料中的产品选项卡不显示任何内容
在联系人的个人资料中，产品选项卡下显示的信息来自 Live View 跟踪。对于基于API的平台，Omnisend 无法通过 Live View 追踪某些事件（例如已下订单或已购买产品）—— 它会通过 API 接收此数据。
这意味着，即使您的集成正常工作，产品选项卡也可能保持为空。检查 Store Settings → API → Logs 以确认订单和产品数据正在同步。
常见问题
我可以将本指南用于 Etsy、Squarespace、Hostinger 或其他未在您的集成中列出的平台吗？
是。任何允许自定义 HTML/JavaScript 的平台都可以使用前端集成（注册表单、基本自动化）。
Etsy: 不允许在商店页面上使用自定义代码。您需要一个外部落地页或网站来添加代码段，或者使用Zapier 用于同步联系人。后端集成需要开发人员工作。
Hostinger Website Builder: Frontend snippet 可以添加。Backend 集成需要开发人员。
完整的后端集成需要 API 访问您店铺的订单数据。
我通过 Google Tag Manager 添加了代码段，但是验证失败了。您该怎么办？
您的集成可能正常工作，即使验证失败。GTM 安装的代码片段通常无法通过 Omnisend 的自动验证，因为 Omnisend 会检查直接的 HTML 放置。
确认其是否正常工作：
打开您的网站
按 F12 打开浏览器控制台
输入
window.omnisend并按 Enter 键如果您看到一个数组，则代码片段正在正确触发
通过应用内聊天联系支持，并提供您的店铺 URL。我们将手动验证您的连接。
请确保：
您的 GTM 标签在 All Pages 触发
标签已发布在 GTM 中
该代码段包含在 标签中
哪些自动化仅适用于前端集成？
仅通过前端集成，您可以使用：
欢迎电子邮件（Email）
浏览放弃
产品放弃 (需要 product viewed event 设置)
生日电子邮件（Email）
由联系人细分触发的自动化
您不能在没有后端集成的情况下使用：
废弃购物车（Abandoned Cart）
订单确认
发货确认
订单取消
客户重新激活
任何基于购买数据的 工作流（Workflow）
这些需要后端 API 集成才能将订单数据传递到 Omnisend。
我可以通过 Google 标签管理器推送购物车和结账事件吗？
您可以推送购物车事件（开始结账、添加到购物车）通过 GTM 使用 Custom HTML tags 带有动态产品数据变量。
然而，已完成订单必须通过后端 API 发送，因为 GTM 在浏览器中运行，并且无法在付款后安全地访问最终订单数据。
针对购物车弃购：
通过 GTM 推送
$startedCheckout事件，并附带购物车详情。
用于订单确认：
使用服务器端 API 推送订单数据
请参阅我们的Event Tracking API 文档，了解实施详情。
为什么我在跟踪事件时会收到 400 错误？
事件需要已识别的联系人才能生效。400 错误通常意味着联系人尚未被识别。
联系人会在以下情况下被识别：
提交订阅表单（Signup Form）并附上其电子邮件（Email）
通过 API 识别，使用
setContact方法
修复：
确保您的事件跟踪代码在联系人识别之后运行。
匿名访客不会触发事件 – 他们必须先提交电子邮件（Email）
查看 Store Settings → API → Logs 以获取具体的错误详情。
请参阅我们的事件跟踪文档，了解有关联系人识别的更多详情。
完成集成需要多长时间？
前端集成：15-30 分钟，如果您可以访问您的网站的 HTML。验证后，注册表单和 Live View 等功能将立即生效。
后端集成: 需要开发人员，通常需要 4–8 小时，具体取决于您的平台复杂性以及您想要的功能（基本事件 vs. 完整订单同步）。
产品数据同步：产品数据在 API 设置后 24 小时内同步。
测试：在后端集成后，安排 1-2 天的测试，以确保自动化正确触发条件（Trigger）。
需要帮助？联系您的网站开发者进行定制电商平台集成，或通过应用内聊天或在 联系我们的支持团队。[email protected]