安装 Omnisend for WooCommerce 插件，以同步您的店铺和 Omnisend 之间的联系人、产品和订单。您将自动处理废弃购物车（Abandoned Cart）挽回、订单确认和细分受众（Segmentation）– 无需手动设置。
本指南涵盖了 wordpress.org 和 wordpress.com 的安装。
如果您想在不使用 WooCommerce 的情况下使用 Omnisend for WordPress，请参阅 Omnisend for WordPress Plugin。
没有找到您需要的内容？在WordPress 论坛上发布一个主题，通过获取所需的答案来支持社区。
在您开始之前
在连接 WooCommerce 之前，您必须创建一个新的空店铺。每个平台在 Omnisend 中都需要一个独立的品牌，以防止数据混合。
要创建新店铺：前往 Account Settings → Stores → Add New Store。创建后，返回 WordPress 并点击“Connect your account”以将 WooCommerce 连接到此新店铺。了解更多关于管理多个店铺的信息。
如果您在连接到 WooCommerce 店铺之前没有使用过 Omnisend，现在您正在连接；请按照以下步骤进行操作。
WordPress 有两个版本：
wordpress.org – 自托管；您需要手动安装插件。
wordpress.com – 由 Automattic 托管；通过应用商店安装插件。
两者都与 Omnisend 兼容。请按照您版本的说明进行操作：wordpress.org 和 wordpress.com。
将 Omnisend 与 WooCommerce 集成
wordpress.org的安装过程
步骤 1. 导航到您的 WordPress 管理仪表盘插件 →Add New → 搜索Omnisend for WooCommerce → 点击立即安装
如果您是 WordPress 新用户，请阅读 管理插件。
⚠️ 选择 Omnisend 的 WooCommerce 电子邮件营销。通用的 WordPress 插件缺乏 WooCommerce 特定功能。
第 2 步。插件将在几秒钟内安装完成，并出现“Activate”按钮。点击该按钮以激活。Omnisend 的 WooCommerce 电子邮件营销插件。
第 3 步。激活后，页面顶部会出现一个横幅。点击连接您的店铺到 Omnisend
步骤 4. 您将进入连接页面。
有 Omnisend 账户？ 点击"Connect your account"。
首次使用 Omnisend？ 点击"Create new account"。
步骤 5. 如果您选择了“连接您的账户”并且有一个空的店铺已准备就绪，您将看到一个批准弹窗。点击批准
如果您选择了 "Create new account"，请先完成注册，然后批准。
⚠️ 如果您看到错误而不是批准弹窗，请访问 故障排除店铺连接.
第六步。 该插件向 Omnisend 发送验证请求，您的店铺已连接。您将进入品牌资产 页面。
wordpress.com 的安装过程
步骤 1. 前往您的 WordPress 管理仪表盘 →插件 →Add New → 搜索Omnisend for WooCommerce → 选择它。
步骤 2. 点击安装并激活在插件市场中的 Omnisend 插件页面上。
步骤 3. 安装完成后，点击管理插件
第 4 步。您将进入连接页面。
有 Omnisend 账户？ 点击"Connect your account"。
刚接触 Omnisend？ 点击"Create new account"。
步骤 5. 如果您选择了“连接您的账户”并且有一个空的店铺已准备就绪，您将看到一个批准弹窗。点击批准。
如果您选择了 "Create new account"，请先完成注册，然后批准。
⚠️ 如果您看到错误而不是批准弹窗，请访问 故障排除店铺连接.
第六步。插件向 Omnisend 发送验证请求，您的店铺已连接。您将进入品牌资产 页面。
⚠️ 如果您在连接店铺时遇到任何问题，请跳转到故障排除部分。
WooCommerce 插件优势
将 WooCommerce 连接到 Omnisend 后，您将获得以下功能：
渠道：电子邮件（Email）、短信（SMS）、Facebook Custom Audience、Google Customer Match。
注册表单：幸运大转盘、弹窗、落地页等
Automations: 欢迎邮件, 废弃购物车（Abandoned Cart）, 订单确认, 等。
扩展的细分受众（Segmentation）结合丰富数据。
完整的营销活动、表单、自动化和送达率（Deliverability）报告。
[1m💡 Omnisend WooCommerce 插件包含所有标准的 Omnisend 功能。需要自定义工作流程吗？使用 Omnisend API 来传递额外数据。
多站点支持
Omnisend 与 WordPress Multisite 安装完全兼容（插件版本 1.16.0 及更高版本）。
您可以在单个多站点设置下连接和管理多个 WooCommerce 店铺，无需在每个站点上单独手动安装 Omnisend。
这适用于您的多站点配置方式为子域名（例如，store1.example.com）或子目录（例如，example.com/store1）。适用于寻求集中管理和简化集成的代理机构或多品牌卖家。
添加插件权限
允许 WooCommerce 插件权限，以便集成顺利运行。
步骤 1. 前往您的 WordPress 管理面板并打开 Omnisend 插件页面。
步骤 2. 如有需要，请将 Omnisend 插件更新到最新版本。
步骤 3. 点击添加权限
第四步。点击在 WooCommerce 同意许可窗口中同意。
更新插件后：
如果您更新了 Omnisend 插件，但仍然看到连接横幅或红色警告：
等待 5–10 分钟让更改生效。
清除您的浏览器缓存并刷新页面。
如果横幅持续存在，请检查 故障排除店铺连接。
如果您没有看到 "添加权限" 按钮，请转到 WooCommerce 设置 高级 REST API 选择 Omnisend 密钥 撤销.然后按照上述步骤操作；按钮应该会出现。
数据同步
连接 WooCommerce 后，Omnisend 会同步您店铺的所有历史数据：联系人、产品和订单。初始同步可能需要长达 24 小时。之后，新数据会立即同步。
同步是如何工作的：
Omnisend 完全在其自己的后台同步所有核心店铺数据 – 联系人、订单、产品和产品类别。该插件不会将此数据推送到 Omnisend；Omnisend 从您的商店的 WooCommerce REST API 中读取这些数据，并通过 WooCommerce webhook 保持最新。
同步分为两个阶段：
初始导入 – 当您连接您的店铺或将插件更新到版本 1.20.0 或更高版本时，Omnisend 会对所有现有联系人、订单、产品和产品类别进行一次性回填。这对于大型店铺可能需要长达 24 小时。
持续同步 – 在回填之后，WooCommerce webhook 会在每次数据被创建、更新或删除时通知 Omnisend。Omnisend 然后通过 WooCommerce REST API 以接近实时的方式拉取最新版本。
数据类型 | 联系人 | 购物车/ 结账 | 订单 | 产品 | 产品类别 |
时间线 | 接近实时 | 立即 | 近实时 | 接近实时 | 近实时 |
e0f 保持您的插件更新。 从版本 1.20.0 开始，Omnisend 在其后端自行同步所有数据类型。在旧版本中，插件可能仍会推送一些数据，而Omnisend的后端也会同步这些数据，从而产生双重同步负载，可能会减慢您的店铺。更新到版本 1.20.0 或更高版本。
🔁 该插件是必需的，必须保持激活状态。 它继续支持网站上的网络跟踪、废弃购物车事件、注册表单和结账时的选择框。
结账时的电子邮件（Email）选择加入
默认情况下，结账电子邮件以未订阅的方式同步。 要收集订阅者，请按如下方式启用选择加入复选框。
前往 Omnisend 插件并检查 在结账页面添加一个选择加入复选框。您可以自定义同意许可文本，并在需要时预先选择复选框。
启用后，在结账时勾选该框的客户将作为 电子邮件订阅者 同步到 Omnisend。
短信（SMS）在结账时选择加入
前往 Omnisend 插件并检查 在结账页面添加短信（SMS）选择加入复选框。根据需要自定义同意许可文本。
在结账时勾选复选框的客户将作为 短信（SMS）订阅者 同步到 Omnisend。
WooCommerce 8.3+ (新的结账区块):
对于 WooCommerce 版本 8.3 及更高版本，Omnisend 会自动检测新的结账区块，并将复选框放置在电子邮件（Email）字段下。支持经典和区块结账。
不同 WooCommerce 版本的结账体验 | 结账预览 |
WooCommerce 版本 8.2 及以下
(经典结账 体验) | 
|
WooCommerce 版本 8.3 及以上
（对于 新结账 (8.3+)，复选框将出现在电子邮件字段正下方） | 
|
[1m[0m[1m[0m确保启用Omnisend注册表单，并考虑为客户提供替代的选择加入方法以触发您的自动化邮件（Automation）。
联系人属性优先级:
请注意，当同步联系人信息时，我们的系统遵循基于优先级的方法来映射 first_name 和 last_name 属性:
优先级 1：我们首先检查 WordPress 用户的 first_name 字段。
优先级 2：如果 first_name 缺失，我们考虑 shipping_first_name。
优先级 3：如果仍然不可用，我们查看 billing_first_name 作为 first_name。
属性 | 优先级 1 | 优先级 2 | 优先级 3 |
first_name | WordPress 用户 | WordPress 用户 | WordPress 用户 |
last_name | WordPress 用户 | WordPress 用户 | WordPress 用户 |
订单状态映射用于自动化流程（Automation）
Omnisend 不会替换您在 WooCommerce 店铺中设置的任何自动回复。
Omnisend 不会替换 WooCommerce 的自动回复。如果您想替换它们，禁用 WooCommerce 订单确认邮件 并在 Omnisend 中启用相应的自动化。
WooCommerce 和 Omnisend 使用不同的订单 状态 逻辑。请参见下表以获取映射：
使用 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;
}
常见问题解答
有关更多故障排除案例，请参阅 故障排除 WooCommerce (WordPress) 连接问题.
什么是“空店铺”，我为什么需要一个？
一个空的店铺是您在 Omnisend 账户中的新店铺。如果您已经连接了一个店铺（例如 Shopify），则必须为 WooCommerce 添加第二个店铺。前往个人资料 店铺 添加新店铺。
我看到“店铺已连接”，但我之前从未连接过。为什么？
这通常意味着另一个店铺（或具有相同域名的测试站点）已经链接。在Omnisend中创建一个新店铺，切换到它，然后再尝试连接。
如果我已经连接了 Shopify，是否需要创建一个新的店铺？
是的。 每个平台（Shopify、WooCommerce 等）必须连接到您 Omnisend 账户中的单独店铺，以防止数据混合。转到 账户 设置 BB 店铺 BB 添加新店铺，然后将 WooCommerce 连接到这个新店铺。
"批准"按钮未出现。我该怎么办？
A: 转到 WooCommerce 设置 高级 REST API 找到 Omnisend 密钥 撤销它。然后重新安装插件并重试。
为什么我在点击 "批准" 后会被重定向回 "连接您的账户"？
此重定向循环通常发生在缓存插件、安全插件（如 Wordfence）或 WP Crontrol 干扰时。暂时禁用这些插件，清除浏览器缓存，并在隐身窗口中重试。
我禁用了所有插件，但仍无法连接。出了什么问题？
检查这些：
验证您的域名是否具有有效的 SSL 证书（HTTPS）。
WordPress 必须安装在域名根目录下（而不是
example.com/store）。您的服务器可能正在剥离授权头。请联系您的主机以将此添加到
.htaccess:SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1
通常哪些插件会阻止 Omnisend？
WP Crontrol、LiteSpeed Cache、Really Simple Security、Perfmatters 和一些 Cloudflare 设置。在故障排除时首先禁用这些。
连接之前正常，但突然停止了。发生了什么？
检查您的店铺URL是否发生了变化（即使是轻微的变化，比如添加了www.)。此外，请确保插件已更新到最新版本。
如何在不破坏我的在线店铺的情况下连接一个暂存站点？
确保您的暂存站点具有WP_ENVIRONMENT_TYPE 设置为 "staging" 在wp-config.php。然后将暂存插件连接到 Omnisend 中的一个单独测试品牌。
"wp-json/omnisend-api/v1/connected 返回 false" 是什么意思？
A: 这意味着 Omnisend 无法访问您网站的 API。检查您的防火墙，禁用缓存插件，并验证您的 SSL 证书是否有效。
插件已激活，但数据未显示（或看起来过时）。
连接或更新插件后，初始导入完成可能需要长达 24 小时。之后，新更改几乎实时同步。
如果在24小时后仍然缺少数据：
确认插件已更新到版本1.20.0或更高，并且店铺已连接。
检查是否有冲突的插件（安全性、防火墙、缓存或修改 WooCommerce REST API 的插件）。暂时禁用可疑的插件以隔离冲突。常见罪魁祸首：Wordfence、LiteSpeed Cache、Really Simple Security、Perfmatters 和 WP Crontrol。
验证 Omnisend 的 IP 是否在您的防火墙中被允许。请查看下面的常见问题解答中的允许列表。
检查您的 Omnisend 的 WooCommerce API 凭据是否有效。如果它们被撤销或重新生成，请重新连接您的店铺以恢复访问。
如果您的店铺在暂存环境中连接，并且从未切换回生产环境，则存储的凭据可能指向错误的环境。使用您的实时商店的 URL 和凭据重新连接。
没有手动重新同步选项。如果上述方法都无法解决问题，请通过应用内聊天或联系我们的支持团队，联系方式为 [email protected].
我如何在 Wordfence 中将 Omnisend 列入白名单？
前往 Wordfence → 防火墙 → “允许的 IP 地址” → 添加以下列出的 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.
我需要更新我的 WooCommerce 插件吗？
是的。 插件版本 1.20.0 将所有数据类型的同步 - 联系人、订单、产品和产品类别 - 移动到 Omnisend 的后端。在旧版本中，插件可能仍会推送一些数据，而Omnisend的后端也会同步这些数据，从而产生双重负载，可能会减慢您的店铺。
在 WordPress 中转到 插件 → 更新 以更新到最新版本。
同步状态表和重新同步按钮从插件中消失了。有什么问题吗？
从插件版本 1.20.0 开始，插件的同步状态页面不再显示每个项目的表格或重新同步按钮。同步现在完全在 Omnisend 的后台运行，因此插件没有每个项目的状态可供显示。该页面显示了一条简短的信息说明。
这是预期的行为，而不是一个错误。在插件或Omnisend中没有可用的手动重新同步操作。同步自动运行。如果数据看起来过时，请查看 故障排除店铺连接。
如果您有任何问题或需要帮助，请通过应用内聊天或联系我们的支持团队，联系方式为 [email protected] 或通过应用内聊天。