Omnisend for WooCommerce 是一种集成，允许您将您的 Omnisend 帐户链接到您的 WooCommerce 商店。
它可以让您更好地利用商店的数据来细分客户，自动化营销，恢复遗弃的购物车，并自动化追加销售过程等其他可用功能。
如果您想在没有 WooCommerce 的情况下使用 Omnisend for WordPress，请跳转至这篇文章获取更详细的说明。
没有找到您要找的东西？ 发布一个主题在 WordPress 论坛上并通过获取所需的答案来支持社区。
将 Omnisend 与 WooCommerce 集成
在您开始之前
如果您一直在使用 Omnisend 并且已经有另一个商店与其连接，您首先需要创建一个新的空商店，然后继续以下步骤。
要在现有帐户下注册新商店，请查看这个分步指南。 一旦注册了新商店，请继续以下步骤。
如果您在连接到 WooCommerce 商店之前没有使用 Omnisend，您正在连接；现在，请继续以下步骤。
另外，WordPress 有两个应用程序版本。 这两个版本都与 Omnisend 兼容，但设计略有不同。 因此，为了方便起见，我们将为这两个应用程序版本展示整个过程：wordpress.org 和 wordpress.com。
wordpress.org 的安装过程
步骤 1。 导航至您的 WordPress 管理员仪表板，→ 进入 插件页面 → 添加新插件→ 搜索 Omnisend for WooCommerce 插件 → 点击 立即安装。
如果您刚开始在 WooCommerce 上工作，我们建议您在此处阅读更多关于 WooCommerce 插件的信息。
我们强烈建议 WooCommerce 用户选择 Omnisend 的 WooCommerce 电子邮件营销。 这是因为选择一般 WordPress 插件可能无法为您提供最佳服务，可能会导致您错过 WooCommerce 插件特有的众多有益功能。
步骤 2。 插件将在几秒钟内安装完毕，然后“激活”按钮将出现。 单击以激活 WooCommerce by Omnisend 的电子邮件营销 插件。
步骤 3。 插件会被激活，在此页面顶部，您会看到一个栏，允许您将 Omnisend 商店连接到 WooCommerce。 点击“将您的商店连接到 Omnisend”，如下图所示。
步骤 4。 您将进入显示在下图中的页面。 如果您已有一个 Omnisend 帐户，那么根据 这里的说明，您应已在其中创建了一个空商店。 如果是这样，点击“连接您的帐户”按钮。
如果您刚开始使用 Omnisend 而且这将是您首次连接到 Omnisend 的商店，点击“创建新帐户”按钮：
步骤 5。 如果您选择了“连接您的帐户”选项并且有一个空商店可以连接商店，您将看到下图中的弹出窗口。 如果您选择了“创建新帐户”选项，您需要先完成帐户注册过程；然后，您会看到相同的弹窗。 点击“批准”按钮。 如果您没有进入此页面并显示错误，请转到我们的故障排除部分。
步骤 6。 就是这样！ 插件将向 Omnisend 发送一个验证请求，并且商店将被连接。 您将进入品牌资产页面：
wordpress.com 的安装过程
步骤 1。 导航至您的 WordPress 管理员仪表板，→ 进入 插件页面 → 添加新插件→ 搜索 Omnisend for WooCommerce插件并选择它。
步骤 2。 您将被重定向到插件市场中的 Omnisend 插件页面。 点击“安装并激活”按钮。
步骤 3。 安装和激活插件需要几秒钟。 完成后，您会进入此页面。 点击“管理插件”按钮。
步骤 4。 您将进入显示在下图中的页面。 如果您已有一个 Omnisend 帐户，那么根据 这里的说明，您应已在其中创建了一个空商店。 如果是这样，点击“连接您的帐户”按钮。
如果您刚开始使用 Omnisend 而且这将是您首次连接到 Omnisend 的商店，请点击“创建新帐户”按钮。
步骤 5。 如果您选择了“连接您的帐户”选项并且有一个空商店可以连接商店，您将看到下图中的弹出窗口。 如果您选择了“创建新帐户”选项，您需要先完成帐户注册过程；然后，您会看到相同的弹窗。 点击“批准”按钮。 如果您没有进入此页面并显示错误，请转到我们的故障排除部分。
步骤 6。 就是这样！ 插件将向 Omnisend 发送一个验证请求，并且商店将被连接。 您将进入品牌资产页面：
⚠️ 如果您在商店连接时遇到任何问题，请跳转到故障排除部分。
多站点支持
Omnisend 完全兼容WordPress 多站点安装（插件版本1.16.0及以上）。
您可以在一个多站点设置下连接和管理多个 WooCommerce 商店 - 无需在每个站点上手动安装 Omnisend。
无论您的多站点是通过 子域名（例如 store1.example.com） 还是子目录（例如 example.com/store1） 配置的，这都适用。 非常适合希望集中管理和精简集成的机构或多品牌卖家。
WooCommerce 插件的好处
通过插件将您的 WooCommerce 连接到您的 Omnisend 帐户后，您将可以访问标准和专业计划功能的完整套餐，包括：
渠道：电子邮件、短信、Facebook 自定义受众和 Google 客户匹配；
所有注册表单：幸运轮、弹出式广告框、注册框和落地页；
所有自动化：欢迎邮件、遗弃购物车、订单确认等；
通过丰富数据扩展的订阅者列表细分；
活动、注册表单和自动化的完整报告以及可交付性结果；
💡 Omnisend WooCommerce 插件包含所有 Omnisend 标准功能。 您可能希望向您的 Omnisend 帐户传递额外的信息以用于自定义自动化工作流程。 要做到这一点，您可以使用我们的开放 API。 要了解更多关于后端的可能性，请访问我们的 API 文档。
添加插件权限
确保允许 WooCommerce 插件权限，以便集成顺利运行。 要做到这一点，请转至 WordPress 管理面板并按下“添加权限”按钮。
步骤 1。 前往您的 WordPress 管理面板并打开 Omnisend 插件页面
步骤 2。 如果需要，请将 Omnisend 插件更新至最新版本
步骤 3。 点击“添加权限”按钮
步骤 4。 在 WooCommerce 同意窗口中单击“批准”。
如果您未看到添加权限按钮，请转到 WooCommerce 设置 → 高级 → REST API → 选择 Omnisend 密钥 → 撤销。 然后按照视频中描述的步骤进行；您现在应该可以看到按钮。
数据同步
完成 WooCommerce 集成后，Omnisend 开始同步您商店的所有历史数据。
传递给 Omnisend 的信息包括您的联系人、产品和订单。 初始同步可能需要长达几个小时，但不会超过 24 小时。
之后，您的所有资产将立即填充到 Omnisend。
请注意，我们默认将结账时提供的电子邮件地址同步到 Omnisend，状态为未订阅。
我们的插件允许您在结账时添加电子邮件和/或短信选项框。 要在结账时收集电子邮件订阅者，请前往 Omnisend 插件并勾选第一个框‘在结账页面添加一个选项框’。 你也可以更改选择加入复选框同意文本。 您可以通过选中“在结账页面预选加入复选框”框来选择性地使选择加入同意复选框处于预选状态。
完成此操作后，同意框将添加到您的商店结账页面。 在结账过程中，所有选中此框的人都会同步到 Omnisend 作为电子邮件订阅者。
要在结账页面启用 SMS 选择加入，请转到 Omnisend 插件并选中第二个框“在结账页面添加选择加入复选框”。 与电子邮件选择加入一样，您也可以更改 SMS 的选择加入复选框同意文本。
完成此操作后，同意框将添加到您的商店结账页面。 在结账过程中，所有选中此框的人都会同步到 Omnisend 作为SMS 订阅者。
请注意，对于WooCommerce 版本 8.3及更高版本，Omnisend 将自动检测结账页面的版本并相应地定位营销同意复选框。 两种版本都支持，使能流程保持不变。
在此版本中，结账模块已成为新安装的默认结账体验。 这些模块提供了比经典结账（下文对比）更新更灵活的设计。
通过此更新，Omnisend 可以在新的结账模块中直接捕获关键客户操作，例如他们开始结账过程和电子邮件选择加入时。 这确保您可以有效地收集订阅者数据并监控结账事件，而不会错过重要的操作。
不同 WooCommerce 版本的结账体验 | 结账预览 |
WooCommerce 版本 8.2 及以下
（经典结账体验） | 
|
WooCommerce 版本 8.3 及以上
（对于新的结账（8.3+），复选框将出现在电子邮件字段正下方） | 
|
在您的插件页面上，您会看到一个商店数据同步状态表，该表将展示同步状态：成功、错误、待处理、跳过，并有两个自助服务操作：
选择重新同步无法同步的数据。 为此，单击“重新同步”按钮。
选择重新同步所有商店数据。 当您对帐户进行重大更改（如永久删除联系人）时，我们建议使用“重新同步所有联系人”按钮。
提示！ 👍 确保您启用了由 Omnisend 提供的少数几种表单，并集成到您商店中已有的表单。
我们还建议您考虑其他方式来收集选择加入以触发您的自动化工作流。
注意，在同步联系信息时，我们的系统在映射 first_name 和 last_name 属性时遵循优先顺序：
优先级 1：我们首先检查 WordPress 用户的 first_name 字段。
优先级 2：如果 first_name 缺失，我们会考虑 shipping_first_name。
优先级 3：如果仍然不可用，我们会查看 billing_first_name 是否作为 first_name。
属性 | 优先级 1 | 优先级 2 | 优先级 3 |
| WordPress 用户 | WordPress 用户 | WordPress 用户 |
| WordPress 用户 | WordPress 用户 | WordPress 用户 |
订单状态映射用于自动化工作流
Omnisend 不替换您 WooCommerce 商店中的任何自动响应。
如果您希望替换它们，您需要禁用 WooCommerce 发送的自动化并在 Omnisend 中启用相应的自动化。
由于这两个平台背后的逻辑不同，要使用基于订单的自动化，重要的是要了解 WooCommerce 上的订单状态如何映射到 Omnisend 上的状态。 下面的表格将帮助您了解 WooCommerce 中不同支付方式的状态。
通过 WordPress 过滤器挂钩自定义 Omnisend
在 WordPress 中，过滤器挂钩是一种允许开发人员在显示或处理数据之前修改数据的挂钩类型。 它们提供了一种在不直接修改核心文件的情况下更改 WordPress 功能的方法，使自定义更简单，更新更安全。
过滤器挂钩如何工作？
过滤器挂钩使用 apply_filters() 函数，允许开发人员在数据返回之前修改或扩展数据。 开发人员使用 add_filter() 将自定义函数附加到特定过滤器挂钩，以便动态更改内容。
Omnisend 提供的过滤器挂钩
omnisend_contact_data
允许在将数据发送到 Omnisend 之前自定义联系人数据（可用属性可以在我们的API 文档中找到）。
add_filter( 'omnisend_contact_data', 'example_modify_omnisend_contact_data', 10, 2 );
function example_modify_omnisend_contact_data( $omnisend_contact, $wordpress_user ) {
if ( str_ends_with( $wordpress_user->user_email, '@gmail.com' ) ) {
array_push( $omnisend_contact['tags'], 'gmail_users' );
}
return $omnisend_contact;
}
omnisend_cart_line_item
允许自定义作为购物车中已添加产品和已开始结账事件一部分发送到 Omnisend 的每个购物车项目行
add_filter( 'omnisend_cart_line_item', 'example_modify_omnisend_cart_line_item', 10, 2 );
function example_modify_omnisend_cart_line_item( $omnisend_cart_line_item, $woocommerce_cart_item ) {
$omnisend_cart_line_item['special_product_category'] = $woocommerce_cart_item['special_product_category'];
return $omnisend_cart_line_item;
}
omnisend_cart_checkout_url_item
允许将额外的属性添加到编码到 checkout_url 属性中的购物车项目中，这些属性用于已添加产品到购物车和已开始结账事件中以用于购物车恢复。 这些额外的属性会在购物车恢复期间自动传递给 WooCommerce。
add_filter( 'omnisend_cart_checkout_url_item', 'example_modify_omnisend_cart_checkout_url_item', 10, 2 );
function example_modify_omnisend_cart_checkout_url_item( $omnisend_cart_checkout_url_item, $woocommerce_cart_item ) {
$omnisend_cart_checkout_url_item['special_product_category'] = $woocommerce_cart_item['special_product_category'];
return $omnisend_cart_checkout_url_item;
}
omnisend_recover_cart_item_data
允许在购物车恢复期间传递给 WooCommerce 的购物车项目数据进行额外自定义。
add_filter( 'omnisend_recover_cart_item_data', 'example_modify_omnisend_recover_cart_item_data', 10, 2 );
function example_modify_omnisend_recover_cart_item_data( $woocommerce_cart_item_data, $omnisend_cart_item ) {
$woocommerce_cart_item_data['source'] = 'recovered_during_cart_recovery';
return $woocommerce_cart_item_data;
}
故障排除商店连接
商店已连接
如果您收到此错误，说明您的 Omnisend 帐户中已经连接了另一个 WooCommerce 商店。 要解决此问题，您需要在单独的标签中登录到您的 Omnisend 帐户，并打开您希望连接 WooCommerce 商店的空商店（此时应已创建，但如果您尚未这样做，请按照此处说明进行操作）。 然后，返回您的 WordPress 管理帐户并再次单击“连接您的帐户”按钮。 您会来到此页面，您需要批准连接，仅此而已。
连接商店时遇到问题
这是 WooCommerce 中的常见错误。 导致此问题有几种可能的原因：
问题最常见的原因是您的商店使用 WooCommerce 版本 3.5 或更早版本。 确保您在安装我们的插件之前升级到最新的 WooCommerce 版本。
您的商店没有有效的 HTTPS/SSL 证书。 确保安装并激活一个，以便我们的应用程序能够与 WooCommerce API 通信。
要使插件正常工作，WordPress 必须安装在域或子域级别，而不是页面级别。 例如，假设您正在为客户开发商店，并且您正在
www.example.com/devstore/上创建一个模型。 我们的服务器将尝试在子域级别连接到 WooCommerce API，www.example.com但商店位于www.example.com/devstore/上。 或者，您可以将开发商店安装在devstore.example.com子域上；这样就可以了。
您的商店受密码保护，或者您使用的是“即将推出”或“正在建设中”插件，这会禁用对您商店的公共访问。 这也限制了 API 访问，我们的应用程序需要它才能工作。
您的商店有一个缓存插件，删除了“授权”标头。 尝试逐个关闭您的插件，以找到导致问题的插件。
您有一个商店插件，包括提高性能和安全性相关的插件，这些插件正在阻止对 WordPress 或 WooCommerce REST API 的访问（例如，Perfmatters 插件）。 尝试逐个停用这些插件以确定导致问题的插件。
如果您已经尝试了上述所有方法，您的服务器正在删除“授权”标头。
授权 – 步骤 1
授权 – 步骤 2 – 错误
重要提示：由于这涉及到您 Web 服务器和/或其他 WordPress 插件的配置，Omnisend 在这些情况下无法提供支持。 您可以自行承担风险尝试以下建议。 当进行配置更改时，请始终咨询 Web 开发人员。
在某些情况下，执行以下操作可能会有所帮助（有些可能不适用于您）：
查看缓存插件的配置，并查找与缓存标头相关或不相关的设置
在服务器级别为您的子域生成新的有效 LetsEncrypt 证书
从子域中删除 Cloudflare CDN 代理（即，将其指向直接的 IP）
将 WooCommerce 主题切换到“Storefront”仅用于连接
将以下内容添加到您的
.htaccess文件中：
SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1
如果这不起作用，请联系您的托管提供商。
订单确认电子邮件在我将订单导入到WooCommerce后没有发送。
对于超过3小时延迟的订单事件，自动化将不会触发。 例如，在订单确认的情况下，如果您接收到/添加一笔超过一天前下单的订单事件，订单确认将不会发送。 如果您的店铺通过API连接，其逻辑也是如此。
克隆您的WooCommerce商店
当您克隆WooCommerce商店来创建测试或暂存环境时，您可以安全地测试新功能、更新和其他更改，而不影响您的实时商店。
Omnisend插件如何工作
Omnisend插件通过自动断开暂存环境与实时商店的数据传输连接，确保生产和暂存环境之间的明确区分。 它还需要将暂存环境连接到一个测试品牌。
设置暂存环境的步骤
步骤1：生产商店中的操作
克隆您的商店：继续克隆您的生产商店。 这将创建所需的环境用于测试或其他用途。
步骤2：在您的暂存商店中进行操作
连接暂存插件到测试品牌：在您的克隆（暂存）商店中，将Omnisend插件连接到测试品牌。 这确保了暂存环境与您的实时商店连接到不同的品牌。 插件将显示品牌名称，使识别其连接的Omnisend品牌变得更加容易。
重要说明
自动断开连接：当创建生产副本时，暂存插件将自动断开与主商店的连接，防止将数据发送回生产环境。
Omnisend插件检测到创建了暂存环境，并断开与实时商店的连接，以确保不发送非生产数据。 为了让插件检测到环境更改，您的克隆暂存环境必须设置WP_ENVIRONMENT_TYPE WordPress变量为“staging”或“development”。
这可以由您选择的克隆工具自动设置，或者如果您是手动克隆，可以在您的wp-config.php文件中设置，例如：
define('WP_ENVIRONMENT_TYPE', 'staging');
如果您使用第三方工具来克隆您的商店，并希望确保其创建的设置正确，您可以通过进入您克隆的商店的WordPress管理仪表板，导航到工具→网站健康→信息→WordPress常量，并验证WP_ENVIRONMENT_TYPE是否设置为“staging”或“development”来实现。
值如“production”或“Undefined”应该只出现在您的生产商店中。 如果它们出现在您的克隆商店中，则表明设置不正确，因为Omnisend插件将无法检测到需要断开连接。
有关如何克隆您的WooCommerce商店和创建测试或暂存环境的详细步骤，请参阅这些适用于WooCommerce和WordPress的指南。
品牌名称显示：Omnisend插件显示品牌名称以帮助您轻松识别它连接到哪个品牌。
如何修复API访问问题
由于API访问问题，您的商店数据将无法与Omnisend同步。 这将阻止我们向您的受众发送消息。
在您安装我们的插件后，有很多因素可能阻止我们访问WordPress (wp-json/omnisend-api/*)或WooCommerce (wp-json/wc/v3/*)上所需的Omnisend资源，例如：
第三方与安全相关的插件。
阻止访问所需API资源的自定义PHP代码。
WordPress或WooCommerce的安全相关设置。
请联系您的开发人员以识别和修复可能的原因。
修复问题后，请按照以下步骤确保一切按预期工作。
检查WooCommerce API是否可访问：
在WordPress管理中，转到WooCommerce→设置→高级→REST API。
按‘添加密钥’。
输入任意名称并按‘生成API密钥’。
现在使用提供的消费者密钥和秘密键，将以下URL输入到您的浏览器中。
{shopDomain}/wp-json/wc/v3/products?consumer_key={consumer_key}&consumer_secret={consumer_secret}5. 如果返回产品列表，则一切正常。
6. 检查后，您可以删除创建的API密钥。
检查Omnisend API是否可访问：
确保您拥有最新的Omnisend插件版本。
确保您的网络设置允许访问Omnisend API：{shopDomain}/wp-json/omnisend-api/v1/connected 返回true。
Cloudflare阻止
如果您的网站托管在Cloudflare上，可能会有一个防火墙阻止Omnisend请求。 为了让集成正常工作，您需要将以下IP地址列入白名单：
34.170.162.11
34.56.62.59
34.56.108.215
34.133.59.36
34.58.66.146
35.184.130.5
35.232.14.89
此外，您需要将Omnisend添加到Cloudflare的白名单中。 为此，请进入Cloudflare的设置，选择安全性，然后选择WAF，并创建规则。
将“Omnisend/1.0”用户代理（区分大小写）列入白名单将允许Omnisend访问WordPress并解决问题。 完成后，您可能需要重新安装Omnisend插件并重新连接。
Wordfence阻止
如果您安装并激活了Wordfence插件，它可能会阻止对Omnisend请求的访问。 为此，请转到您的Wordfence插件设置→防火墙选项，您应该看到一个IP白名单部分，如此。
保存后，请尝试重新安装Omnisend插件并尝试重新连接。
如果您有任何疑问或需要帮助，请通过应用内聊天或 [email protected] 联系我们的支持团队。