安装 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 新用户，请阅读 管理插件。
26a0fe0f 选择 Omnisend 的 WooCommerce 电子邮件营销。通用的 WordPress 插件缺乏 WooCommerce 特定功能。
第 2 步。插件将在几秒钟内安装完成，并出现“Activate”按钮。点击该按钮以激活。Omnisend 的 WooCommerce 电子邮件营销插件。
第 3 步。激活后，页面顶部会出现一个横幅。点击连接您的店铺到 Omnisend
步骤 4. 您将进入连接页面。
有 Omnisend 账户？ 点击"Connect your account"。
首次使用 Omnisend？ 点击"Create new account"。
步骤 5. 如果您选择了“连接您的账户”并且有一个空的店铺已准备就绪，您将看到一个批准弹窗。点击批准
如果您选择了 "Create new account"，请先完成注册，然后批准。
26a0fe0f 如果您看到错误而不是批准弹出窗口，请转到 故障排除商店连接。
第六步。 该插件向 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"，请先完成注册，然后批准。
26a0fe0f 如果您看到错误而不是批准弹出窗口，请转到 故障排除商店连接。
第六步。插件向 Omnisend 发送验证请求，您的店铺已连接。您将进入品牌资产 页面。
26a0fe0f 如果您在商店连接中遇到任何问题，跳转到故障排除部分。
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 以接近实时的方式拉取最新版本。
数据类型 | 联系人 | 购物车/ 结账 | 订单 | 产品 | 产品类别 |
时间线 | 接近实时 | 立即 | 近实时 | 接近实时 | 近实时 |
26a0fe0f 重要说明：
保持您的插件更新。 从版本 1.20.0 开始，Omnisend 在其自己的后端同步所有数据类型。在旧版本中，插件可能仍会推送一些数据，而 Omnisend 的后端也会同步这些数据，从而产生双重同步负载，可能会减慢您的商店速度。请更新到版本 1.20.0 或更高版本。
产品类别可能需要最多 30 分钟才能更新。 产品类别会在大约每 30 分钟运行的常规同步中刷新，因此新创建或重命名的类别可能需要最多 30 分钟才能出现在 Omnisend 中。如果您直接在产品上添加或更改类别并保存，则在产品同步期间会立即应用更新。
如果您在连接时遇到任何问题，请参见 故障排除 WooCommerce (WordPress) 连接问题。
1f4a1 该插件是必需的，必须保持活动状态。 它继续支持现场网站跟踪、放弃购物车事件、注册表单和结账时的选择加入复选框。
结账时的电子邮件选择加入
默认情况下，结账电子邮件同步为未订阅。 要收集订阅者，请按照以下步骤启用选择框。
前往 Omnisend 插件并检查 在结账页面添加一个选择加入复选框。您可以根据需要自定义同意文本并预选选择框。
启用后，在结账时勾选框的客户将作为 电子邮件订阅者 同步到 Omnisend。
结账时的 SMS 选择加入
转到 Omnisend 插件并检查 在结账页面添加 SMS 选择框。根据需要自定义同意文本。
在结账时勾选框的客户将作为 SMS 订阅者 同步到 Omnisend。
WooCommerce 8.3+（新结账块）：
对于 WooCommerce 版本 8.3 及更高版本，Omnisend 会自动检测新的结账块，并将选择框放置在电子邮件字段下。支持经典和块结账。
不同 WooCommerce 版本的结账体验 | 结账预览 |
WooCommerce 版本 8.2 及更低版本
(经典结账体验) | 
|
WooCommerce 版本 8.3 及更高版本
(对于 新结账 (8.3+)，选择框将出现在电子邮件字段正下方) | 
|
1f4a1 请确保启用 Omnisend 注册表单，并考虑 替代选择加入方法 以便客户触发您的自动电子邮件（自动化）。
联系属性优先级：
请注意，在同步联系信息时，我们的系统遵循基于优先级的方法来映射 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 用户 |
自动化工作流的订单状态映射
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 账户中的单独商店，以防止数据混合。转到账户设置 → 商店 → 添加新商店，然后将 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 returns false" 是什么意思？
A: 这意味着 Omnisend 无法访问您网站的 API。检查您的防火墙，禁用缓存插件，并验证您的 SSL 证书是否有效。
插件已激活，但数据未显示（或看起来过时）。
连接或更新插件后，初始导入可能需要最多 24 小时才能完成。之后，新的更改几乎实时同步。
如果 24 小时后数据仍然缺失：
确认插件已更新到版本 1.20.0 或更高，并且商店已连接。
检查是否有冲突的插件（安全、火墙、缓存或修改 WooCommerce REST API 的插件）。暂时禁用可疑插件以隔离冲突。常见原因：Wordfence、LiteSpeed Cache、Really Simple Security、Perfmatters 和 WP Crontrol。
验证 Omnisend 的 IP 是否在您的防火墙中被允许。请查看 下面的常见问题解答 中的允许列表。
检查您的 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] 联系我们的支持团队，或通过应用内聊天联系。